Oracle® Fusion Middleware Oracle WebLogic ServerにデプロイされたアプリケーションへのWebLogicロギング・サービスの追加 12c (12.2.1.3.0) E90338-01 |
|
前 |
次 |
Oracleでは、World Wide Web Consortium (W3C)推奨による、世界中のすべての言語および記述システムで使用できる標準フォーマットおよびプロトコルを採用しています。これらの規格は、WebLogic Serverで使用されているJava国際化APIに組み込まれています。
国際化(I18N)とは、簡単かつ高い費用対効果で、またとりわけ、エンジニアリング上の変更を加えることなく、様々な言語および地域に適合させられるよう、ソフトウェアを設計するプロセスを言います。ローカリゼーション(L10N)とは、実行時にロケール固有の言語および構成を使用することです。
ログ・メッセージ - サーバー・ログに書き込まれる通知メッセージ。適切なメッセージ引数がメッセージの定義で指定されている場合はエラー・メッセージも含まれます。「ログ・メッセージ・カタログの要素」を参照してください。
シンプル・テキスト: サーバーで表示する必要があるログ・メッセージや例外以外のテキスト(ユーティリティからの出力など)。シンプル・テキストの例としてはヘルプ・メッセージ、グラフィカル・ユーザー・インタフェース(Graphical User Interface: GUI)ラベル、エラー・メッセージなどがあります。「シンプル・テキスト・カタログの要素」を参照してください。
国際化するテキストはすべてメッセージ・カタログで定義します。各メッセージ・カタログでは、ログ・メッセージまたはシンプル・テキストのコレクションが定義されます。
ログ・メッセージには、ログ・ファイルに書き込まれるデータが含まれています。データは非常に動的で、アプリケーションやシステムの現在の状態に特定の情報が含まれています。ローカライズされたログ・メッセージ・カタログのテキストと結合すれば、このデータはユーザーの言語でエラー状態を説明する、適切にフォーマットされたローカライズ済みのメッセージになります。WebLogic Server管理コンソールに送信される出力は、シンプル・テキストです。ログ・メッセージと同様、シンプル・テキストも動的データと結合して使用できます。
国際化されたメッセージを作成するには、コードの変更や再コンパイルをせずに、様々なロケールに文字列を変換できるように、すべてのメッセージ文字列をメッセージ・カタログに外部化する必要があります。アプリケーション・コードは、ロギング・メソッドの実行時値を提供します。ロギング・メソッドは、現在のロケールに従ってコードとカタログ内のメッセージ文字列を結合します。次に、ローカライズされたメッセージをアプリケーション・コードがログ・ファイルに出力します。
メッセージ・カタログには、次の3つのタイプがあります。
ログ・メッセージ・カタログ: ログ・メッセージのコレクション。「ログ・メッセージ・カタログの要素」を参照してください。
シンプル・テキスト・メッセージ・カタログ: シンプル・テキスト・メッセージのコレクション。「シンプル・テキスト・カタログの要素」を参照してください。
ロケール・メッセージ・カタログ: 最上位のログ・メッセージまたはシンプル・テキスト・メッセージに対応するロケール固有のメッセージのコレクション。「ロケール固有のカタログの要素」を参照してください。
ログ・メッセージまたはロケール・メッセージ・カタログのメッセージIDは、すべてのログ・メッセージまたはロケール・メッセージ・カタログで一意です。メッセージ・カタログ・ファイル内で、各メッセージのローカライズされたバージョンには、エラーを特定する一意のメッセージIDとメッセージ・テキストが割り当てられます。原則的に、メッセージは、サポート担当者が簡単に見つけられるように、システム内の1つの場所からログに記録します。シンプル・テキスト・カタログのメッセージIDは、各シンプル・テキスト・カタログ内で一意です。「WebLogic Serverでのメッセージ・カタログの使用方法」を参照してください。
WebLogic Serverのメッセージ・カタログを確認するには、エラー・メッセージを参照してください。
WebLogic Serverでは、国際化およびローカライゼーションにJava国際化インタフェースを使用しています。
ユーザーは、WebLogic Serverで国際化をどのように処理するかを理解するだけでなく、このJava国際化インタフェースおよびJava Development Kit (JDK)に組み込まれている以下のクラスに関する知識も必要です。
クラス | 説明 |
---|---|
java.util.Locale |
地理的、政治的、または文化的に区別される特定の地域を表します。 |
java.util.ResourceBundle |
ロケール固有のオブジェクトが格納されるコンテナを提供します。 |
java.text.MessageFormat |
言語に依存しない方法で連結されたメッセージを生成します。 |
WebLogic Serverログへのメッセージの書込みを参照してください。