BEA WebLogic Server インターナショナライゼーション ユーティリティの使い方

以下の節では、インターナショナライゼーションおよびローカライゼーションに使用される WebLogic Server ユーティリティに関する情報を記述します。

• WebLogic Server インターナショナライゼーション ユーティリティ

• WebLogic Server のインターナショナライゼーションおよびローカライゼーション インタフェース

• 18ngen ユーティリティ

• l10ngen ユーティリティ

• CatInfo ユーティリティ

 

---

WebLogic Server インターナショナライゼーション ユーティリティ

WebLogic Server では、以下の 3 つのインターナショナライゼーション ユーティリティが用意されています。

• 18ngen ユーティリティ-メッセージ カタログのパーサ。このユーティリティは、ログ メッセージ内のテキストのローカライズに使用されるクラスの生成に使用します。

• l10ngen ユーティリティ-ロケール固有のメッセージ カタログのパーサ。このユーティリティは、ロケール固有のカタログの処理に使用します。

• CatInfo ユーティリティ-組み込まれているログ メッセージのリストを生成するユーティリティ。このユーティリティは、組み込まれているログ メッセージのリストの生成に使用します。

注意: カタログ定義のテキストでは読みやすいように書式設定文字 (行末文字など) が使用される場合がありますが、それらの文字はパーサでは維持されません。テキスト データは、1 行の文字列に標準化されます。先頭と末尾のホワイト スペースはすべて削除されます。埋め込まれている行末文字は、単語の区切りを維持するために必要に応じてスペースに置き換えられます。タブはそのまま残されます。

 

---

WebLogic Server のインターナショナライゼーションおよびローカライゼーション インタフェース

i18ngen ユーティリティは、メッセージ カタログを検証し、ローカライズされたメッセージの生成に必要な実行時クラスを作成します。l10ngen ユーティリティは、ロケール固有のカタログを検証し、カタログで定義されたさまざまな異なるロケールで使用される追加のプロパティ ファイルを作成します。

WebLogic Server で実行しているシンプル テキストベースのユーティリティは、それらのユーティリティでテキスト データのアクセスに Localizer を使用するように指定することにより、インターナショナライズできます。i18ngen ユーティリティから生成された Logger および TextFormatter クラスをアプリケーションに組み込みます。i18ngen ユーティリティの詳細については、18ngen ユーティリティを参照してください。

生成された Logger クラスは、英語のテキストをログに書き込む従来の方法に代わるログ記録の手段として使用されます。たとえば、i18ngen では、カタログ xyz.xml に対して適切なパッケージにクラス xyzLogger が生成されます。

もう 1 つ例を挙げると、たとえば MyUtilLog.xml カタログが使用される場合は、クラス programs.utils.MyUtilLogger.class が生成されます。カタログで定義されているログ メッセージごとに、このクラスでは method 属性で定義されているとおりに静的なパブリック メソッドが格納されます。

TextFormatter クラスは、シンプル メッセージ カタログごとに生成されます。TextFormatter クラスには、カタログのローカライズおよびフォーマットされたテキストにアクセスするために使用する静的なメソッドがあります。このクラスは、メッセージ本文、プレースホルダ、および MessageFormat とのインタフェースを処理するコンビニエンス クラスです。フォーマット用メソッドは、各メッセージ定義の method 属性により指定します。たとえば、あるカタログのメッセージ定義に属性 method=getErrorNumber(int err) が指定されている場合、リスト4-1 に示されている TextFormatter クラスが生成されます。

コード リスト 4-1 TextFormatter クラスの例

package my.text;
public class xyzTextFormatter
{
   . . .
   public String getErrorNumber(int err)
   {
   . . .
   }
}

リスト4-2 は、getErrorNumber メソッドのコードでの使用例を示しています。

コード リスト 4-2 getErrorNumber メソッドの例

import my.text.xyzTextFormatter
. . .

xyzTextFormatter xyzL10n = new xyzTextFormatter();
System.out.println(xyzL10n.getErrorNumber(someVal));

この場合、someVal 引数が適切に挿入された状態で現在のロケールのメッセージ テキストが出力されます。

 

---

18ngen ユーティリティ

i18ngen ユーティリティでは、メッセージ カタログ (XML ファイル) が解析され、ログ メッセージのテキストをローカライズするための Logger クラスおよび TextFormatter クラスが生成されます。最上位のメッセージ カタログは、Java クラスおよびプロパティ ファイルにコンパイルされます。i18ngen ユーティリティでは、i18n_user.properties ファイルの作成または更新も行われます。エラーや警告などのメッセージはすべて stderr に送信されます。

構文

java weblogic.i18ngen [options] files

注意: ユーティリティはどのディレクトリからでも実行できますが、ファイルがコマンド ラインで指定される場合、ファイル パスはカレント ディレクトリに対する相対パスになります。

オプション

オプション	定義
-d targetdirectory	生成された Java ソース ファイルの宛先となるルート ディレクトリを指定する。ユーザ カタログ プロパティは、指定された対象ディレクトリの相対パスにある i18n_user.properties に配置される。ファイルは、メッセージ カタログの i18n_package 値および l10n_package 値に基づいて適切なディレクトリに配置される。デフォルトの対象ディレクトリはカレント ディレクトリとなる。
-n	解析し、有効性を検証するが、クラスは生成しない。
-keepgenerated	生成された Java ソースを維持する。
-ignore	エラーを無視する。
-i18n	インターナショナライズされたメッセージのロギングをサポートするインターナショナライザ ソース (*Logger.java など) を作成する。
-l10n	各メッセージ カタログで定義されている各メッセージにアクセスできるようにするローカライザ ソース (プロパティ リソースのまとまり) を作成する。それらのプロパティは、メッセージをローカライズするためにローカライゼーション ユーティリティによって使用される。
-compile	現在の CLASSPATH を使用して生成された Java ファイルをコンパイルする。生成されたクラスは、-d オプションで識別されるディレクトリに配置される。コンパイルの途中でエラーが検出されると、クラス ファイルやプロパティ ファイルが作成されず、i18ngen は異常な終了ステータスで終了する。
-nobuild	解析と有効性の検証のみを実行する。
files	このファイル リストのファイルとディレクトリを処理する。ディレクトリが指定されている場合は、そのディレクトリのすべての XML ファイルが処理される。すべてのファイルの名前には、XML のサフィックスが付いている必要がある。すべてのファイルは msgcat.dtd 構文に準拠していなければならない。i18ngen は、実際に生成されたファイルに対して、完全修飾名リスト (Java ソース) を stdout ログに出力する。

 

 

---

l10ngen ユーティリティ

l10ngen ユーティリティでは、最上位カタログの下位に位置するディレクトリ内のロケール固有のカタログが処理されます。

構文

java -classpath <l10n_Classpath> weblogic.i18ntools.l10ngen [options] filelist

ここで、<l10n_Classpath> には <WebLogic Home>/lib/weblogic.jar が含まれている必要があります。

注意: ユーティリティはどのディレクトリからでも実行できますが、ファイルがコマンド ラインで指定される場合、ファイル パスはカレント ディレクトリに対する相対パスになります。

オプション

オプション	定義
-d targetdirectory	プロパティを配置するディレクトリ。デフォルトはカレント ディレクトリ。
-language code	言語コード。デフォルト値は all。
-country code	国コード。デフォルト値は all。
-variant code	バリアント コード。デフォルト値は all。
-filelist	処理するメッセージ カタログのディレクトリとファイル。カレント ディレクトリを基準に指定する。ロケール固有のディレクトリではなく最上位のディレクトリを指定する。

 

 

---

CatInfo ユーティリティ

このユーティリティでは、組み込まれているログ メッセージのリストが生成されます。デフォルトの CatInfo では、現在組み込まれているすべてのログ メッセージの ID とメッセージ本文が順番に表示されます。

構文

java weblogic.i18ntools.CatInfo [options]

注意: ユーティリティはどのディレクトリからでも実行できますが、ファイルがコマンド ラインで指定される場合、ファイル パスはカレント ディレクトリに対する相対パスになります。

オプション

注意: すべてのオプションは 1 文字に短縮できます。

オプション	定義
-id nnnnnn	nnnnnn はメッセージ ID を表す。 -id オプションは特定のメッセージを指定するために使用する。
-subsystem identifier	サブシステムの識別子。-subsystem オプションでは指定されたサブシステムに一致するメッセージだけが出力される。
-detail	詳細なリストを要求する。-detail オプションではバージョン、重要度、サブシステム、メッセージの詳細、原因、およびアクションといった情報も要求される。
-help	ヘルプ情報を提供する。

メッセージの詳細リストをファイルにエクスポートする場合は、次のコマンドを使用してください。

java weblogic.i18ntools.CatInfo -detail > Errors.txt