nablarch.core.log.app

Class FailureLogFormatter

java.lang.Object

nablarch.core.log.app.FailureLogFormatter

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

障害通知ログと障害解析ログのメッセージをフォーマットするクラス。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FailureLogFormatter.ContactItem 連絡先を取得するクラス。
static class	FailureLogFormatter.DataItem 処理対象データを取得するクラス。
static class	FailureLogFormatter.FailureCodeItem 障害コードを取得するクラス。
static class	FailureLogFormatter.FailureLogContext 障害通知ログと障害解析ログの出力項目を保持するクラス。
static class	FailureLogFormatter.MessageItem メッセージを取得するクラス。

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROPS_PREFIX プロパティ名のプレフィックス

Constructor Summary

Constructors

Constructor and Description
FailureLogFormatter() フォーマット済みのログ出力項目を初期化する。

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	format(LogItem<FailureLogFormatter.FailureLogContext>[] formattedLogItems, java.lang.Throwable error, java.lang.Object data, java.lang.String failureCode, java.lang.Object[] messageOptions) 指定されたフォーマット済みのログ出力項目を使用してメッセージをフォーマットする。
java.lang.String	formatAnalysisMessage(java.lang.Throwable error, java.lang.Object data, java.lang.String failureCode, java.lang.Object[] messageOptions) 障害解析ログのメッセージをフォーマットする。
java.lang.String	formatNotificationMessage(java.lang.Throwable error, java.lang.Object data, java.lang.String failureCode, java.lang.Object[] messageOptions) 障害通知ログのメッセージをフォーマットする。
protected java.lang.String	getAnalysisFormat(java.util.Map<java.lang.String,java.lang.String> props) 障害解析ログのフォーマットを取得する。
protected java.util.Map<java.lang.String,java.lang.String>	getAppFailureCodes(java.util.Map<java.lang.String,java.lang.String> props) アプリケーション用の障害コード変換情報を取得する。
protected java.lang.String	getDefaultFailureCode(java.util.Map<java.lang.String,java.lang.String> props) デフォルトの障害コードを取得する。
protected java.lang.String	getDefaultMessage(java.util.Map<java.lang.String,java.lang.String> props) デフォルトのメッセージを取得する。
protected java.lang.String	getFailureCode(java.lang.String failureCode, java.lang.Throwable error) ログ出力に使用する障害コードを取得する。
protected java.lang.String	getFrameworkFailureCode(java.lang.Throwable error) フレームワーク用の障害コード変換情報から障害コードを取得する。
protected java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>>	getFwFailureCodes(java.util.Map<java.lang.String,java.lang.String> props) フレームワーク用の障害コード変換情報を取得する。 プロパティファイルのキー名の長さで降順にソートして返す。
protected java.util.Map<java.lang.String,LogItem<FailureLogFormatter.FailureLogContext>>	getLogItems(java.util.Map<java.lang.String,java.lang.String> props) フォーマット対象のログ出力項目を取得する。 デフォルトで下記のプレースホルダを設定したログ出力項目を返す。
protected java.lang.String	getMessage(java.lang.String failureCode, java.lang.Object[] options, java.lang.Throwable error) 障害コードからメッセージを取得する。
protected java.lang.String	getNotificationFormat(java.util.Map<java.lang.String,java.lang.String> props) 障害通知ログのフォーマットを取得する。
protected java.util.Map<java.lang.String,java.lang.String>	getProps(java.util.Map<java.lang.String,java.lang.String> props, java.lang.String key, java.lang.String defaultFilePath) プロパティを取得する。
protected java.lang.StackTraceElement	getRootExceptionPoint(java.lang.Throwable error) スタックトレースからルート要素を取得する。

Methods inherited from class java.lang.Object

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

Field Detail

PROPS_PREFIX

public static final java.lang.String PROPS_PREFIX

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

See Also:

Constant Field Values

Constructor Detail

FailureLogFormatter

public FailureLogFormatter()

フォーマット済みのログ出力項目を初期化する。

Method Detail

getAppFailureCodes

protected java.util.Map<java.lang.String,java.lang.String> getAppFailureCodes(java.util.Map<java.lang.String,java.lang.String> props)

アプリケーション用の障害コード変換情報を取得する。

Parameters:

props - 各種ログの設定情報

Returns:

アプリケーション用の障害コード変換情報

getFwFailureCodes

protected java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> getFwFailureCodes(java.util.Map<java.lang.String,java.lang.String> props)

フレームワーク用の障害コード変換情報を取得する。 プロパティファイルのキー名の長さで降順にソートして返す。

Parameters:

props - 各種ログの設定情報

Returns:

フレームワーク用の障害コード変換情報

getDefaultFailureCode

protected java.lang.String getDefaultFailureCode(java.util.Map<java.lang.String,java.lang.String> props)

デフォルトの障害コードを取得する。

Parameters:

props - 各種ログの設定情報

Returns:

デフォルトの障害コード

getDefaultMessage

protected java.lang.String getDefaultMessage(java.util.Map<java.lang.String,java.lang.String> props)

デフォルトのメッセージを取得する。

Parameters:

props - 各種ログの設定情報

Returns:

デフォルトのメッセージ

getNotificationFormat

protected java.lang.String getNotificationFormat(java.util.Map<java.lang.String,java.lang.String> props)

障害通知ログのフォーマットを取得する。

Parameters:

props - 各種ログの設定情報

Returns:

障害通知ログのフォーマット

getAnalysisFormat

protected java.lang.String getAnalysisFormat(java.util.Map<java.lang.String,java.lang.String> props)

障害解析ログのフォーマットを取得する。

Parameters:

props - 各種ログの設定情報

Returns:

障害解析ログのフォーマット

getProps

protected java.util.Map<java.lang.String,java.lang.String> getProps(java.util.Map<java.lang.String,java.lang.String> props,
                                                                    java.lang.String key,
                                                                    java.lang.String defaultFilePath)

プロパティを取得する。

Parameters:

props - 各種ログの設定情報

key - プロパティのファイルパスを各種ログの設定情報から取得する際に使用するキー

defaultFilePath - デフォルトのファイルパス

Returns:

プロパティ

getLogItems

protected java.util.Map<java.lang.String,LogItem<FailureLogFormatter.FailureLogContext>> getLogItems(java.util.Map<java.lang.String,java.lang.String> props)

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

デフォルトで下記のプレースホルダを設定したログ出力項目を返す。

   $failureCode$: 障害コード
   $messageId$: 障害コード(旧メッセージID。下位互換性のため)
   $message$: メッセージ
   $data$: 処理対象データ
   $contact$: 連絡先
 

Parameters:

props - 各種ログの設定情報

Returns:

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

formatNotificationMessage

public java.lang.String formatNotificationMessage(java.lang.Throwable error,
                                                  java.lang.Object data,
                                                  java.lang.String failureCode,
                                                  java.lang.Object[] messageOptions)

障害通知ログのメッセージをフォーマットする。

 フォーマット対象の出力項目を下記に示す。
 障害コード
 障害コードから取得したメッセージ
 派生元実行時ID
 

Parameters:

error - エラー情報

data - 処理対象データ

failureCode - 障害コード

messageOptions - 障害コードからメッセージを取得する際に使用するオプション情報

Returns:

フォーマット済みのメッセージ

formatAnalysisMessage

public java.lang.String formatAnalysisMessage(java.lang.Throwable error,
                                              java.lang.Object data,
                                              java.lang.String failureCode,
                                              java.lang.Object[] messageOptions)

障害解析ログのメッセージをフォーマットする。

 フォーマット対象の出力項目を下記に示す。
 障害コード
 障害コードから取得したメッセージ
 派生元実行時ID
 

Parameters:

error - エラー情報

data - 処理対象データ

failureCode - 障害コード

messageOptions - 障害コードからメッセージを取得する際に使用するオプション情報

Returns:

フォーマット済みのメッセージ

format

protected java.lang.String format(LogItem<FailureLogFormatter.FailureLogContext>[] formattedLogItems,
                                  java.lang.Throwable error,
                                  java.lang.Object data,
                                  java.lang.String failureCode,
                                  java.lang.Object[] messageOptions)

指定されたフォーマット済みのログ出力項目を使用してメッセージをフォーマットする。

 フォーマット対象の出力項目を下記に示す。
 障害コード
 障害コードから取得したメッセージ
 派生元実行時ID
 

Parameters:

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

error - エラー情報

data - 処理対象データ

failureCode - 障害コード

messageOptions - 障害コードからメッセージを取得する際に使用するオプション情報

Returns:

フォーマット後のメッセージ

getMessage

protected java.lang.String getMessage(java.lang.String failureCode,
                                      java.lang.Object[] options,
                                      java.lang.Throwable error)

障害コードからメッセージを取得する。

 障害コードがデフォルトの障害コードの場合は、デフォルトのメッセージを返す。
 デフォルトのメッセージが指定されていない場合はブランクとなる。
 
 メッセージ取得では、指定されたメッセージの言語を使用する。
 メッセージの言語が指定されていない場合は、ThreadContext.getLanguage()を使用する。
 
 メッセージ取得で例外が発生した場合は、下記の固定メッセージを返す。
 
 "failed to get the message to output the failure log. failureCode = [障害コード]"
 

Parameters:

failureCode - 障害コード

options - 障害コードからメッセージを取得する際に使用するオプション情報

error - エラー情報

Returns:

メッセージ

See Also:

MessageUtil.createMessage(MessageLevel, String, Object...)

getFailureCode

protected java.lang.String getFailureCode(java.lang.String failureCode,
                                          java.lang.Throwable error)

ログ出力に使用する障害コードを取得する。

Parameters:

failureCode - 出力依頼時に指定された障害コード

error - エラー情報

Returns:

ログ出力に使用する障害コード

getFrameworkFailureCode

protected java.lang.String getFrameworkFailureCode(java.lang.Throwable error)

フレームワーク用の障害コード変換情報から障害コードを取得する。

 下記の場合はデフォルトの障害コードを返す。
 ・エラー情報のスタックトレースのルート要素がフレームワークでない場合
 ・フレームワーク用の障害コード変換情報から障害コードを取得できない場合
 

Parameters:

error - エラー情報

Returns:

フレームワーク用の障害コード

getRootExceptionPoint

protected java.lang.StackTraceElement getRootExceptionPoint(java.lang.Throwable error)

スタックトレースからルート要素を取得する。

Parameters:

error - エラー情報

Returns:

スタックトレースのルート要素。スタックトレースがない場合はnull