B WebLogic Server 用の Loggable オブジェクトのリファレンス

以下の節では、Loggable オブジェクトのリファレンス情報を提供します。

• Loggable オブジェクトの概要

• Loggable オブジェクトの使用方法

Loggable オブジェクトの概要

デフォルトでは、すべてのログ メッセージ カタログは、メッセージの WebLogic サーバ ログへの書き込みに使用されるメソッドを含む Logger クラスを作成します。Logger クラスには、メッセージをログに記録せずに、Loggable オブジェクトを返すメソッドを任意選択で組み込むことができます。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());//ログに書き込まれたものと同じ
         テキストで新規の例外を送出する
}