1 概要とロードマップ

この章では、このガイドOracle WebLogic ServerにデプロイされたアプリケーションへのWebLogicロギング・サービスの追加の内容と構成について説明します。このガイドでは、WebLogic Serverロギング・サービスを使用してアプリケーション・イベントをモニターする方法について説明します。また、WebLogicによるログ・メッセージの国際化とローカライゼーションのサポートについて説明し、WebLogic Server で提供されているテンプレートおよびツールを使用して、ロケール固有のメッセージ・カタログを作成または編集する方法を示します。

この章には次の項が含まれます:

ドキュメントのスコープと対象読者

このドキュメントは、WebLogicメッセージ・カタログおよびロギング・サービスを、アプリケーションでのログ・メッセージの生成手段として使用し、アプリケーション・ログとWebLogic Serverログとの統合を行うJava Platform、Enterprise Edition (Java EE)アプリケーション開発者を対象としています。このドキュメントの内容は、開発からテストおよび本番まで、ソフトウェア・プロジェクトのすべての段階に関連しています。

このドキュメントでは、ロギングの構成、ログ・メッセージのサブスクライブおよびフィルタ処理については扱いません。これらのトピックに関する情報へのリンクについては、「関連ドキュメント」を参照してください。

Java EE技術、Web技術、オブジェクト指向プログラミング技術、およびJavaプログラミング言語について読者が精通していることを前提としています。

このドキュメントの手引き

このドキュメントの構成は次のとおりです。

概要とロードマップでは、このドキュメントの構成および関連ドキュメントについて説明します。
アプリケーション・ロギングおよびWebLogicロギング・サービスでは、WebLogicロギング・サービスを使用してアプリケーション・イベントをモニターする方法について説明します。
WebLogic Serverの国際化およびローカライゼーションでは、国際化およびローカライゼーションに必要なプロセスの概要を説明します。
WebLogic Serverでのメッセージ・カタログの使い方では、メッセージ・カタログの種類、メッセージ定義、要素、および引数について説明します。
WebLogic Serverログへのメッセージの書込みでは、メッセージ・カタログの作成方法と使用方法、およびNonCatalogLoggerクラスを使用してログ・メッセージの書込みを行う方法を説明します。
WebLogic Serverメッセージ・エディタの使い方では、WebLogic Server付属のメッセージ・エディタの使用方法を説明します。
WebLogic Server国際化ユーティリティの使い方では、WebLogic Server付属の国際化ユーティリティの使用方法を説明します。
「WebLogic Server用のLocalizerクラスのリファレンス」では、Localizerクラス、Localizerメソッド、Localizerのキー値、およびLocalizerのルックアップ・プロパティについて説明します。
WebLogic Server用のLoggableオブジェクトのリファレンスでは、Loggableオブジェクトとその使い方について説明します。
WebLogic Server用のTextFormatterクラスのリファレンスでは、TextFormatterクラスを使用するアプリケーションの例を示します。
「WebLogic Server用のLoggerクラスのリファレンス」では、Loggerクラスについて説明するとともに、メッセージ・カタログおよびそれに対応するLoggerクラスの例を示しています。

ロギングのサンプルとチュートリアル

このドキュメントの他にも、ロギングの構成やAPIの使い方を示す様々なサンプル・ロギング・コードやチュートリアルが用意されています。

Avitek Medical Recordsアプリケーション(MedRec)とチュートリアル

MedRecはWebLogic Serverに付属したエンドツーエンドのサンプルJava EEアプリケーションであり、一元的で独立した医療記録管理システムをシミュレートします。MedRecアプリケーションには、患者、医師、および管理者に対して、様々なクライアントを使用して患者のデータを管理するフレームワークが用意されています。

MedRecはWebLogic ServerとJava EEの機能を例示し、推奨されるベスト・プラクティスを重要点として示します。MedRecは、WebLogic Serverのインストールでオプションでインストールされます。MedRecは、ORACLE_HOME\user_projects\domains\medrecディレクトリから起動できます。ここで、ORACLE_HOMEは、Oracle WebLogic Serverインストール時にOracleホームとして指定したディレクトリです。詳細は、Oracle WebLogic Serverの理解のサンプル・アプリケーションとコード例を参照してください。

WebLogic Server配布キットのロギング・サンプル

WebLogic Serverでは、オプションで、APIコード・サンプルがORACLE_HOME\wlserver\samples\serverにインストールされます(ここで、ORACLE_HOMEは、WebLogic Serverをインストールしたディレクトリ)。詳細は、Oracle WebLogic Serverの理解のサンプル・アプリケーションとコード例を参照してください。

シンプル・メッセージ・カタログのサンプルを使用したアプリケーションの国際化

このサンプルでは、シンプル・メッセージ・カタログを使用してローカライズされたテキストを表示する様々な方法を示します。サンプルでサポートされている言語を使用するには、適切なオペレーティング・システム・ローカライゼーション・ソフトウェアおよび文字エンコーディングが必要です。このサンプルを含むパッケージは次のとおりです。

java examples.i18n.simple.HelloWorld [lang [country]]

langは2文字からなるISO言語コード(たとえば、英語ならen)、countryは2文字からなるISO国コード(たとえば、米国ならUS)を示します。

ファイルは、ORACLE_HOME\wlserver\samples\server\examples\src\examples\i18n\simpleに置かれます(ここで、ORACLE_HOMEは、WebLogic Serverをインストールしたディレクトリ)。詳細は、Oracle WebLogic Serverの理解のサンプル・アプリケーションとコード例を参照してください。

このリリースでの新機能と変更された機能

このリリースで導入されたWebLogic Serverの新機能の一覧については、『Oracle WebLogic Serverの新機能』 12.2.1.3.0を参照してください。