インターナショナライゼーションガイド

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

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

Loggable オブジェクトの概要

デフォルトでは、すべてのログメッセージカタログは、メッセージの WebLogic Server ログへの書き込みに使用されるメソッドを含む Logger クラスを作成します。Logger クラスには、メッセージをログに記録せずに、Loggable オブジェクトを返すメソッドを必要に応じて組み込むことができます。Loggable オブジェクトは、ログメッセージを生成するが、実際のログへの書き込みは後から行いたい場合に便利です。また、例外送出など、他の目的にメッセージテキストを使用する場合にも使用できます。

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

Loggable オブジェクトを返すメソッドを持つ Logger クラスを作成するには、メッセージカタログに loggables 属性を設定する必要があります。

たとえば、コードリスト B-1 に示すカタログを考えます。

コードリスト B-1 test.xml メッセージカタログ

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE message_catalog PUBLIC "weblogic-message-catalog-dtd" "http://www.bea.com/servers/wls810/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());//ログに書き込まれたものと同じ
 	テキストで新規の例外を送出する
}