スタンドアロン JRas 操作のセットアップ

トレース・データおよびロギング・メッセージをユーザー定義ロケーションにのみ出力するように、JRas 操作を構成できます。

始める前に

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

このタスクについて

スタンドアロン・モードでは、メッセージおよびトレースは、 ユーザー定義のログにのみ記録されます。以下の例では次のことを前提としています。
  • ユーザー定義のハンドラー SimpleFileHandler と、 ユーザー定義のフォーマッター SimpleFormatter があります。
  • ユーザー定義タイプのイベントを使用していません。

手順

  1. 必要な JRas 拡張クラスをインポートします。
    import com.ibm.ras.*; 
    import com.ibm.websphere.ras.*; 
  2. ユーザー・ハンドラーおよびフォーマッターをインポートします。
    import com.ibm.ws.ras.test.user.*; 
  3. ロガー参照を宣言します。
    private RASMessageLogger msgLogger = null; 
    private RASTraceLogger trcLogger = null;
  4. マネージャー・クラスへの参照を取得し、ロガーを作成して、ユーザー・ハンドラーを追加します。 ロガーは名前付きシングルトンなので、さまざまな場所でロガーへの参照を取得することができます。 エンタープライズ Bean のロジック候補の 1 つが ejbCreate メソッドです。 同じユーザー・ハンドラーの複数のインスタンスが偶然同じロガーに挿入されることのないようにしてください。 初期化コードはこの方法をサポートする必要があります。次の例は、メッセージ・ロガーのサンプルです。 トレース・ロガーの手順もこれと同様です。
    com.ibm.websphere.ras.Manager mgr = com.ibm.websphere.ras.Manager.getManager();
    msgLogger = mgr.createRASMessageLogger("Acme", "WidgetCounter", "RasTest",
                 myTestBean.class.getName()); 
    // Configure the message logger to use the message file that is defined in
    // the ResourceBundle sample. 
    msgLogger.setMessageFile("acme.widgets.DefaultMessages");
    
    // Get a reference to the Handler and remove it from the logger. 
    RASIHandler aHandler = null; 
    Enumeration enum = msgLogger.getHandlers(); 
    while (enum.hasMoreElements()) {
           aHandler = (RASIHandler)enum.nextElement(); 
           if (aHandler instanceof WsHandler) 
                msgLogger.removeHandler(wsHandler); 
    } 
    
    // Create the user handler and formatter. Configure the formatter, 
    // then add it to the handler. 
    RASIHandler handler = new SimpleFileHandler("myHandler", "FileName");
    RASIFormatter formatter = new SimpleFormatter("simple formatter");
    formatter.addEventClass("com.ibm.ras.RASMessageEvent");
    handler.addFormatter(formatter);
    
    // Add the Handler to the logger. Add the logger to the list of the 
    // handlers listeners, then set the handlers 
    // mask, which will update the loggers composite mask appropriately.
    // WARNING - there is an order dependency here that must be followed.
    msgLogger.addHandler(handler);
    handler.addMaskChangeListener(msgLogger);
    handler.setMessageMask(RASIMessageEvent.DEFAULT_MESSAGE_MASK);

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_jrasalone
ファイル名:ttrb_jrasalone.html