1 概要とロードマップ

この節では、このマニュアル『アプリケーションロギングの Oracle 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 付属のインターナショナライゼーションユーティリティの使い方を説明します。
「A WebLogic Server 用の Localizer クラスのリファレンス」では、Localizer クラス、Localizer メソッド、Localizer のキー値、および Localizer のルックアッププロパティについて説明します。
「B WebLogic Server 用の Loggable オブジェクトのリファレンス」では、Loggable オブジェクトとその使い方について説明します。
「C WebLogic Server 用の TextFormatter クラスのリファレンス」では、TextFormatter クラスを使用するアプリケーションの例を示します。
「D WebLogic Server 用の Logger クラスのリファレンス」では、Logger クラスについて説明すると共に、メッセージカタログおよびそれに対応する Logger クラスの例を示します。

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

このドキュメントの他にも、ロギングのコンフィグレーションや API の使い方を示すさまざまなサンプルロギングコードやチュートリアルが用意されています。

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

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

MedRec は WebLogic Server と Java EE の機能を例示し、推奨されるベストプラクティスを重要点として示します。MedRec は WebLogic Server 配布キットに含まれており、Windows マシンの [スタート] メニューからアクセスできます。Linux などのプラットフォームでは、WL_HOME\samples\domains\medrec ディレクトリから MedRec を起動します。WL_HOME は、WebLogic Server の最上位のインストールディレクトリです。

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

WebLogic Server 9.0 では、必要に応じて API サンプルコードを WL_HOME\samples\server\examples\src\examples にインストールできます。WL_HOME は WebLogic Server の最上位のインストールディレクトリを示します。WebLogic Server のスタートメニューからサンプルサーバを起動して、サンプルとその実行手順に関する情報を確認することができます。

シンプルメッセージカタログのサンプルを使用したアプリケーションのインターナショナライゼーション

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

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

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

ファイルは、WL_HOME\samples\server\examples\src\examples\i18n\simple に置かれています。WL_HOME は WebLogic Server インストール先の最上位ディレクトリを示します。デフォルトのパスは c:\Oracle\Middleware\wlserver_10.3 です。ただし、このディレクトリを Oracle Middleware ホームディレクトリ MW_HOME にインストールする必要はありません。

このリリースでの新機能と変更点

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