nablarch.fw.results

Class ServiceError

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

nablarch.fw.Result.Error

nablarch.fw.results.ServiceError

All Implemented Interfaces:

Serializable, nablarch.fw.Result

Direct Known Subclasses:

InternalError, ServiceUnavailable

@Published(tag="architect")
public abstract class ServiceError
extends nablarch.fw.Result.Error

サービス側で生じた問題により処理が継続できないことを示す例外。

問題解決には、サービス側での対処が必要となるため、エラーメッセージの内容として、 呼び出し側が問題が発生したことをサービス管理者に連絡する方法と、 管理者に伝えるべき内容を含める必要がある。 また、メッセージIDを設定することにより、 運用ログへの出力に関する制御を行うことができる。

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface nablarch.fw.Result

nablarch.fw.Result.ClientError, nablarch.fw.Result.Error, nablarch.fw.Result.MultiStatus, nablarch.fw.Result.NotFound, nablarch.fw.Result.Success

Constructor Summary

Constructors

Constructor and Description
ServiceError() デフォルトコンストラクタ
ServiceError(nablarch.core.log.basic.LogLevel logLevel, String messageId, Object... messageParams) 運用ログへの出力に関する制御情報を含む例外を生成する。
ServiceError(nablarch.core.log.basic.LogLevel logLevel, Throwable cause, String messageId, Object... messageParams) 運用ログへの出力に関する制御情報を含む例外を生成する。
ServiceError(String message) コンストラクタ
ServiceError(String message, Throwable cause) コンストラクタ
ServiceError(Throwable cause) コンストラクタ

Method Summary

Modifier and Type	Method and Description
String	getMessage() このインスタンスにメッセージIDが指定されている場合は、 そのIDに対応したメッセージ内容を返す。
String	getMessageId() メッセージIDを返す。
Object[]	getMessageParams() メッセージパラメータを返す。
int	getStatusCode()
void	writeLog(nablarch.fw.ExecutionContext context) この障害の内容について運用ログに出力する。 ログレベルがエラーレベル以上の場合に、障害内容を運用ログに出力する。 ワーニングレベル以下の場合は何もしない。

Methods inherited from class nablarch.fw.Result.Error

isSuccess, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceError

public ServiceError()

デフォルトコンストラクタ

ServiceError

public ServiceError(String message)

コンストラクタ

Parameters:

message - エラーメッセージ

ServiceError

public ServiceError(Throwable cause)

コンストラクタ

Parameters:

cause - 起因となる例外

ServiceError

public ServiceError(String message,
                    Throwable cause)

コンストラクタ

Parameters:

message - エラーメッセージ

cause - 起因となる例外

ServiceError

public ServiceError(nablarch.core.log.basic.LogLevel logLevel,
                    String messageId,
                    Object... messageParams)

運用ログへの出力に関する制御情報を含む例外を生成する。

Parameters:

logLevel - ログ出力レベル

messageId - ログ内容のメッセージID

messageParams - ログメッセージの埋め込みパラメータ

ServiceError

public ServiceError(nablarch.core.log.basic.LogLevel logLevel,
                    Throwable cause,
                    String messageId,
                    Object... messageParams)

運用ログへの出力に関する制御情報を含む例外を生成する。

Parameters:

logLevel - ログ出力レベル

cause - 障害の起因となる例外

messageId - ログ内容のメッセージID

messageParams - ログメッセージの埋め込みパラメータ

Method Detail

getMessageId

public String getMessageId()

メッセージIDを返す。

Returns:

メッセージID

getMessageParams

public Object[] getMessageParams()

メッセージパラメータを返す。

Returns:

メッセージパラメータ

getMessage

public String getMessage()

このインスタンスにメッセージIDが指定されている場合は、 そのIDに対応したメッセージ内容を返す。

Specified by:

getMessage in interface nablarch.fw.Result

Overrides:

getMessage in class Throwable

writeLog

public void writeLog(nablarch.fw.ExecutionContext context)

この障害の内容について運用ログに出力する。

ログレベルがエラーレベル以上の場合に、障害内容を運用ログに出力する。 ワーニングレベル以下の場合は何もしない。

Parameters:

context - 実行コンテキスト

getStatusCode

public int getStatusCode()

Specified by:

getStatusCode in interface nablarch.fw.Result

Overrides:

getStatusCode in class nablarch.fw.Result.Error