クラス ResponseEntityExceptionHandler

メソッドの詳細

• setMessageSource

  public void setMessageSource(MessageSource messageSource)

  インターフェースからコピーされた説明: MessageSourceAware

  このオブジェクトが実行される MessageSource を設定します。

  通常の Bean プロパティの設定後、InitializingBean の afterPropertiesSet またはカスタム init メソッドのような初期コールバックの前に呼び出されます。ApplicationContextAware の setApplicationContext の前に呼び出されます。

  次で指定:

  インターフェース MessageSourceAware の setMessageSource 

  パラメーター:

  messageSource - このオブジェクトが使用するメッセージソース

• getMessageSource

  @Nullable protected MessageSource getMessageSource()

  この例外ハンドラーが使用する MessageSource を取得します。

  導入:

  6.0.3

• handleException

  @ExceptionHandler({HttpRequestMethodNotSupportedException.class,HttpMediaTypeNotSupportedException.class,HttpMediaTypeNotAcceptableException.class,MissingPathVariableException.class,MissingServletRequestParameterException.class,MissingServletRequestPartException.class,ServletRequestBindingException.class,MethodArgumentNotValidException.class,HandlerMethodValidationException.class,NoHandlerFoundException.class,NoResourceFoundException.class,AsyncRequestTimeoutException.class,ErrorResponseException.class,MaxUploadSizeExceededException.class,ConversionNotSupportedException.class,TypeMismatchException.class,HttpMessageNotReadableException.class,HttpMessageNotWritableException.class,MethodValidationException.class,BindException.class}) @Nullable public final ResponseEntity<ObjectSE> handleException(ExceptionSE ex, WebRequest request) throws ExceptionSE

  リクエストの Spring MVC 処理内で発生したすべての例外を処理します。

  パラメーター:

  ex - 処理する例外

  request - 現在のリクエスト

  例外:

  ExceptionSE

• handleHttpRequestMethodNotSupported

  @Nullable protected ResponseEntity<ObjectSE> handleHttpRequestMethodNotSupported(HttpRequestMethodNotSupportedException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  HttpRequestMethodNotSupportedException の処理をカスタマイズします。

  このメソッドは警告をログに記録し、handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleHttpMediaTypeNotSupported

  @Nullable protected ResponseEntity<ObjectSE> handleHttpMediaTypeNotSupported(HttpMediaTypeNotSupportedException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  HttpMediaTypeNotSupportedException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleHttpMediaTypeNotAcceptable

  @Nullable protected ResponseEntity<ObjectSE> handleHttpMediaTypeNotAcceptable(HttpMediaTypeNotAcceptableException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  HttpMediaTypeNotAcceptableException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleMissingPathVariable

  @Nullable protected ResponseEntity<ObjectSE> handleMissingPathVariable(MissingPathVariableException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  MissingPathVariableException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  4.2

• handleMissingServletRequestParameter

  @Nullable protected ResponseEntity<ObjectSE> handleMissingServletRequestParameter(MissingServletRequestParameterException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  MissingServletRequestParameterException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleMissingServletRequestPart

  @Nullable protected ResponseEntity<ObjectSE> handleMissingServletRequestPart(MissingServletRequestPartException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  MissingServletRequestPartException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleServletRequestBindingException

  @Nullable protected ResponseEntity<ObjectSE> handleServletRequestBindingException(ServletRequestBindingException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  ServletRequestBindingException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleMethodArgumentNotValid

  @Nullable protected ResponseEntity<ObjectSE> handleMethodArgumentNotValid(MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  MethodArgumentNotValidException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに書き込まれるヘッダー

  status - 選択したレスポンスステータス

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleHandlerMethodValidationException

  @Nullable protected ResponseEntity<ObjectSE> handleHandlerMethodValidationException(HandlerMethodValidationException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  HandlerMethodValidationException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに書き込まれるヘッダー

  status - 選択したレスポンスステータス

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  6.1

• handleNoHandlerFoundException

  @Nullable protected ResponseEntity<ObjectSE> handleNoHandlerFoundException(NoHandlerFoundException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  NoHandlerFoundException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  4.0

• handleNoResourceFoundException

  @Nullable protected ResponseEntity<ObjectSE> handleNoResourceFoundException(NoResourceFoundException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  NoResourceFoundException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  6.1

• handleAsyncRequestTimeoutException

  @Nullable protected ResponseEntity<ObjectSE> handleAsyncRequestTimeoutException(AsyncRequestTimeoutException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  AsyncRequestTimeoutException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  4.2.8

• handleErrorResponseException

  @Nullable protected ResponseEntity<ObjectSE> handleErrorResponseException(ErrorResponseException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  ErrorResponseException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  6.0

• handleMaxUploadSizeExceededException

  @Nullable protected ResponseEntity<ObjectSE> handleMaxUploadSizeExceededException(MaxUploadSizeExceededException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  MaxUploadSizeExceededException の処理をカスタマイズします。

  このメソッドは handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  6.1

• handleConversionNotSupported

  @Nullable protected ResponseEntity<ObjectSE> handleConversionNotSupported(ConversionNotSupportedException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  ConversionNotSupportedException の処理をカスタマイズします。

  デフォルトでは、このメソッドはステータスと短い詳細メッセージを含む ProblemDetail を作成し、handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲する前に MessageSource を介して詳細のオーバーライドを検索します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleTypeMismatch

  @Nullable protected ResponseEntity<ObjectSE> handleTypeMismatch(TypeMismatchException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  TypeMismatchException の処理をカスタマイズします。

  デフォルトでは、このメソッドはステータスと短い詳細メッセージを含む ProblemDetail を作成し、handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲する前に MessageSource を介して詳細のオーバーライドを検索します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleHttpMessageNotReadable

  @Nullable protected ResponseEntity<ObjectSE> handleHttpMessageNotReadable(HttpMessageNotReadableException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  HttpMessageNotReadableException の処理をカスタマイズします。

  デフォルトでは、このメソッドはステータスと短い詳細メッセージを含む ProblemDetail を作成し、handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲する前に MessageSource を介して詳細のオーバーライドを検索します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleHttpMessageNotWritable

  @Nullable protected ResponseEntity<ObjectSE> handleHttpMessageNotWritable(HttpMessageNotWritableException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  HttpMessageNotWritableException の処理をカスタマイズします。

  デフォルトでは、このメソッドはステータスと短い詳細メッセージを含む ProblemDetail を作成し、handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲する前に MessageSource を介して詳細のオーバーライドを検索します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleBindException

  @Nullable @DeprecatedSE(since="6.0", forRemoval=true) protected ResponseEntity<ObjectSE> handleBindException(BindException ex, HttpHeaders headers, HttpStatusCode status, WebRequest request)

  非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。

  6.0 では、ModelAttributeMethodProcessor が MethodArgumentNotValidException のサブクラスを発生させるようになったため。

  BindException の処理をカスタマイズします。

  デフォルトでは、このメソッドはステータスと短い詳細メッセージを含む ProblemDetail を作成し、次に handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• handleMethodValidationException

  @Nullable protected ResponseEntity<ObjectSE> handleMethodValidationException(MethodValidationException ex, HttpHeaders headers, HttpStatus status, WebRequest request)

  MethodValidationException の処理をカスタマイズします。

  デフォルトでは、このメソッドはステータスと短い詳細メッセージを含む ProblemDetail を作成し、handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatusCode, org.springframework.web.context.request.WebRequest) に委譲する前に MessageSource を介して詳細のオーバーライドを検索します。

  パラメーター:

  ex - 処理する例外

  headers - レスポンスに使用するヘッダー

  status - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

  導入:

  6.1

• createProblemDetail

  protected ProblemDetail createProblemDetail(ExceptionSE ex, HttpStatusCode status, StringSE defaultDetail, @Nullable StringSE detailMessageCode, @Nullable ObjectSE[] detailMessageArguments, WebRequest request)

  ErrorResponse を実装していない例外に対して ProblemDetail を作成し、「詳細」フィールドの MessageSource ルックアップも実行する便利なメソッド。

  パラメーター:

  ex - 処理中の例外

  status - 例外に関連付けるステータス

  defaultDetail - 「詳細」フィールドのデフォルト値

  detailMessageCode - MessageSource を通じて「詳細」フィールドを検索するために使用するコード。null の場合、使用するデフォルトのメッセージコードを決定するために ErrorResponse.getDefaultDetailMessageCode(Class, String) が使用されます。

  detailMessageArguments - detailMessageCode に付随する引数

  request - 現在のリクエスト

  戻り値:

  作成された ProblemDetail インスタンス

  導入:

  6.0

• handleExceptionInternal

  @Nullable protected ResponseEntity<ObjectSE> handleExceptionInternal(ExceptionSE ex, @Nullable ObjectSE body, HttpHeaders headers, HttpStatusCode statusCode, WebRequest request)

  共通の処理と ResponseEntity の作成のために、このクラスの他のすべてが委譲する内部ハンドラーメソッド。

  デフォルトの実装では、次のことが行われます。

  • レスポンスがすでにコミットされている場合は null を返す
  • レスポンスステータスが 500 (INTERNAL_SERVER_ERROR) の場合は、"jakarta.servlet.error.exception" リクエスト属性を設定します。
  • body が null の場合、ErrorResponse 例外から body を抽出します。

  パラメーター:

  ex - 処理する例外

  body - レスポンスに使用するボディ

  headers - レスポンスに使用するヘッダー

  statusCode - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用するレスポンスの ResponseEntity。レスポンスがすでにコミットされている場合は null の可能性があります

• createResponseEntity

  protected ResponseEntity<ObjectSE> createResponseEntity(@Nullable ObjectSE body, HttpHeaders headers, HttpStatusCode statusCode, WebRequest request)

  指定された本文、ヘッダー、statusCode から使用する ResponseEntity を作成します。サブクラスは、このメソッドをオーバーライドして、本文、ヘッダー、statusCode をインスペクションし、場合によっては変更できます。ProblemDetail の拡張として ProblemDetail のインスタンスを再作成します。

  パラメーター:

  body - レスポンスに使用するボディ

  headers - レスポンスに使用するヘッダー

  statusCode - レスポンスに使用するステータスコード

  request - 現在のリクエスト

  戻り値:

  使用する ResponseEntity インスタンス

  導入:

  6.0