例外ハンドラの登録

例外ハンドラはorg.seasar.ymir.handler.ExceptionHandlerインタフェースを継承したクラスで、Seasarにコンポーネントとして登録しておく必要があります。

なお、アプリケーションのルートパッケージの下のhandlerパッケージの下にある「～Handler」という名前のクラスはYmirによって自動的にコンポーネント登録されます。他のパッケージに置いてあるハンドラクラスを登録する場合は手動で登録する必要があります。その際コンポーネント名は「対応する例外クラス名（パッケージ部分なし）をJavaBeansのプロパティ名化のルールに従って変換した文字列＋「Handler」として下さい（例：IllegalArgumentException → illegalArgumentExceptionHandler）。

例外ハンドラの探索

リクエストの処理中に例外Eが発生した場合、Ymirは以下の順序で例外ハンドラを探します。

1. SeasarからEに対応する例外ハンドラを探します。
2. 見つからなくてかつEのスーパークラスがExceptionまたはExceptionのサブクラスならば、Eのスーパークラスに対応する例外ハンドラを探します。
3. 2.の処理を再帰的に繰り返します。

デフォルトの例外ハンドラ

例外ハンドラが見つからなかった場合はデフォルトの例外ハンドラが使用されます。デフォルトの例外ハンドラとその処理は以下のとおりです。

例外ハンドラの呼び出し

例外ハンドラの呼び出しに先立って、Pageオブジェクトの場合と同じようにオブジェクトスコープからのオブジェクトのインジェクション処理が行なわれます。すなわち、@Inアノテーションが付与されているsetterメソッドがあれば、アノテーションに従ったオブジェクトスコープからオブジェクトが取り出されてsetterメソッドを使ってオブジェクトがセットされます。

次に例外ハンドラのhandleメソッドが呼び出されます。handleメソッドの引数にはスローされた例外オブジェクトが渡されます。

最後にオブジェクトスコープへのオブジェクトのアウトジェクション処理が行なわれます。すなわち、@Outアノテーションが付与されているgetterメソッドがあれば、アノテーションに従ったオブジェクトスコープにgetterメソッドの返り値が格納されます。