nablarch.fw.handler

Class GlobalErrorHandler

java.lang.Object

nablarch.fw.handler.GlobalErrorHandler

All Implemented Interfaces:

ExceptionHandler, Handler<Request<?>,java.lang.Object>

public class GlobalErrorHandler
extends java.lang.Object
implements Handler<Request<?>,java.lang.Object>, ExceptionHandler

異例処理用例外ハンドラ。

このハンドラは、リクエストコントローラの直後に配置され、 ハンドラキュー上のどのハンドラでも捕捉されなかった例外に対して 最終的に処理を行う責務を持ったハンドラである。

ほとんどのエラーは各処理方式に準じた例外ハンドラーにより捕捉されるが、 それらのハンドラが捕捉しないエラー、もしくは、それらのハンドラ以降の 処理で発生したエラーが対象となる。

このハンドラが例外処理として行うのは以下の2点である。 1. ログ出力 2. コントローラに対する例外のリスロー (コントローラ自体の処理継続が不可能な致命的エラーの場合。)

Constructor Summary

Constructors

Constructor and Description
GlobalErrorHandler()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	handle(Request<?> req, ExecutionContext context) 入力データに対する処理を実行する。
Result	handleError(java.lang.Error e, ExecutionContext context) Error の例外処理を行う。 例外をNablarchのハンドラでレスポンスとして処理する場合、 このハンドラより外部のハンドラが処理できるレスポンスオブジェクトを返す。
Result	handleRuntimeException(java.lang.RuntimeException e, ExecutionContext context) RuntimeExceptionの例外処理を行う。 例外をNablarchのハンドラでレスポンスとして処理する場合、 このハンドラより外部のハンドラが処理できるレスポンスオブジェクトを返す。

Methods inherited from class java.lang.Object

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

Constructor Detail

GlobalErrorHandler

public GlobalErrorHandler()

Method Detail

handle

public java.lang.Object handle(Request<?> req,
                               ExecutionContext context)

入力データに対する処理を実行する。

Specified by:

handle in interface Handler<Request<?>,java.lang.Object>

Parameters:

req - 入力データ

context - 実行コンテキスト

Returns:

処理結果データ

handleError

public Result handleError(java.lang.Error e,
                          ExecutionContext context)
                   throws java.lang.Error,
                          java.lang.RuntimeException

Description copied from interface: ExceptionHandler

Error の例外処理を行う。
例外をNablarchのハンドラでレスポンスとして処理する場合、 このハンドラより外部のハンドラが処理できるレスポンスオブジェクトを返す。

Specified by:

handleError in interface ExceptionHandler

Parameters:

e - 処理するError

context - ExecutionContext

Returns:

例外を表すレスポンスオブジェクト

Throws:

java.lang.Error - 例外を処理できない場合

java.lang.RuntimeException - 例外を処理できない場合、または付け替えた例外

handleRuntimeException

public Result handleRuntimeException(java.lang.RuntimeException e,
                                     ExecutionContext context)
                              throws java.lang.RuntimeException

Description copied from interface: ExceptionHandler

RuntimeExceptionの例外処理を行う。
例外をNablarchのハンドラでレスポンスとして処理する場合、 このハンドラより外部のハンドラが処理できるレスポンスオブジェクトを返す。

Specified by:

handleRuntimeException in interface ExceptionHandler

Parameters:

e - 処理する例外

context - ExecutionContext

Returns:

例外を表すレスポンスオブジェクト

Throws:

java.lang.RuntimeException - 例外を処理できない場合、または付け替えた例外