Oracle® Fusion Middleware Oracle WebLogic Server アプリケーション ロギングのロギング サービス ユーザーズ ガイド 11g リリース 1 (10.3.1) B55513-01 |
|
戻る |
次へ |
以下の節では、Loggable オブジェクトのリファレンス情報を提供します。
デフォルトでは、すべてのログ メッセージ カタログは、メッセージの WebLogic サーバ ログへの書き込みに使用されるメソッドを含む Logger
クラスを作成します。Logger
クラスには、メッセージをログに記録せずに、Loggable オブジェクトを返すメソッドを任意選択で組み込むことができます。Loggable オブジェクトは、ログ メッセージを生成するが、実際のログへの書き込みは後から行う場合に便利です。また、例外送出など、他の目的にメッセージ テキストを使用する場合にも使用できます。
Loggable オブジェクトを返すメソッドを持つ Logger
クラスを作成するには、メッセージ カタログに loggables
属性を設定する必要があります。
コード リスト B-1 に示す test.xml
カタログを参照してください。
コード リスト B-1 test.xml メッセージ カタログ
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE message_catalog PUBLIC "weblogic-message-catalog-dtd" "http://www.bea.com/servers/wls90/dtd/msgcat.dtd"> <message_catalog subsystem="Examples" version="1.0" baseid="500000" endid="500001" loggables="true" > <logmessage messageid="500000" severity="error" method="logIOError(Throwable t)" > <messagebody> IO failure detected. </messagebody> <messagedetail> </messagedetail> <cause> </cause> <action> </action> </logmessage> </message_catalog>
このカタログを weblogic.i18ngen
ユーティリティで実行すると、このカタログに対して次の 2 つのメソッドを持つ Logger
クラスが作成されます。
logIOError (throwable)
- メッセージをログに記録する
logIOErrorLoggable (throwable)
- Loggable オブジェクトを返す
Loggable オブジェクトの使用例は、コード リスト B-2 に示しています。
コード リスト B-2 Loggable オブジェクトの使用例
package test; import weblogic.logging.Loggable; import weblogic.i18n.testLogger; ... try { // 何らかの入出力 } catch (IOException ioe) { Loggable l = testLogger.logIOErrorLoggable(ioe); l.log(); // エラーをログに記録する throw new Exception(l.getMessage());//ログに書き込まれたものと同じ テキストで新規の例外を送出する }