WebSphere Application Server for i5/OS, Version 6.1   
             オペレーティング・システム: i5/OS

             目次と検索結果のパーソナライズ化

JRas マネージャーとロガー・インスタンス

統合モード、スタンドアロン・モード、 または結合モードで JRas 拡張を使用することができます。 アプリケーションの構成は操作モードによって異なりますが、 メッセージまたはトレース項目を記録するためのロガーの使用法は、 どの操作モードでも同じです。

非推奨: このタスクおよびそのサブタスクで説明する JRas フレームワークは、推奨されません。 しかし、Java ロギングを使用して、同様の結果を得ることができます。

統合モードは、デフォルトの操作モードです。このモードでは、メッセージ・イベントおよびトレース・イベントは WebSphere Application Server のログに送信されます。

結合モードでは、メッセージ・イベントおよびトレース・イベントは、 WebSphere Application Server のログとユーザー定義ログの両方に記録されます。

スタンドアロン・モードでは、メッセージ・イベントおよびトレース・イベントは、 ユーザー定義のログにのみ記録されます。

メッセージ・ロガーおよびトレース・ロガーの使用

操作モードに関係なく、メッセージ・ロガーとトレース・ロガーの使い方は同じです。

メッセージ・ロガーの使用

メッセージ・ロガーは、DefaultMessages リソース・バンドルを使用する ように構成されています。メッセージ・ロガーがメッセージ API を使用する場合は、メッセージ・キーをロガーに渡す必要があります。
msgLogger.message(RASIMessageEvent.TYPE_WARNING, this, methodName, "MSG_KEY_00");
... msgLogger.message(RASIMessageEvent.TYPE_WARN, this, methodName, "MSG_KEY_01", "some string");
メッセージ・ロガーが msg API を使用する場合は、新規のリソース・バンドル名を指定することができます。
msgLogger.msg(RASIMessageEvent.TYPE_ERR, this, methodName, 
                  "ALT_MSG_KEY_00", "alternateMessageFile");
テキスト・メッセージをログに記録することもできます。textMessage API を使用する場合は、メッセージのフォーマット設定は実行されません。
msgLogger.textMessage(RASIMessageEvent.TYPE_INFO, this, methodName, "String and Integer", "A String", new Integer(5)); 

トレース・ロガーの使用

トレースは通常は使用不可になっているので、パフォーマンス上の理由でトレース・メソッドを保護します。
private void methodX(int x, String y, Foo z)
{ 
   // trace an entry point. Use the guard to make sure tracing is enabled. Do this checking before you gather parameters to  trace.
   if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT) {
         // I want to trace three parameters, package them up in an Object[]
        Object[] parms = {new Integer(x), y, z};
        trcLogger.entry(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX", parms);
  } 
... logic
  // a debug or verbose trace point
  if (trcLogger.isLoggable(RASITraceEvent.TYPE_MISC_DATA) {
        trcLogger.trace(RASITraceEvent.TYPE_MISC_DATA, this, "methodX" "reached here");
  } 
  ... 
  // Another classification of trace event. An important state change is
 detected, so a different trace type is used. 
if (trcLogger.isLoggable(RASITraceEvent.TYPE_SVC) {
     trcLogger.trace(RASITraceEvent.TYPE_SVC, this, "methodX", "an important event");
  } 
 ... 
  // ready to exit method, trace. No return value to trace
    if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT)) {
        trcLogger.exit(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX"); 
   } 
} 



関連タスク
統合 JRas 操作のセットアップ
結合 JRas 操作のセットアップ
スタンドアロン JRas 操作のセットアップ
JRas リソース・バンドルとメッセージ・ファイルの作成
概念トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 5:46:14 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.base.iseries.doc/info/iseries/ae/ctrb_jrasmkmgrs.html