@TargetSE(valueSE=METHODSE)
 @RetentionSE(valueSE=RUNTIMESE)
 @DocumentedSE
public @interface ExceptionHandler

特定のハンドラークラスやハンドラーメソッドで例外を処理するためのアノテーション。具体的な環境に適応するセマンティクスを使用して、サーブレット環境とポートレット環境の間で一貫したスタイルを提供します。

このアノテーションが付けられたハンドラーメソッドは、非常に柔軟な署名を持つことができます。次の型のパラメーターを任意の順序で持つことができます。

• 例外引数: 一般的な例外またはより具体的な例外として宣言されています。これは、アノテーション自体が value() を介して例外型を絞り込まない場合のマッピングヒントとしても機能します。
• リクエストおよび / またはレスポンスオブジェクト (サーブレット API またはポートレット API)。特定のリクエスト / レスポンス型 (例: ServletRequestEE/HttpServletRequestEE または PortletRequest/ActionRequest/RenderRequest) を選択できます。ポートレットの場合、明示的に宣言されたアクション / レンダリング引数は、特定のリクエスト型をハンドラーメソッドにマッピングするためにも使用されることに注意してください (アクションリクエストとレンダリングリクエストを区別する他の情報が指定されていない場合)。
• セッションオブジェクト (サーブレット API またはポートレット API): HttpSessionEE または PortletSession のいずれか。この型の引数は、対応するセッションの存在を強制します。結果として、このような引数が null になることはありません。 特にサーブレット環境では、セッションアクセスがスレッドセーフではない可能性があることに注意してください。複数のリクエストが同時にセッションにアクセスできるようにする場合は、"synchronizeOnSession" フラグを "true" に切り替えることを検討してください。
• WebRequest または NativeWebRequest。ネイティブサーブレット / ポートレット API に縛られることなく、汎用リクエストパラメーターアクセスとリクエスト / セッション属性アクセスを可能にします。
• 現在のリクエストロケールの LocaleSE (使用可能な最も具体的なロケールリゾルバーによって決定されます。つまり、サーブレット環境では構成された LocaleResolver、ポートレット環境ではポータルロケール)。
• リクエストのコンテンツにアクセスするための InputStreamSE/ReaderSE。これは、サーブレット / ポートレット API によって公開される生の InputStream/ リーダーになります。
• レスポンスのコンテンツを生成するための OutputStreamSE/WriterSE。これは、サーブレット / ポートレット API によって公開される生の OutputStream/Writer になります。
• ハンドラーメソッドからモデルマップを返す代わりとしての Model。例外固有のビュー用にモデルを準備するのに便利なように、提供されたモデルには通常のモデル属性が事前に設定されておらず、常に空であることに注意してください。

ハンドラーメソッドでは、次の戻り値の型がサポートされています。

• ModelAndView オブジェクト (サーブレット MVC またはポートレット MVC)。
• RequestToViewNameTranslator を介して暗黙的に決定されたビュー名を持つ Model オブジェクト。
• モデルを公開するための MapSE オブジェクト。ビュー名は RequestToViewNameTranslator を介して暗黙的に決定されます。
• View オブジェクト。
• ビュー名として解釈される StringSE 値。
• @ResponseBody アノテーション付きメソッド (サーブレットのみ) は、レスポンスコンテンツを設定します。戻り値は、メッセージコンバーターを使用してレスポンスストリームに変換されます。
• レスポンスヘッダーとコンテンツを設定するための HttpEntity<?> または ResponseEntity<?> オブジェクト (サーブレットのみ)。ResponseEntity 本文は、メッセージコンバーターを使用して変換され、レスポンスストリームに書き込まれます。
• メソッドがレスポンス自体を処理する場合（レスポンスコンテンツを直接記述し、そのために型 ServletResponseEE/HttpServletResponseEE/RenderResponse の引数を宣言する）またはビュー名が RequestToViewNameTranslator を通じて暗黙的に決定されることになっている場合（ハンドラーメソッドシグネチャーでレスポンス引数を宣言しない、サーブレット環境にのみ適用可能）は void です。

サーブレット環境では、ExceptionHandler アノテーションを @ResponseStatus と組み合わせて、HTTP レスポンスのレスポンスステータスを定義できます。

注 : ポートレット環境では、ExceptionHandler アノテーション付きメソッドは、HandlerExceptionResolver Bean と同様に、レンダリングフェーズとリソースフェーズでのみ呼び出されます。アクションフェーズとイベントフェーズから持ち越された例外もレンダリングフェーズで呼び出され、該当するレンダリングメソッドを定義するコントローラークラスに例外ハンドラーメソッドが存在する必要があります。