Java：CSVパーサを作る（その３） - RFC4180対応 後編

←CSVパーサを作る（その２） - RFC4180対応 前編

前回の記事で未実装だった「レコードの確定」と「レコードのフィールドへの分割」を行うメソッドについて実装を行い，CSVパーサを完成させます。

【実装の考察】
●レコードの確定
レコード確定では，入力テキストデータに対して，ダブルクォーテーション（二重引用符）のペアをヒントに各レコードの末尾を確定して，レコードの切り分けを行います。処理手順は以下のようになります。

1. BufferedReaderのreadLineメソッドを使ってテキストを１行分（現在の位置から改行が現れるまで，またはファイルの終了まで）取り出して，行の先頭からダブルクォーテーションを探す。見つからなければその１行を１レコードとして確定する。（readLineメソッドは「CR」「LF」「CRLF」を改行と認識するので，「CRLF以外の改行も考慮する」仕様の要求を満たしています。）
2. ダブルクォーテーションが見つかった場合，ペアになる後ろのダブルクォーテーションを探す。後ろのダブルクォーテーションが見つかったらその位置から後続のダブルクォーテーションのペアを探す。この手順を行の終わりまで繰り返す。ダブルクォーテーションペアの外側で行が終了していれば，その行を１レコードとして確定する。
3. ペアの後ろのダブルクォーテーションが見つからずにダブルクォーテーションペアの内側で改行に達したら，その改行を文字列フィールドに含まれる改行と見なしてBufferedReaderのreadLineメソッドより次の行を取り出して前の行と連結し，ペアの後ろのダブルクォーテーションを探すところから処理から継続する。これをダブルクォーテーションペアの外側で改行が見つかるまで繰り返す。後ろのダブルクォーテーションが見つからずにファイルの末尾に達したときは，ファイルの末尾にダブルクォーテーションを付加して行の末尾とする。この連結した行を１レコードとして確定する。

以上の処理を行うコードは次のようになります。（2009年6月22日改訂）

//------------------------------------------------------------------
/**
 * BufferedReaderから1レコード分のテキストを取り出す。
 * @param reader 行データを取り出すBufferedReader。
 * @return 1レコード分のテキスト。
 * @throws IOException 入出力エラー
 */
private String buildRecord (
　　BufferedReader　reader)
　　throws IOException
{
　　String　　result = reader.readLine();
　　int　　　　pos;
　　if (result != null && 0 < result.length() &&
　　　　0 <= (pos = result.indexOf("\"")))
　　{
　　　　boolean　　inString = true;
　　　　String　　　rawline = result;
　　　　String　　　newline = null;
　　　　StringBuffer buff = new StringBuffer(1024);
　　　　while (true) {
　　　　　　while (0 <= (pos = rawline.indexOf("\"", ++pos))) {
　　　　　　　　inString = !inString;
　　　　　　}
　　　　　　if (inString && (newline = reader.readLine()) != null) {
　　　　　　　　buff.append(rawline);
　　　　　　　　buff.append("\n");
　　　　　　　　pos = -1;
　　　　　　　　rawline = newline;
　　　　　　　　continue;
　　　　　　}
　　　　　　else {
　　　　　　　　if (inString || 0 < buff.length()) {
　　　　　　　　　　buff.append(rawline);
　　　　　　　　　　if (inString) {
　　　　　　　　　　　　buff.append("\"");
　　　　　　　　　　}
　　　　　　　　　　result = buff.toString();
　　　　　　　　}
　　　　　　　　break;
　　　　　　}
　　　　}
　　}
　　return result;
}

注意）上記コードでは，フィールド内の改行をLF（"\n"）に決め打ちしていますが，実際にはCSVパーサの出力結果を受け取るプログラム（データベースなど）が要求する改行コードを挿入する必要があります。
使用すべき改行コードの選択は，プログラムが稼動するプラットフォームの改行コードを取得する
「String returnStr = System.getProperty("line.separator");」
が知られていますが，実行環境によってはCSVパーサとCSVパーサの出力結果を受け取るプログラムが異なるOSで稼動する場合もありうるので，正解は常に一つとは限りません。
そのため，厳密に処理するには出力する改行コードをプロパティファイルで指定できるようにするなどの工夫が必要です。

●レコードのフィールドへの分割
フィールド分割では，レコードに切り分けたテキストに対して，最初にレコード全体をカンマで分割し，分割した個々の文字列にダブルクォーテーションをヒントに必要な連結やエスケープ処理を行って，個々のフィールドを確定します。処理手順は以下のようになります。

1. レコード全体をStringクラスのsplitメソッドを使ってカンマで分割し，分割した個々の文字列データを順に先頭からダブルクォーテーションを探す。見つからなければその文字列は１フィールドとして確定する。
2. ダブルクォーテーションが見つかったら，次のダブルクォーテーションを探す。次のダブルクォーテーションの直後にダブルクォーテーションがあれば，エスケープされたダブルクォーテーションとして処理し，そうでなければフィールドの終わりと見なす。
3. フィールドで後ろのダブルクォーテーションが見つからない場合，フィールドに含まれるカンマでsplitメソッドが分割したものと見なして，フィールドの後ろに（splitメソッドが削除した）カンマと次のフィールドを連結する。
4. フィールドの開始と終了のダブルクォーテーションは削除する。

以上の処理を行うコードは次のようになります。（2009年6月22日改訂）

//------------------------------------------------------------------
/**
 * 1レコード分のテキストを分割してフィールドの配列にする。
 * @param src 1レコード分のテキストデータ。
 * @param dest フィールドの配列の出力先。
 */
private void splitRecord (
　　String　　　　src,
　　LinkedList　dest)
{
　　String[]　　columns = src.split(",");
　　int　　　　　maxlen = columns.length;
　　int　　　　　startPos, endPos, columnlen;
　　StringBuffer buff = new StringBuffer(1024);
　　String　　　column;
　　boolean　　isInString, isEscaped;

　　for (int index = 0; index < maxlen; index++) {
　　　　column = columns[index];
　　　　if ((endPos = column.indexOf("\"")) < 0) {
　　　　　　dest.addLast(column);
　　　　}
　　　　else {
　　　　　　isInString = (endPos == 0);
　　　　　　isEscaped = false;
　　　　　　columnlen = column.length();
　　　　　　buff.setLength(0);
　　　　　　startPos = (isInString)? 1: 0;
　　　　　　while (startPos < columnlen) {
　　　　　　　　if (0 <= (endPos = column.indexOf("\"", startPos))) {
　　　　　　　　　　buff.append((startPos < endPos)?
　　　　　　　　　　　　　　　　column.substring(startPos, endPos): isEscaped? "\"": "");
　　　　　　　　　　isEscaped = !isEscaped;
　　　　　　　　　　isInString = !isInString;
　　　　　　　　　　startPos = ++endPos;
　　　　　　　　}
　　　　　　　　else {
　　　　　　　　　　buff.append(column.substring(startPos));
　　　　　　　　　　if (isInString && index < maxlen - 1) {
　　　　　　　　　　　　column = columns[++index];
　　　　　　　　　　　　columnlen = column.length();
　　　　　　　　　　　　buff.append(",");
　　　　　　　　　　　　startPos = 0;
　　　　　　　　　　}
　　　　　　　　　　else {
　　　　　　　　　　　　break;
　　　　　　　　　　}
　　　　　　　　}
　　　　　　}
　　　　　　dest.addLast(buff.toString());
　　　　}
　　}
}

以上で「RFC4180対応のCSVパーサ」はひととおりできあがったかと思います。

■関連書籍をAmazonで検索：[Java]
●ソースコードリーディングから学ぶ Javaの設計と実装



　　　←この記事が役に立ったという方はクリックお願いします。

---

▼CSVパーサを作る[その１][その２][その３]

---

Java：CSVパーサを作る（その２） - RFC4180対応 前編

←CSVパーサを作る（その１） - 簡易パーサ

CSVの仕様について調べてみると「K3フォーマット」と「RFC4180（日本語訳）」が見つかります。K3フォーマットとCSVの違いについては「桐ver.８活用ガイド」というドキュメントの「読み込み K3フォーマット」と「読み込み CSV」という項目で記述されています。
ここでは前回の記事で作った簡易CSVパーサを発展させて，今回と次回の2回に分けてRFC4180で規定されたCSVが読み込めるCSVパーサを実装してみたいと思います。

【RFC4180で規定されたCSVの仕様】

1. レコードの区切りは改行である。改行コードはCRLFだが他の値も考慮すべきである。
2. ファイルの末尾に改行はあってもなくても良い。
3. ファイルの先頭行にヘッダ行があっても良い。ヘッダ行の有無はMIMEタイプ「text/csv」のパラメータ「header」で示す。header パラメータの値は「present」（存在する），または「absent」（存在しない）のどちらかである。「header」パラメータを使わない場合はヘッダの有無を自ら決める。
4. 各行にはカンマ「,」で区切ったフィールド列が必ずある（つまり空行はない）。フィールド数はすべての行で同じ。フィールド中の空白は無視しない。行末のカンマは行の終わりを表さない（その後ろにNULLフィールドがもう1つある）。
5. 各フィールドはダブルクォーテーション（二重引用符）「"」で囲んでも良いし囲まなくても良い。
6. 改行，ダブルクォーテーション，カンマを含むフィールドはダブルクォーテーションで囲む。
7. フィールドデータにダブルクォーテーションを含む場合，ダブルクォーテーションを２つ続けることでエスケープする。
8. 文字コードは一般にUS-ASCIIを使う，他の文字コードの使用を明示するにはMIMEタイプ「text/csv」のパラメータ「charset」で指定する。

【参考：K3フォーマットとRFC4180の違い】

1. フィールドをダブルクォーテーションで，
   • RFC4180：「囲んでも囲まなくてもよい」（数値型を囲んでもよい）
   • K3フォーマット：「文字列型データは囲む，数値型データは囲まない」（数値型，文字型以外は想定なし）
2. 行の先頭が「#」だった場合，
   • RFC4180：規定なし。よって通常のレコードとして解釈する。
   • K3フォーマット：その行をレコードとして解釈せずに以下のように解釈する：
     • 行頭が「#」の場合：制御コマンド記述行
     • 行頭が「##」の場合：コメント行
     • 行頭が「###」の場合：データ終了。この行以降のデータは取り込まない。

【仕様の考察】
CSVパーサのように外部からデータを取り込んでこれを処理するプログラムの場合，受け取ったデータがRFC4180の仕様に沿っていた場合に正常に処理できることはもちろん，仕様とは異なるデータを受け取った場合にどのように処理するかを決める必要があります。CSVパーサの実装を検討する上で考慮すべき事項として以下のようなものが考えられます。

1. 画像データやPDFなど，CSVではないデータを受け取った場合にどうするか。
2. RFC4180の仕様から若干外れたCSVデータ，たとえば次のようなデータを受け取った場合にこれをどのように処理するか：
   • CRLF以外の改行コードを受け取ったらどうするか。複数の種類の改行コードが混在していたらどうするか。
   • 仕様では「空行はない」とされているが，空行があった場合はどうするか。
   • 仕様では「フィールド数はすべての行で同じ」となっているが，フィールド数にばらつきがあった場合はどうするか。
   • 仕様で「改行，ダブルクォーテーション，カンマを含むフィールドはダブルクォーテーションで囲む」とあるが，囲まれていない場合はどうするか。フィールド中の改行とカンマについてはダブルクォーテーションなしでは判定は不可能だが，ダブルクォーテーションについてはエスケープされているかどうかで判定できる可能性がある。
   • ダブルクォーテーションで囲まれていないフィールドの途中にエスケープされていないダブルクォーテーションが出現した場合はどのように解釈するか。
   • 行頭が「#」の場合どうするか。RFC4180では行頭が「#」の場合については決められていないが，K3フォーマットではこの行はレコードとして解釈せずにコメント行または制御行として扱う。
   • 文字コードはどうするか。RFC4180ではUS-ASCIIがデフォルトだが，これだと日本語が扱えないのでデフォルトを変えるべきではないか。

これらを考慮する場合に重要なのが「リーズナブル」という考え方です。これは具体的には以下のような考え方です。

1. なるべく少ないコードでより多くの要求を満たす実装方法を選択する。
2. 重要ではない小さな要求のために大量のコードが必要になる実装方法は避ける。
3. 何かに対応するために大量のコードが必要になったら「この実装方法には何か根本的な問題があるのではないか？」と考える。
4. 実現不可能なもの，実現が困難なものはどこかで諦める。その場合はユーザが納得できる代替案を探す。

以上を踏まえて，CSVパーサを実現するためにRFC4180に対して以下のように追加修正を行います。

1. CSVパーサの実装において，CSV以外のデータを受け取った場合の処理については特に考慮しません。この問題は，CSVパーサが呼ばれる以前に，たとえばファイル名の拡張子でエラー判定するなどして解決するものとします。
2. フィールドに含まれる空白のうち，フィールドの先頭と末尾の空白は無視（削除）できることにします。これは特に数値を数値データとして取り込む場合に必要です。
3. MIMEタイプのパラメータは読み込んだCSVデータの中で判断できないため，パーサでは対応しません。
4. 行頭に「#」がある行はコメント行とします。ヘッダ行はこのコメント行で実現するものとします。対応すべき制御コマンドもないので「#」１つでもコメント行とします。
5. フィールド内にエスケープされたダブルクォーテーションが含まれる場合の動作は次のようにします。
   • エスケープされたダブルクォーテーションの前後にデータがある場合は，フィールド全体を囲むダブルクォーテーションはあってもなくても良い。
   • フィールド内のデータがエスケープされたダブルクォーテーションだけの場合，全体を囲むダブルクォーテーションが必須。（つまり連続する４つのダブルクォーテーションが必要。）
   • 逆にフィールド内のデータがダブルクォーテーションの1ペアだけだった場合，パーサはこれをダブルクォーテーションで囲んだNULLフィールドとして扱う。
6. レコードの区切りは改行（またはファイル末尾）ですが，ダブルクォーテーションで囲んだフィールドに改行が入っていることがあるため，改行がレコードの区切りとは限りません。
7. フィールド数は固定であることを期待しません。また空行もありうるものとします。空行はスキップします。フィールドが多いときは余りは無視します。フィールドが足りないときはNULLフィールドで補うものとします。
8. ダブルクォーテーションを２つ続けることによりダブルクォーテーションをエスケープする仕様のため，ダブルクォーテーションは１フィールド及び１レコード内で必ず偶数になります。
9. 文字コードはUS-ASCIIではなく「Windows-31J/MS932」とします。これはExcelで開けるCSVの文字コードに合わせています。

【実装の考察】
処理手順としては，入力したテキストデータを先頭から１レコードづつ切り出し，このレコードをフィールドに分割する，これを入力テキストの最後まで繰り返す，という流れになりますが，処理手順を検討した結果，以下の流れで処理を行うことにします。

1. レコードの確定
   入力テキストを1行づつ取り出し，ダブルクォーテーションのペアをトレースしてレコードの末尾を確定し，１レコードを確定する。
   • 取り出した1行分の入力テキストに含まれるダブルクォーテーションの数がゼロまたは偶数ならば，その1行を1レコードとして確定する。
   • 取り出した1行分の入力テキストに含まれるダブルクォーテーションの数が奇数ならば，ダブルクォーテーションで囲まれたフィールドの途中と見なして次の1行分の入力テキストを取り出し前の行と連結する。これをダブルクォーテーションが偶数になるまで（または入力テキスト末尾になるまで）繰り返す。
2. フィールドの分割
   レコードに対して，最初にレコード全体をカンマで分割した後で，ダブルクォーテーションをヒントに
   • 文字列フィールドのカンマによる分割の再結合
   • 文字列フィールドを囲むダブルクォーテーションの削除
   • ダブルクォーテーションが２つ連続した場合のエスケープ処理
   を行う。
3. 1と2を入力テキスト末尾まで繰り返す。

以上のような処理になりますが，ソースコードを簡潔にするために上記「レコードの確定」と「レコードのフィールドへの分割」を別メソッドにして実装することにします。

このメソッドを実装する前に，前回の記事で作った「簡易CSVパーサ」を，上記メソッドを呼び出すように書き換えたコードを先に作ってしまいます。

【簡易パーサの修正】
「レコードの確定」「レコードのフィールドへの分割」を行うメソッドを以下のように規定します。

/**
 * BufferedReaderから1レコード分のテキストを取り出す。
 * @param reader 行データを取り出すBufferedReader。
 * @return 1レコード分のテキスト。
 * @throws IOException 入出力エラー
 */
private String buildRecord (BufferedReader reader);

/**
 * レコードデータsrcを分割してフィールドの配列にする。
 * @param src レコードデータ。
 * @param dest レコードデータからフィールドの配列を取り出してリストに加える。
 */
private void splitRecord (String src, LinkedList dest);

このメソッドを使って前回の記事の「簡易CSVパーサプログラム」を書き換えると次のようになります。
注：行頭が「#」の行はコメント行と見なしてスキップするコードも追加しています。

//------------------------------------------------------------------
/**
 * CSVファイルの読み込み。
 * @param stream 入力ストリーム。FileInputStream，ByteArrayInputStreamなど。
 */
public void read (
　　InputStream　stream)
{
　　LinkedList　　　　　columns = new LinkedList();
　　InputStreamReader　reader = null;
　　BufferedReader　　　buff = null;
　　try {
　　　　reader　= new InputStreamReader(stream, "MS932");
　　　　buff　= new BufferedReader(reader);
　　　　String　record;
　　　　int　　　lineNum = 0;

　　　　while ((record = buildRecord(buff)) != null) {
　　　　　　lineNum++;
　　　　　　if (record.length() <= 0)
　　　　　　　　continue;
　　　　　　if (record.startsWith("#"))
　　　　　　　　continue;
　　　　　　splitRecord(record, columns);
　　　　　　if (0 < columns.size()) {
　　　　　　　　readColumns(columns, lineNum);
　　　　　　　　columns.clear();
　　　　　　}
　　　　}
　　}
　　catch (Exception ex) {
　　　　ex.printStackTrace();
　　}
　　finally {
　　　　columns.clear();
　　　　try {
　　　　　　if (buff != null) {
　　　　　　　　buff.close();
　　　　　　}
　　　　　　if (reader != null) {
　　　　　　　　reader.close();
　　　　　　}
　　　　　　stream.close();
　　　　}
　　　　catch (IOException ex) {
　　　　　　ex.printStackTrace();
　　　　}
　　}
}

//------------------------------------------------------------------
/**
 * 読み込んだ１レコード分のデータをDBに取り込む。
 * 実際の処理は派生クラスで実装。
 * @param columns １レコードをフィールドに分割した文字列リスト。
 * @param lineNum CSVの行番号（エラーが発生したときの行番号記録用）。
 */
abstract protected void readColumns (LinkedList columns, int lineNum);

今回はここまで。
次回は，「レコードの確定」と「レコードのフィールドへの分割」を行う「buildRecord」と「splitRecord」両メソッドの実装を行い，CSVパーサを完成させます。

CSVパーサを作る（その３） - RFC4180対応 後編→

■関連情報
CSVの仕様：RFC4180（日本語訳）（Wikipedia）
桐ver.８活用ガイド（K3フォーマットとCSVの違いについての解説あり）
Microsoftコードページ932（Wikipedia）
WebObjects：CSVレスポンスの実装

■関連書籍をAmazonで検索：[Java]
●Effective Java 第2版 (The Java Series)



　　　←この記事が役に立ったという方はクリックお願いします。

---

▼CSVパーサを作る[その１][その２][その３]

---

Java：CSVパーサを作る（その１） - 簡易パーサ

データベースやExcelなどでデータをインポート・エクスポートする際に使用されるファイルフォーマットとしてCSVがあります。
CSVを単にカンマでフィールドを区切り，改行でレコードを区切ったテキストデータと見るならば，JavaでCSVファイルをインポートしてデータベースに読み込ませるなどの処理を行うCSVパーサを作るには，BufferedReaderクラスのreadLineメソッドでレコードを取り出し，Stringクラスのsplitメソッドでフィールドに分割すれば，それでCSVパーサができあがります。
この場合の具体的なプログラムを以下に例示します。

■処理の概要
このCSVパーサでは，以下の処理をファイルの最後まで繰り返し実行します。

1. 読み込んだCSVデータから1行を1レコードとして取り出します。
2. 1レコードをフィールドに分割してStringクラスインスタンスのリストを作ります。
3. 1レコード分のフィールドのリストをレコード処理メソッド（「readColumns」）に渡します。

CSVパーサクラス及びreadColumnsメソッドはabstractとし，派生クラスでreadColumnsメソッドの処理を実装するものとします。派生クラスのreadColumnsメソッドでは，CSVパーサで生成した1レコード分のフィールドのリストをデータベースへ登録する処理などを実装します。
CSVファイルの文字コードは「Windows-31J/MS932」とします。これはExcelで開けるCSVの文字コードに合わせています。

■簡易CSVパーサプログラム

//------------------------------------------------------------------
/**
 * CSVファイルの読み込み。
 * @param stream 入力ストリーム。FileInputStream，ByteArrayInputStreamなど。
 */
public void read (
　　InputStream　stream)
{
　　InputStreamReader　reader = null;
　　BufferedReader　　　buff = null;
　　try {
　　　　reader　= new InputStreamReader(stream, "MS932");
　　　　buff　= new BufferedReader(reader);
　　　　String　　record;
　　　　String[]　columns;
　　　　int　　　lineNum = 0;

　　　　while ((record = buff.readLine()) != null) {
　　　　　　lineNum++;
　　　　　　if (record.length() <= 0)
　　　　　　　　continue;
　　　　　　columns = record.split(",");
　　　　　　if (0 < columns.length) {
　　　　　　　　readColumns(columns, lineNum);
　　　　　　}
　　　　}
　　}
　　catch (Exception ex) {
　　　　ex.printStackTrace();
　　}
　　finally {
　　　　try {
　　　　　　if (buff != null) {
　　　　　　　　buff.close();
　　　　　　}
　　　　　　if (reader != null) {
　　　　　　　　reader.close();
　　　　　　}
　　　　　　stream.close();
　　　　}
　　　　catch (IOException ex) {
　　　　　　ex.printStackTrace();
　　　　}
　　}
}

//------------------------------------------------------------------
/**
 * 読み込んだ１レコード分のデータをDBに取り込む。
 * 実際の処理は派生クラスで実装。
 * @param columns １レコードをフィールドに分割した文字列リスト。
 * @param lineNum CSVの行番号（エラーが発生したときの行番号記録用）。
 */
abstract protected void readColumns (String[] columns, int lineNum);

次回は，この簡易パーサを拡張して「RFC4180」に対応したCSVパーサへの拡張を試みます。

CSVパーサを作る（その２） - RFC4180対応 前編→

■関連情報
CSVの仕様：RFC4180（日本語訳）（Wikipedia）
Microsoftコードページ932（Wikipedia）
WebObjects：CSVレスポンスの実装

■関連書籍をAmazonで検索：[Java]
●Java謎+落とし穴徹底解明



　　　←この記事が役に立ったという方はクリックお願いします。

---

▼CSVパーサを作る[その１][その２][その３]

---

Java：MySQLに金額を格納する

データベースで金額を格納するのに適したデータ型として，MySQLでは「DECIMAL」型があります。FLOATやDOUBLEのような浮動小数点数の型では，小数点以下の値は近似値となりますが，DECIMALでは小数点以下の値も含めて正確に保存するために，MySQL5.0.3以前では数値を文字列に，5.0.3以降ではバイナリデータに変換して保存しています。「DEC」「NUMERIC」「FIXED」はDECIMALの別名です。
DECIMALフィールドの宣言は「DECIMAL(M,D)」です。Mはフィールド全体の桁数，DはMのうち小数点以下の桁数（スケール）を表します。DECIMALの最大桁数（DECIMAL(M,D)のMの値）は，MySQL5.0.3より前は1～254桁まで，5.0.6からは1～65桁までです。また，小数点以下の桁数（DECIMAL(M,D)のDの値）は0～30桁までです。（出典１）（出典２）

MySQLにJavaプログラムからJDBCアダプタ（MySQL Connector/J）経由でアクセスする場合，データベースのDECIMAL型のフィールドは，JDBCによりJavaの「BigDecimal」クラスインスタンスに置き換えられます。
BigDecimalクラスでは，BigDecimalどうしでの四則演算のほか，小数点以下の桁数操作や丸め処理を行うことができます。BigDecimalで指定できる丸め処理は以下になります。

パラメータ	名称	説明
ROUND_UP	切り上げ	計算結果に端数があれば，端数を切り捨てて最小桁を+1（負の値のときは-1）します。
ROUND_DOWN	切り捨て	計算結果に端数があれば，端数を単に切り捨てます。
ROUND_CEILING	正の無限大	計算結果が正の値のときは切り上げ，負の値のときは切り捨てを行います。その結果，誤差は必ず正の方向に現れます。この指定は負の方向に誤差が出てはならない場合に指定します。
ROUND_FLOOR	負の無限大	計算結果が正の値のときは切り捨て，負の値のときは切り上げを行います。その結果，誤差は必ず負の方向に現れます。この指定は正の方向に誤差が出てはならない場合に指定します。
ROUND_HALF_UP	四捨五入	計算結果の端数が0.5より小さいときは切り捨て，0.5より大きいときは切り上げ，0.5のときは切り上げを行います。 注：連続して計算を行う場合には，四捨五入のみを指定して計算すると，計算結果の累積誤差が大きくなる欠点があります。そのため五捨六入と交互またはランダムに切り替えて誤差を抑えるなどの工夫が必要です。
ROUND_HALF_DOWN	五捨六入	計算結果の端数が0.5より小さいときは切り捨て，0.5より大きいときは切り上げ，0.5のときは切り捨てを行います。
ROUND_HALF_EVEN	最近接偶数への丸め	計算結果の端数が0.5より小さいときは切り捨て，0.5より大きいときは切り上げ，0.5のときは結果が偶数になるように切り上げまたは切り捨てを行います。 具体的には「0.5→0（切捨），1.5→2（切上），2.5→2（切捨），3.5→4（切上），4.5→4（切捨），5.5→6（切上）…」といった値になります。 連続して計算を行う場合に，累積誤差が出にくい丸め処理です。
ROUND_UNNECESSARY	丸め無し	計算結果で端数が生じる場合はArithmeticException例外をスローします。

●BigDecimalでの数値の比較
BigDecimal同士で数値を比較する場合，equalsメソッドでは数値としては同じでもスケールが違う値，たとえば「1」「1.0」「1.00」は別の値として判定されてしまいます。
これらを同じ値として比較判定する場合はcompareToメソッドを使います。

●BigDecimalでのゼロ値の判定
BigDecimalに設定された値がゼロかどうかを判定する場合，予めゼロ値を設定したBigDecimalとcompareToメソッドで比較判定する方法のほかに，BigDecimalのsignumメソッドが0を返すかどうかでも判定できます。signumメソッドは値が負の場合は-1，ゼロの場合は0，正の場合は1を返します。
予めゼロ値が設定されているBigDecimalを使いたい場合は，Java1.5以降で「BigDecimal.ZERO」が定義されています。

■関連情報
MySQL：5.0.3以降のDECIMAL データ タイプの変更（MySQL5.1：22章：精密計算）
MySQLの数値型：[4.1][5.1]
MySQL Connector/J：JDBCで値を受け渡すときのJavaの型：[5.0][5.1]
端数処理：（Wikipedia）

■関連書籍をAmazonで検索：[MySQL][Java][JDBC]
●MySQLクックブック〈VOLUME1〉　〈VOLUME2〉



　　　←この記事が役に立ったという方はクリックお願いします。

---

JavaMail：メール送信でOP25B対応

【概要】
昨今のスパムメール対策により，Javaプログラムからのメール送信が困難な場合がでてきています。送信先がLAN内だったり，LAN内のメールサーバ（MTA）をリレーしたり，ISPが提供するメールサーバをリレーしてメール送信するなら問題ありませんが，JavaプログラムからISPのユーザ回線を経由してインターネットの向こう側に設置しているメールサーバでメールをリレーしようとすると，最近各ISPが導入を進めているOutbound Port 25 Blocking（OP25B）によりメール送信が阻止されてしまうことがあります。
Outbound Port 25 Blockingとは，一般ユーザのパソコンから送信用メールサーバをリレーせずに直接送信先のメールサーバへメールを送りつけるのを禁止するもので，ISPのユーザ回線から外部の25番ポート（SMTP）へ接続するのを阻止することで実現しています。これにより25番ポートからインターネットへメール送信できるのはISPのメールサーバや固定IPを取得したホストに限られますが，メールをリレーする送信用メールサーバがISPの外側にいる場合にも接続が阻止される弊害が出ています。
この対策としては，ISPの外側にいるメールサーバがメール送信のリレーを受け付けるときは25番以外のポート番号を使用すればよいということになります。この代替ポートとして「サブミッションポート」と呼ばれる587番ポートを使うようメールサーバを設定することができます。このとき587番ポートが正規のアカウントによるメール送信のみに使われるように，587番ポートはSASL認証必須に設定します。メールサーバ側のサブミッションポート対応についてはこちらの記事の後半にて，Mac OS X Serverで稼動するPostfixの設定方法を解説しています。

【JavaMailによる実装例】
この記事では，JavaプログラムからJavaMailを使ってメール送信するときに，メールサーバに25番ではなく587番ポートに接続して，SASL認証を行った上でメール送信するコードを例示します。なお，JavaMailを使用するには，事前にJavaMailとJAFをダウンロードして，クラスパスで指定されているディレクトリにJavaMailの「mail.jar」とJAFの「activation.jar」をインストールしておく必要があります。（JAFはJava SE 6に含まれるようになったので，Java SE 6ではJAFのインストールは不要です。）
JavaMailダウンロード：[JavaMail][JAF]
クラスパスの設定：[概要][Windows][Solaris][Mac OS X]
下記のコードではSASLの認証方法として「AUTH LOGIN」で認証できることを確認しています。認証方法「CRAM-MD5」については，JavaMailではSMTPで未サポートのようです（出典）。

下記のコードは25番ポートへ認証なしにメールを送信する場合と以下の点が異なります。
１）接続先SMTPサーバのポート番号を587番に指定：
→プロパティ「mail.smtp.port」を「587」に設定。

２）SASL認証（SMTP Auth）を試みるよう指定：
→プロパティ「mail.smtp.auth」を「true」に設定。

３）SASL認証で使用する認証情報クラスを用意する：
→Authenticatorクラスを継承し，getPasswordAuthenticationメソッドを実装したクラス（PassAuther）を用意する。

４）Session取得時に認証情報クラスインスタンスで初期化：
→Session.getDefaultInstance()メソッドの第二引数にPassAutherのインスタンスを渡す。

【WebObjectsでJavaMailを使う場合の注意】
WebObjectsアプリケーションではデフォルトで「Session」というクラスが作られるため，JavaMailのSessionクラスとクラス名のバッティングが起こります。そのためJavaMailのSessionクラスを指定する場合に「javax.mail.Session」とフルパスでクラス名を指定するなどの対応が必要です。

JavaMailを使って587番ポートからSASL認証してメール送信を行う実装例：

import java.util.*;
import javax.mail.*;
import javax.mail.internet.*;
/**
 * SendSASLMail：メール送信クラス.
 */
public class SendSASLMail
{
　　/**
　　 * PassAuther：認証情報クラス.
　　 */
　　private class PassAuther extends Authenticator
　　{
　　　　private String mUserName;
　　　　private String mPassword;
　　　　//------------------------------------------------------------------
　　　　/**
　　　　 * PassAutherクラスのコンストラクタ.
　　　　 * @param userName SASL認証で使うユーザ名.
　　　　 * @param passwd　 同パスワード.
　　　　 */
　　　　public PassAuther (
　　　　　　String　userName,
　　　　　　String　passwd)
　　　　{
　　　　　　super();
　　　　　　mUserName = userName;
　　　　　　mPassword = passwd;
　　　　}
　　　　//------------------------------------------------------------------
　　　　/**
　　　　 * Authenticatorの派生クラスで必須のメソッド.
　　　　 */
　　　　public PasswordAuthentication getPasswordAuthentication ()
　　　　{
　　　　　　return new PasswordAuthentication(mUserName, mPassword);
　　　　}
　　}

　　private String mHostName;
　　private String mUserName;
　　private String mPassword;
　　//------------------------------------------------------------------
　　/**
　　 * SendSASLMailクラスのコンストラクタ.
　　 * @param host　　　送信用ホスト名.
　　 * @param userName　SASL認証用ユーザ名.
　　 * @param passwd　　SASL認証用パスワード.
　　 */
　　public SendSASLMail (
　　　　String　host,
　　　　String　userName,
　　　　String　passwd)
　　{
　　　　mHostName = host;
　　　　mUserName = userName;
　　　　mPassword = passwd;
　　}

　　//------------------------------------------------------------------
　　/**
　　 * メール送信実行メソッド.
　　 * @param　from　　 差出人.
　　 * @param　toList　 宛先リスト.
　　 * @param　ccList　 CCリスト.
　　 * @param　bccList　BCCリスト.
　　 * @param　subject　Subject.
　　 * @param　message　メール本文.
　　 * @throws MessagingException
　　 * @throws AuthenticationFailedException
　　 * @throws SendFailedException
　　 */
　　public void send (
　　　　Address　　from,
　　　　Address[]　toList,
　　　　Address[]　ccList,
　　　　Address[]　bccList,
　　　　String　　 subject,
　　　　String　　 message)
　　　　throws MessagingException, AuthenticationFailedException, SendFailedException
　　{
　　　　if (from != null && toList != null && 0 < toList.length) {
　　　　　　Properties props = new Properties();
　　　　　　props.setProperty("mail.transport.protocol", "smtp");
　　　　　　props.setProperty("mail.smtp.host", mHostName);
　　　　　　props.setProperty("mail.smtp.port", "587");
　　　　　　props.setProperty("mail.host", mHostName);
　　　　　　props.setProperty("mail.smtp.connectiontimeout", "60000");
　　　　　　props.setProperty("mail.smtp.timeout", "60000");
　　　　　　props.setProperty("mail.smtp.auth", "true");

　　　　　　Authenticator auther = new PassAuther(mUserName, mPassword);
　　　　　　Session session = Session.getDefaultInstance(props, auther);

　　　　　　// session.setDebug(true); // デバッグ情報を表示する.
　　　　　　MimeMessage mmsg = new MimeMessage(session);

　　　　　　mmsg.setFrom(from);
　　　　　　mmsg.setRecipients(Message.RecipientType.TO, toList);
　　　　　　if (ccList != null && 0 < ccList.length) {
　　　　　　　　mmsg.setRecipients(Message.RecipientType.CC, ccList);
　　　　　　}
　　　　　　if (bccList != null && 0 < bccList.length) {
　　　　　　　　mmsg.setRecipients(Message.RecipientType.BCC, bccList);
　　　　　　}
　　　　　　if (subject != null && 0 < subject.length()) {
　　　　　　　　mmsg.setSubject(subject, "iso-2022-jp");
　　　　　　}
　　　　　　mmsg.setText(message, "iso-2022-jp");
　　　　　　mmsg.setSentDate(new Date());

　　　　　　Transport.send(mmsg);
　　　　}
　　}

　　//------------------------------------------------------------------
　　/**
　　 * 動作確認用mainメソッド.
　　 * @param args
　　 */
　　public static void main(String[] args)
　　{
　　　　SendSASLMail sender = new SendSASLMail("mail.example.com", "username", "password");
　　　　try {
　　　　　　Address from = new InternetAddress("address@example.com", "差出人", "iso-2022-jp");
　　　　　　Address to = new InternetAddress("addr1@example.com", "宛先１（TO）", "iso-2022-jp");
　　　　　　Address cc = new InternetAddress("addr2@example.com", "宛先２（CC）", "iso-2022-jp");

　　　　　　Address[] toList = new Address[] {to};
　　　　　　Address[] ccList = new Address[] {cc};

　　　　　　String subject = "テストメール";
　　　　　　String message = "JavaMailからのメールです。";

　　　　　　sender.send(from, toList, ccList, null, subject, message);
　　　　}
　　　　catch (Exception ex) {
　　　　　　ex.printStackTrace();
　　　　}
　　}
}

■関連情報
ISPによるOP25B 実施状況（（財）日本データ通信協会・迷惑メール相談センター）
メール送信サンプル：[JavaMail(SMTP)編（JavaでHelloWorld）][JavaMailでメール送信アプリを作る（@IT Java Tips）]
JavaMail完全解説
Sun：[JavaMail]
API Reference(javadoc)：[JavaMail][J2EE 1.3.1]
ダウンロード：[JavaMail][JAF]
WebObjects：WOMailDeliveryで日本語メール送信

■関連書籍をAmazonで検索：[JavaMail][Java]
●J2EEパターン 第2版



　　　←この記事が役に立ったという方はクリックお願いします。

---

Java：ログインパスワードを暗号化する

Webアプリケーションなどでは，アクセス時にパスワードによるログイン認証を行う場合があります。
ここではその具体的な実装のうち，データベースに格納するログインパスワードの暗号化について述べてみたいと思います。

【概要】
複数のユーザが個別にユーザ名とパスワードを設定する場合，そのアカウント情報はデータベースに保存するようになると思います。
このときパスワードをそのままデータベースに保存してしまうと，パスワードはデータベースを閲覧できるすべての人に知られてしまいます。また，Base64変換や元に戻せる暗号にした場合でも，元に戻せる技術をもった人にパスワードを知られてしまう可能性があります。そのため，パスワードを保存する場合は不可逆暗号にするのが一般的かと思います。
不可逆暗号とは元に戻せない暗号です。不可逆暗号を使ってパスワード認証を行うには，事前に暗号化したパスワードをデータベースに保存しておき，ログイン時にユーザが入力したパスワードを暗号化してみて，データベースに保存されている暗号化されたパスワードと同一になるかどうかで正しいパスワードか判断することができます。不可逆のメリットとしては，元に戻せないのでパスワードの漏洩が防げると同時に，データベースを閲覧できる人にパスワード窃盗の嫌疑がかかるのを防ぐことができます。デメリットとしては，元に戻せないのでユーザがパスワードを忘れてしまったらパスワードを登録し直すしか手がないことです。

パスワードだけを暗号化した場合，同じパスワードの人がいた場合に同じ暗号データがデータベースに登録されてしまい，データベースを閲覧した人に同じパスワードであることがわかってしまう可能性があります。この対策としては（ユニークな）ユーザ名とパスワードを加えて暗号化すれば良いかと思います。

【Javaによる不可逆暗号の実装】
Javaにはメッセージダイジェストを作成するクラスがありますので，これを使って不可逆暗号を作ることができます。具体例として下記のようなコードになります。
なお，このコードではユーザ名がNULLであることを想定していません。なぜならユーザ名はアカウントを特定するユニークキーなので，必須であるべきだからです。ユーザがユーザ名を入力しなかった場合は，このメソッドを呼ぶ前にエラーではじくべきです。
このコードでは，メッセージダイジェストをテキストとして扱うために，sun.misc.Base64Encodingを使用してBase64変換しています。また，Base64Encodingの出力結果は末尾にプラットフォーム依存の改行コードが入るので，これを削除するためにStringクラスのtrimメソッドを使用しています。

import java.security.*;
import sun.misc.*;

/**
*　パスワードを不可逆暗号化する.
*/
public class PassDigest
{
　　//------------------------------------------------------------------
　　/**
　　 * ユーザ名とパスワードでメッセージダイジェストを作成しBASE64エンコードして返す.
　　 * @param userName ユーザ名.
　　 * @param password パスワード.
　　 * @return 生成したダイジェスト.
　　 * @throws NoSuchAlgorithmException Java実行環境にSHA-1が実装されていない.
　　 */
　　public static String build (
　　　　String　userName,
　　　　String　password)
　　　　throws NoSuchAlgorithmException
　　{
　　　　String　passDigest = null;
　　　　if (password != null && 0 < password.length()) {
　　　　　　MessageDigest md = MessageDigest.getInstance("SHA-1");
　　　　　　md.update(userName.getBytes());
　　　　　　md.update(password.getBytes());
　　　　　　byte[] digest = md.digest();

　　　　　　BASE64Encoder encoder = new BASE64Encoder();
　　　　　　String b64digest = encoder.encodeBuffer(digest);
　　　　　　passDigest = b64digest.trim();
　　　　}
　　　　return passDigest;
　　}
}

■関連情報
Sun：Java暗号化アーキテクチャ　API の仕様およびリファレンス
クラスMessageDigest（Javadoc）

■関連書籍をAmazonで検索：[Java]
●Javaで作って学ぶ暗号技術 - RSA,AES,SHAの基礎からSSLまで



　　　←この記事が役に立ったという方はクリックお願いします。

---

WebObjects：メモリ不足エラー対応

【問題】
WebObjectsで開発したWebアプリケーションが稼動中にメモリ不足でメモリ割り当てできなくなったとき，OutOfMemoryError例外が発生します。

【対応策】
WebObjectsで開発するWebアプリはJavaアプリケーションなので，対応策は基本的にJavaアプリケーションと同じです。

■割り当てメモリと残メモリの調査
Webアプリケーションには，起動時にJava VMからヒープメモリが割り当てられます。
割り当てられたヒープメモリのサイズは以下のコードで調べることができます。このコードはたとえばmainメソッドの先頭に埋め込むと良いでしょう。

割り当てメモリサイズを表示するJavaプログラムコード

long total = Runtime.getRuntime().totalMemory(); System.out.println("Total Memory = " + Long.toString(total) + "bytes");

特定の時点での残りのヒープメモリは以下のコードで調べることができます。
このコードでは回収できるメモリはできるだけ回収してから残メモリサイズをカウントするため，事前にgcを呼ぶようにしています。
このコードはOutOfMemoryError例外が発生する処理を行う直前の残メモリを調べるときなどに使えるでしょう。

残メモリサイズを表示するJavaプログラムコード

Runtime.getRuntime().gc(); long free = Runtime.getRuntime().freeMemory(); System.out.println("Free Memory = " + Long.toString(free) + "bytes");

※メモリ不足エラーが起きたときは，原因がメモリリークではないかを十分に確認してください。Java VMは参照されなくなったメモリを自動的に回収してくれますが，参照されたままのメモリは回収してくれません。

■Javaでの割り当てメモリ拡張方法
Javaアプリケーションのメモリ不足に対する最も手っ取り早い対処方法が，アプリケーション割り当てメモリを増やすことです。
Javaでは，アプリを起動するjavaコマンド（[Win版][Solaris版]）へのオプション指定で割り当てメモリのサイズを指定することができます。

指定できるオプション指定：
-Xmxサイズ値：割り当てメモリの最大値を指定
-Xmsサイズ値：割り当てメモリの初期値を指定

サイズ値は，-Xmxは2MBより大きい1024の倍数，-Xmsは1MBより大きい1024の倍数でなければなりません。
各サイズ値にキロバイトを指定する場合はkまたはK，メガバイトを指定する場合はmまたはMを付けます。

-Xmxで指定できる値の上限は，OS環境やJavaVMのバージョンにより異なるようです。-Xmxに上限を超える値を指定した場合は「Could not reserve enough space for object heap」というエラーメッセージが返ります。

コマンドラインから起動する場合のオプション指定例：最大値128MB，初期値64MB，起動クラス：EntryClass

java -Xmx128m -Xms64m EntryClass

■WebObjectsでメモリサイズを指定するには？
オプション「-Xmxサイズ値」及び「-Xmsサイズ値」をWebObjectsで運用するWebアプリに適用するには以下のようにします。
●運用環境で，すでに実稼動しているWebアプリに設定する。
JavaMonitorで以下の設定を行います。
1.JavaMonitorを起動し，Applicationsタブの画面から設定するアプリケーションの「Config」ボタンを押します。
2.「Configuring Application "アプリケーション名"」の画面が表示され，「New Instance Defaults」が開いている状態になります。
3.「New Instance Defaults」の「Additional Arguments:」テキストボックスにオプション「-Xmxサイズ値 -Xmsサイズ値」を入力（追記）して「Push」「Update for New Instances Only」ボタンを押します。
4.アプリケーションのDetail View画面に移動し，アプリケーションを再起動します。

●開発版（動作確認用）に設定する。
1.Xcodeにて，プロジェクト名のターゲットをダブルクリックで開きます。
2.「設定」ポップアップで「Development」を選びます。
3.ウインドウの左側リストから「設定」→「シンプルビュー」→「詳細設定ビュー」を開きます。
4.「ビルド設定」が開くので，この中の「JVM_OPTIONS」に「-Xmxサイズ値 -Xmsサイズ値」を入力（追記）します。
5.ウインドウを閉じ，ターゲットをクリーニングしてビルドします。

●開発環境でビルドする運用版に設定する。
1.Xcodeにて，プロジェクト名のターゲットをダブルクリックで開きます。
2.ウインドウの左側リストから「設定」→「シンプルビュー」→「詳細設定ビュー」を開きます。
3.「ビルド設定」が開くので，この中の「JVM_OPTIONS」に「-Xmxサイズ値 -Xmsサイズ値」を入力（追記）します。
4.以上の操作をすべてのターゲットのすべての「設定」ポップアップで行います。
5.ウインドウを閉じ，ターゲットをクリーニングしてビルドします。

※上記で指定した内容が，ビルドした運用版Webアプリのパッケージに含まれる各プラットフォーム用クラスパスファイル（例：MacOS用のクラスパスファイルは「Contents/MacOS/MacOSClassPath.txt」）の「# JVMOptions」行に反映されます。

■関連情報
OutOfMemoryError対応事例（@IT：Java Solution）
WebObjects旧版のJavaメモリリーク問題
WebObjects：[日本語技術マニュアル][開発と運用について][API Reference(javadoc)][ADC Tools][サポート][製品紹介]

■関連書籍をAmazonで検索：[Java][WebObjects 和書 洋書]
●Webアプリケーション・サーバー 設計・構築ノウハウ

■Apple Store：Windows/Solaris版[WebObjects 5.2]

　　　　←この記事が役に立ったという方はクリックお願いします。

---

Javadocで日本語APIリファレンスを作る

Javaに付属のコマンドツールに「javadoc」というのがあります。
このコマンドにより，JavaのソースファイルからHTML形式のAPIリファレンスを自動生成することができます。
Sunが公開しているJava組み込みクラスのAPIリファレンスは，Javadocで生成したAPIリファレンスの一例です。

Javadocはデフォルトで英語のソースファイルから英語のドキュメントを生成しようとします。
Javadocで日本語のドキュメントを生成するには，Javadocのコマンド実行時に以下のオプション指定を行います。

１）Javadocが生成するメッセージを英語から日本語にしたい。
→Javadocのコマンドオプションで，
「-locale ja」
と指定することで，ドキュメントのナビゲーションバーなどのメッセージが日本語になります。このメッセージの文字コードは，下記４）のオプション指定で決まります。
このロケールについての解説は「java.util.Locale」を参照。また，ここで指定できる言語コードのリストはこちらを参照。

２）生成されるHTMLファイルのヘッダで文字コード指定を行いたい。
→Javadocのコマンドオプションで，
「-charset "文字セット名"」（注：文字セット名はダブルクォーテーションで囲む）
を指定することで，ドキュメントのHTMLヘッダに

<meta http-equiv="Content-Type" content="text/html; charset=文字セット名">

の行が付加されます。
ここで指定できる日本語の文字セット名には「Shift_JIS」「euc-jp」「iso-2022-jp」「utf-8」「Windows-31J」があります。
ここで指定する文字セット名は下記４）の文字エンコーディング名と合わせる必要があります。HTMLヘッダにこの行を付加しない場合はブラウザのデフォルト値が適用されます。
ここで指定できる文字セット名のリストはこちらを参照。

３）Javaソースファイルの文字コードを指定したい。
→Javadocのコマンドオプションで，
「-encoding 文字エンコーディング名」
を指定します。これと下記４）との組み合わせで，ソースファイル内の文字列をHTMLに出力するときの文字コード変換の内容が決まります。
指定可能な文字エンコーディング：[Java 1.4][Java 1.5]

４）出力するHTMLファイルの文字コードを指定したい。
→Javadocのコマンドオプションで，
「-docencoding 文字エンコーディング名」
を指定します。これにより，上記１）の日本語メッセージの文字コードが決まります。また，上記３）との組み合わせで，ソースファイル内の文字列をHTMLに出力するときの文字コード変換の内容が決まります。
指定可能な文字エンコーディング：[Java 1.4][Java 1.5]

コマンド実行例：UTF-8のソースファイルからSJISのドキュメントを生成する。

javadoc -locale ja -charset "Shift_JIS" -encoding UTF-8 -docencoding SJIS -d docs -private *.java

（「-d docs」は出力ディレクトリに「docs」を指定，「-private」はprivateなクラスやメソッドのリファレンスも出力）

■関連情報
Javadocの基本的な使い方（JavaでHelloWorld）
Sun：Javadocのドキュメント[Solaris版][Windows版]
Java：Shift_JISのエイリアスの変更について

■関連書籍をAmazonで検索：[Java]
●エンジニアのためのJavadoc再入門講座 現場で使えるAPI仕様書の作り方



　　　←この記事が役に立ったという方はクリックお願いします。

---

WebObjects：Javaソースコードに日本語を埋め込む

【問題】
WebObjectsで開発したWebアプリケーションで日本語を表示しようとしたときに，日本語文字列をJavaソースコードに埋め込んで，

String str = new String("こんにちは");

このように書いて，この文字列データをWebブラウザで表示させると文字化けすることがあります。

【原因】
Javaコンパイラはデフォルトでソースファイルの文字コードを英文として解釈しようとします。
JavaのStringクラスは文字列データをUnicode(UCS-2)で保持するため，コンパイル時に文字列データの文字コード変換を行いますが，このときソースファイルがたとえばShift_JISで書かれていた場合，コンパイル時の文字コード変換が「英文→UCS2」ではなく「Shift_JIS→UCS-2」である必要があることをJavaコンパイラに知らせる必要があります。逆にコンパイラに「Shift_JIS→UCS-2」の変換を指定した場合，すべてのソースファイルの日本語文字コードをShift_JISに揃える必要があります。

【対応策】
この問題に対処するには次の２つの対処を行います。
１）開発環境のJavaコンパイラに，オプション指定で日本語文字コードを指定する。
２）ソースファイルで使用する日本語文字コードを１）で指定したものに統一する。

●Mac OS XのWebObjects開発環境では以下の手順でこれに対応します。
１）Javaコンパイラに日本語文字コードを指定する。
・ProjectBuilder（Mac OS X 10.2.xまで）の場合：
「ターゲット」タブを選んで，各ターゲットの「Javaコンパイラ設定」を開くと「ソースファイルのエンコーディング」というポップアップメニューがありますので，これをソースコードの文字コードと同じものにします。そのためにはProjectBuilderの「ProjectBuilder」メニュー→「環境設定」ダイアログの「テキスト編集」タブ→「デフォルトのエンコーディング」に設定してある文字コードと同じものにしてください。この操作はすべてのターゲットで行ってください。

・Xcode（Mac OS X 10.3以降）の場合：
ウインドウの左枠の中に「ターゲット」があり，この中には通常プロジェクト名，「Application Server」，「Web Server」の３つのターゲットがあります。この各ターゲット名をダブルクリックすると，ターゲットの設定ダイアログが表示されます。この中の「Javaコンパイラの設定」を選んで表示される設定パネルに「ソースファイルのエンコーディング」がありますので，ここでソースファイルの文字コードを指定します。この操作はすべてのターゲットのすべての「設定」ポップアップで行ってください。

注意：開発の初期の段階で，すべてのターゲットと設定で文字コードを指定しておくことは重要です。
開発版の設定の文字コードだけ変更しても，開発環境で動作テストするときは正常に動作しますが，そのまま開発を続けると，運用版をビルドして実機で稼動させるときになって文字化けが再発することになります。変更が必要だとわかっているうちに忘れずに変更しておきましょう。

以上の操作を行うことで，Javaコンパイラはソースコードが指定した文字コードで書かれているものとして処理するようになります。

２）ソースファイルの文字コードの設定
ProjectBuilder/Xcodeにおいて新規ファイルを作成すると「環境設定」→「テキスト編集」→「デフォルトのファイルエンコーディング」で指定した文字コードが適用されます。そのためこの値も１）で指定したものに合わせます。ただし「新規プロジェクト」で作成されるソースファイル（「Application.java」「Session.java」「DirectAction.java」）の文字コードは設定にかかわらず「Mac OS Roman」なので，これらの文字コードは後で手動で変更する必要があります。

各ソースファイルの文字コードはProjectBuilder/Xcodeが認識しており，ソースコードの編集で日本語入力が行われると，認識されている文字コードで日本語文字列がソースコードに挿入されます。特定のソースファイルの文字コードがどのように認識されているかは，ソースファイルをプロジェクトから開いて「形式」メニュー→「ファイルエンコーディング」で確認することができます。ここで認識されている文字コードと，１）で指定した文字コードが食い違っていた場合，文字化けを起こす原因になります。
この食い違いを正すには，ProjectBuilder/Xcodeの「形式」メニュー→「ファイルエンコーディング」で正しい文字コードを指定します。すると「再解釈」または「変換」を指定するダイアログが表示されるので，開発環境の文字コードの認識の間違いを正す場合は「再解釈」を，別の文字コードに変換する場合は「変換」を選びます。これによりソースファイルの文字コードとコンパイラが認識する文字コードを合わせることができます。

注意：文字コードの認識が間違った状態で「変換」を行うと日本語文字列データが壊れます。壊れたまま上書き保存してしまわないようにしましょう。

３）WebObjectsBuilderの環境設定
WebObjectsBuilderはソースファイルへのメソッドの追加などを行いますが，このときWebObjectsBuilderの環境設定で指定された文字コードと実際のソースファイルの文字コードが異なる場合，ソースファイルの日本語文字データが壊れます。そのためWebObjectsBuilderの環境設定でも１）と同じ文字コードを設定しておく必要があります。
この設定は，「WebObjects Builder」メニュー→「Preferences...」で環境設定ダイアログを開いて「General」タブの「Default encoding」ポップアップで行います。

■関連情報
WebObjects：[日本語技術マニュアル][API Reference(javadoc)][ADC Tools][サポート][製品紹介]

■関連書籍をAmazonで検索：[Java][WebObjects 和書 洋書]
●プログラミングMacOS X for Java Geeks

■Apple Store：Windows/Solaris版[WebObjects 5.2]

　　　←この記事が役に立ったという方はクリックお願いします。

---