![]() ![]() ![]() ![]() |
以下の節では、Loggable オブジェクトのリファレンス情報を提供します。
デフォルトでは、すべてのログ メッセージ カタログは、メッセージの WebLogic サーバ ログへの書き込みに使用されるメソッドを含む Logger
クラスを作成します。Logger
クラスには、メッセージをログに記録せずに、Loggable オブジェクトを返すメソッドを任意選択で組み込むことができます。Loggable オブジェクトは、ログ メッセージを生成するが、実際のログへの書き込みは後から行う場合に便利です。また、例外送出など、他の目的にメッセージ テキストを使用する場合にも使用できます。
Loggable オブジェクトを返すメソッドを持つ Logger
クラスを作成するには、メッセージ カタログに loggables
属性を設定する必要があります。
たとえば、コード リスト B-1 に示すカタログを考えます。
<?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
クラスが作成されます。
Loggable オブジェクトの使用例は、コード リスト B-2 に示しています。
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());//ログに書き込まれたものと同じ
テキストで新規の例外を送出する
}
![]() ![]() ![]() |