WebSphere Application Server for z/OS, Version 6.1   
             オペレーティング・システム: z/OS

             目次と検索結果のパーソナライズ化

ログ・リソース・バンドルおよびメッセージ・ファイルの作成

WebSphere Application Server の内部ログに書き込まれるメッセージは、他の表示用プロセスに転送することができます。 管理コンソールがサーバー・プロセスとは別の場所で 稼働している可能性があるので、管理コンソールに 表示されるメッセージを、実行時バインディング・プロセスを使用して ローカライズすることができます。実行時バインディングとは、WebSphere Application Server がログへの記録時にメッセージをローカライズするのではなく、メッセージを表示するプロセスまでローカライズを遅らせることです。

このタスクについて

メッセージを受け入れるメソッドはすべて、これらのメッセージをローカライズします。 ローカライズされるメッセージを提供するためのメカニズムが、 IBM Developer Kit, Java Technology Edition が提供するリソース・バンドル・サポートです。 Developer Kit がインプリメントするリソース・バンドルについて知識がない場合は、 各種のテキストから、あるいは java.util.ResourceBundle、java.util.ListResourceBundle、java.util.PropertyResourceBundle、および java.text.MessageFormat の各クラスの API ドキュメンテーションを参照して、詳細な情報を得ることができます。

PropertyResourceBundle クラスは、優先的に使用されるメカニズムです。

メッセージを正しくローカライズするには、表示プロセスに、メッセージ・テキストが保管されるリソース・バンドルに対するアクセス権がなければなりません。 リソース・バンドルはアプリケーションとは別にパッケージ化し、表示プロセスがアクセスできる場所にインストールする必要があります。

デフォルトでは、WebSphere Application Server ランタイムは、ログに記録されるときに、 すべてのメッセージをローカライズします。 このローカライズにより、異なるロケーションでローカライズする必要がない限り、 .jar ファイルをアプリケーションに渡す必要がなくなります。 ただし、早期バインディング手法を使用すると、メッセージがログに記録されるときにローカライズすることができます。 早期バインディングを使用するアプリケーションは、 メッセージをログに記録する前に、まずローカライズする必要があります。 アプリケーションは、リソース・バンドル内でローカライズしたテキストを検索し、メッセージをフォーマットします。 早期バインディング手法を使用して、 アプリケーションとともにそのリソース・バンドルをパッケージしてください。

リソース・バンドルを作成するには、以下のステップを実行します。

プロシージャー

  1. メッセージ・キーとそれに対応するメッセージをリストしたテキスト・プロパティー・ファイルを作成します。 プロパティー・ファイルは、次のような特性を持つものでなければなりません。
    • ファイル内の個々のプロパティーの末尾が行終了文字になっています。
    • 空白文字スペースだけ、または最初の非空白文字がポンド記号 (#) または感嘆符 (!) である行は、 無視されます。 したがって、# および ! は、 ファイルにコメントを入れる場合に使用されます。
    • ファイル内の各行は、コメントでない限り、あるいは空白文字だけで構成されているものでない限り、1 つのプロパティーを表します。円記号 (¥) は、行継続文字として扱われます。
    • プロパティー・ファイルの構文は、キーと分離文字、およびエレメントで構成されます。 有効な分離文字は、等号 (=)、コロン (:)、および空白スペース ( ) です。
    • キーは、行の最初の非空白文字から最初の分離文字までのすべての文字で構成されます。 分離文字は、円記号 (¥) でエスケープすることによって キーに組み込むことができますが、これはお勧めしません。エスケープ文字はエラーを起こしやすく、混乱の元になるためです。 代わりに、そのプロパティー・ファイル内のキーで表示されていない有効な分離文字を使用することをお勧めします。
    • キーおよび分離文字の後の空白は、最初の非空白文字が出てくるまで無視されます。 行終了文字の前にある文字はすべて、エレメントを定義します。

    プロパティー・ファイルの構文と構造の詳細は、java.util.Properties クラスの Java 資料を参照してください。

  2. ファイルをその言語固有のファイル名を持つローカライズ・バージョンに変換します。 例えば、DefaultMessages.properties という名前のファイルは、ドイツ語の場合は DefaultMessages_de.properties に、日本語の場合は DefaultMessages_ja.properties に変換できます。
  3. 変換したリソース・バンドルが使用可能になっている場合は、そのバンドルを、 アプリケーションのクラスパスの一部であるディレクトリーに置きます。
  4. メッセージ・ロガーをログ・マネージャーから取得する場合は、それを、特定のリソース・バンドルを使用するように構成します。 ロガー API によってログに記録されるメッセージは、 メッセージのローカライズが実行されると、このリソース・バンドルを使用します。 実行時には、ユーザーのロケール設定によって、メッセージ・キーで指定するメッセージを抽出するプロパティー・ファイルが決定され、それによってメッセージが正しい言語で配信されていることが確認されます。
  5. メッセージ・ロガーの msg メソッドが呼び出される場合は、リソース・バンドル名を明示的に提供する必要があります。

次の作業

アプリケーションは、クラスパス内の任意のディレクトリーに相対するファイルのロケーションに基づいて、リソース・バンドルを配置します。 例えば、DefaultMessages.properties というプロパティー・リソース・バンドルが、 baseDir/subDir1/subDir2/resources ディレクトリーにあり、 baseDir がクラスパスにある場合、そのリソース・バンドルの識別のためにメッセージ・ロガーに渡される名前は subdir1.subdir2.resources.DefaultMessage となります。



サブトピック
例: プロパティー・ファイルの作成によるリソース・バンドルのロギング
タスク・トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 9:12:22 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/ttrb_logresourcebun.html