nablarch.fw.messaging.logging

クラス MessagingLogFormatter

java.lang.Object

nablarch.fw.messaging.logging.MessagingLogFormatter

@Published(tag="architect")
public class MessagingLogFormatter
extends java.lang.Object

メッセージ送受信処理の中でログ出力を行うクラス。 ログファイルはキュー毎に個別に設定できる。 ログが出力されるタイミングは以下のとおり

 1. 送信処理完了時 (ローカルキューへのPUT完了直後)
 2. 電文受信時
 

出力可能な項目は以下のとおり。

 1. 共通プロトコルヘッダ
   - メッセージID (String)
   - 関連メッセージID (String)
   - 送信宛先キュー論理名 (String)
   - 応答宛先キュー論理名 (String)
   
 2. メッセージボディデータ
   - メッセージボディのバイト長 (int)
   - メッセージボディ
   - メッセージボディのヘキサダンプ
   
   ※メッセージボディに含まれる個人情報や機密情報はマスクして出力することが可能である(マスク用の設定が必要)
   
 3. MOM固有プロトコルヘッダ(以下はJmsMessagingProviderの場合)
     JMSType
     JMSDeliveryMode
     JMSPriority
     JMSTimestamp
     JMSExpiration   
     JMSRedelivered
     JMSXDeliveryCount
     JMSXGroupID
     JMSXGroupSeq
     JMSXProducerTXID
      
 4. そのほか
     - スレッド名
     - メッセージヘッダ
 

ネストされたクラスのサマリー

ネストされたクラス

修飾子とタイプ	クラスと説明
static class	MessagingLogFormatter.CorrelationId 出力項目(関連メッセージID)
static class	MessagingLogFormatter.Destination 出力項目(宛先キュー名)
static class	MessagingLogFormatter.MessageBody 出力項目(メッセージボディ内容) 出力文字列はフォーマッターの文字エンコーディングで出力される。
static class	MessagingLogFormatter.MessageBodyHex 出力項目(メッセージボディ内容) メッセージボディのヘキサダンプを出力する。
static class	MessagingLogFormatter.MessageBodyLength 出力項目(メッセージボディバイト長)
static class	MessagingLogFormatter.MessageHeader 出力項目(メッセージヘッダ) メッセージヘッダの内容を出力する。
static class	MessagingLogFormatter.MessageId 出力項目(メッセージID)
static class	MessagingLogFormatter.MessagingLogContext ログの出力内容を保持するクラス。
static class	MessagingLogFormatter.ReplyTo 出力項目(応答宛先キュー名)
static class	MessagingLogFormatter.ThreadName 出力項目(スレッド名)
static class	MessagingLogFormatter.TimeToLive 出力項目(メッセージ有効期間)

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static java.lang.String	PROPS_PREFIX プロパティ名のプレフィックス

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
MessagingLogFormatter()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
protected LogItem<MessagingLogFormatter.MessagingLogContext>[]	getFormattedLogItems(java.util.Map<java.lang.String,LogItem<MessagingLogFormatter.MessagingLogContext>> logItems, java.util.Map<java.lang.String,java.lang.String> props, java.lang.String formatPropName, java.lang.String defaultFormat) フォーマット済みのログ出力項目を取得する。
java.lang.String	getHttpReceivedMessageLog(ReceivedMessage message, java.nio.charset.Charset charset) 同期送信処理開始時に出力されるログ文字列を生成する。
java.lang.String	getHttpSentMessageLog(SendingMessage message, java.nio.charset.Charset charset) 同期送信処理開始時に出力されるログ文字列を生成する。
protected java.util.Map<java.lang.String,LogItem<MessagingLogFormatter.MessagingLogContext>>	getLogItems() フォーマット対象のログ出力項目を取得する。
java.lang.String	getReceivedMessageLog(ReceivedMessage message) 同期送信処理開始時に出力されるログ文字列を生成する。
java.lang.String	getSentMessageLog(SendingMessage message) 同期送信処理開始時に出力されるログ文字列を生成する。

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

PROPS_PREFIX

public static final java.lang.String PROPS_PREFIX

プロパティ名のプレフィックス

関連項目:

定数フィールド値

コンストラクタの詳細

MessagingLogFormatter

public MessagingLogFormatter()

メソッドの詳細

getSentMessageLog

public java.lang.String getSentMessageLog(SendingMessage message)

同期送信処理開始時に出力されるログ文字列を生成する。

パラメータ:

message - 電文オブジェクト

戻り値:

ログ文字列

getReceivedMessageLog

public java.lang.String getReceivedMessageLog(ReceivedMessage message)

同期送信処理開始時に出力されるログ文字列を生成する。

パラメータ:

message - 電文オブジェクト

戻り値:

ログ文字列

getHttpSentMessageLog

public java.lang.String getHttpSentMessageLog(SendingMessage message,
                                              java.nio.charset.Charset charset)

同期送信処理開始時に出力されるログ文字列を生成する。

パラメータ:

message - 電文オブジェクト

charset - 出力に使用する文字セット

戻り値:

ログ文字列

getHttpReceivedMessageLog

public java.lang.String getHttpReceivedMessageLog(ReceivedMessage message,
                                                  java.nio.charset.Charset charset)

同期送信処理開始時に出力されるログ文字列を生成する。

パラメータ:

message - 電文オブジェクト

charset - 出力に使用する文字セット

戻り値:

ログ文字列

getFormattedLogItems

protected LogItem<MessagingLogFormatter.MessagingLogContext>[] getFormattedLogItems(java.util.Map<java.lang.String,LogItem<MessagingLogFormatter.MessagingLogContext>> logItems,
                                                                                    java.util.Map<java.lang.String,java.lang.String> props,
                                                                                    java.lang.String formatPropName,
                                                                                    java.lang.String defaultFormat)

フォーマット済みのログ出力項目を取得する。

パラメータ:

logItems - フォーマット対象のログ出力項目

props - 各種ログ出力の設定情報

formatPropName - フォーマットのプロパティ名

defaultFormat - デフォルトのフォーマット

戻り値:

フォーマット済みのログ出力項目

getLogItems

protected java.util.Map<java.lang.String,LogItem<MessagingLogFormatter.MessagingLogContext>> getLogItems()

フォーマット対象のログ出力項目を取得する。

戻り値:

フォーマット対象のログ出力項目