java.lang.Object
- org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler

```
public abstract class ResponseEntityExceptionHandler
extends Object
```
A convenient base class for @ControllerAdvice classes that wish to provide centralized exception handling across all @RequestMapping methods through @ExceptionHandler methods.
This base class provides an @ExceptionHandler method for handling internal Spring MVC exceptions. This method returns a ResponseEntity for writing to the response with a message converter, in contrast to DefaultHandlerExceptionResolver which returns a ModelAndView.
If there is no need to write error content to the response body, or when using view resolution (e.g., via ContentNegotiatingViewResolver), then DefaultHandlerExceptionResolver is good enough.
Note that in order for an @ControllerAdvice subclass to be detected, ExceptionHandlerExceptionResolver must be configured.
从以下版本开始:
3.2
作者:
Rossen Stoyanchev
另请参阅:
handleException(Exception, WebRequest), DefaultHandlerExceptionResolver

字段概要

字段
修饰符和类型	字段	说明
`protected Log`	`logger`	Common logger for use in subclasses.
`static String`	`PAGE_NOT_FOUND_LOG_CATEGORY`	Log category to use when no mapped handler is found for a request.
`protected static Log`	`pageNotFoundLogger`	Specific logger to use when no mapped handler is found for a request.

构造器概要
构造器
构造器说明
ResponseEntityExceptionHandler()

方法概要

所有方法实例方法具体方法已过时的方法
修饰符和类型	方法	说明
`protected ResponseEntity<Object>`	`handleAsyncRequestTimeoutException(AsyncRequestTimeoutException ex, HttpHeaders headers, HttpStatus status, WebRequest webRequest)`	Customize the response for AsyncRequestTimeoutException.
`protected ResponseEntity<Object>`	`handleBindException(BindException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for BindException.
`protected ResponseEntity<Object>`	`handleConversionNotSupported(ConversionNotSupportedException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for ConversionNotSupportedException.
`ResponseEntity<Object>`	`handleException(Exception ex, WebRequest request)`	Provides handling for standard Spring MVC exceptions.
`protected ResponseEntity<Object>`	`handleExceptionInternal(Exception ex, Object body, HttpHeaders headers, HttpStatus status, WebRequest request)`	A single place to customize the response body of all exception types.
`protected ResponseEntity<Object>`	`handleHttpMediaTypeNotAcceptable(HttpMediaTypeNotAcceptableException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for HttpMediaTypeNotAcceptableException.
`protected ResponseEntity<Object>`	`handleHttpMediaTypeNotSupported(HttpMediaTypeNotSupportedException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for HttpMediaTypeNotSupportedException.
`protected ResponseEntity<Object>`	`handleHttpMessageNotReadable(HttpMessageNotReadableException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for HttpMessageNotReadableException.
`protected ResponseEntity<Object>`	`handleHttpMessageNotWritable(HttpMessageNotWritableException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for HttpMessageNotWritableException.
`protected ResponseEntity<Object>`	`handleHttpRequestMethodNotSupported(HttpRequestMethodNotSupportedException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for HttpRequestMethodNotSupportedException.
`protected ResponseEntity<Object>`	`handleMethodArgumentNotValid(MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for MethodArgumentNotValidException.
`protected ResponseEntity<Object>`	`handleMissingPathVariable(MissingPathVariableException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for MissingPathVariableException.
`protected ResponseEntity<Object>`	`handleMissingServletRequestParameter(MissingServletRequestParameterException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for MissingServletRequestParameterException.
`protected ResponseEntity<Object>`	`handleMissingServletRequestPart(MissingServletRequestPartException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for MissingServletRequestPartException.
`protected ResponseEntity<Object>`	`handleNoHandlerFoundException(NoHandlerFoundException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for NoHandlerFoundException.
`protected ResponseEntity<Object>`	`handleNoSuchRequestHandlingMethod(NoSuchRequestHandlingMethodException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	已过时。 as of 4.3, along with `NoSuchRequestHandlingMethodException`
`protected ResponseEntity<Object>`	`handleServletRequestBindingException(ServletRequestBindingException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for ServletRequestBindingException.
`protected ResponseEntity<Object>`	`handleTypeMismatch(TypeMismatchException ex, HttpHeaders headers, HttpStatus status, WebRequest request)`	Customize the response for TypeMismatchException.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料
- PAGE_NOT_FOUND_LOG_CATEGORY
```
public static final String PAGE_NOT_FOUND_LOG_CATEGORY
```
  Log category to use when no mapped handler is found for a request.
  另请参阅:
  pageNotFoundLogger, 常量字段值
- pageNotFoundLogger
```
protected static final Log pageNotFoundLogger
```
  Specific logger to use when no mapped handler is found for a request.
  另请参阅:
  PAGE_NOT_FOUND_LOG_CATEGORY
- logger
```
protected final Log logger
```
  Common logger for use in subclasses.

构造器详细资料
- ResponseEntityExceptionHandler
```
public ResponseEntityExceptionHandler()
```

方法详细资料

handleException

@ExceptionHandler({NoSuchRequestHandlingMethodException.class,HttpRequestMethodNotSupportedException.class,HttpMediaTypeNotSupportedException.class,HttpMediaTypeNotAcceptableException.class,MissingPathVariableException.class,MissingServletRequestParameterException.class,ServletRequestBindingException.class,ConversionNotSupportedException.class,TypeMismatchException.class,HttpMessageNotReadableException.class,HttpMessageNotWritableException.class,MethodArgumentNotValidException.class,MissingServletRequestPartException.class,BindException.class,NoHandlerFoundException.class,AsyncRequestTimeoutException.class})
public final ResponseEntity<Object> handleException(Exception ex,
                                                    WebRequest request)
                                             throws Exception

Provides handling for standard Spring MVC exceptions.

参数:: ex - the target exception; request - the current request
抛出:: Exception

handleNoSuchRequestHandlingMethod

@Deprecated
protected ResponseEntity<Object> handleNoSuchRequestHandlingMethod(NoSuchRequestHandlingMethodException ex,
                                                                   HttpHeaders headers,
                                                                   HttpStatus status,
                                                                   WebRequest request)

已过时。

as of 4.3, along with NoSuchRequestHandlingMethodException

Customize the response for NoSuchRequestHandlingMethodException.

This method logs a warning and delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleHttpRequestMethodNotSupported

protected ResponseEntity<Object> handleHttpRequestMethodNotSupported(HttpRequestMethodNotSupportedException ex,
                                                                     HttpHeaders headers,
                                                                     HttpStatus status,
                                                                     WebRequest request)

Customize the response for HttpRequestMethodNotSupportedException.

This method logs a warning, sets the "Allow" header, and delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleHttpMediaTypeNotSupported

protected ResponseEntity<Object> handleHttpMediaTypeNotSupported(HttpMediaTypeNotSupportedException ex,
                                                                 HttpHeaders headers,
                                                                 HttpStatus status,
                                                                 WebRequest request)

Customize the response for HttpMediaTypeNotSupportedException.

This method sets the "Accept" header and delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleHttpMediaTypeNotAcceptable

protected ResponseEntity<Object> handleHttpMediaTypeNotAcceptable(HttpMediaTypeNotAcceptableException ex,
                                                                  HttpHeaders headers,
                                                                  HttpStatus status,
                                                                  WebRequest request)

Customize the response for HttpMediaTypeNotAcceptableException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleMissingPathVariable

protected ResponseEntity<Object> handleMissingPathVariable(MissingPathVariableException ex,
                                                           HttpHeaders headers,
                                                           HttpStatus status,
                                                           WebRequest request)

Customize the response for MissingPathVariableException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance
从以下版本开始:: 4.2

handleMissingServletRequestParameter

protected ResponseEntity<Object> handleMissingServletRequestParameter(MissingServletRequestParameterException ex,
                                                                      HttpHeaders headers,
                                                                      HttpStatus status,
                                                                      WebRequest request)

Customize the response for MissingServletRequestParameterException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleServletRequestBindingException

protected ResponseEntity<Object> handleServletRequestBindingException(ServletRequestBindingException ex,
                                                                      HttpHeaders headers,
                                                                      HttpStatus status,
                                                                      WebRequest request)

Customize the response for ServletRequestBindingException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleConversionNotSupported

protected ResponseEntity<Object> handleConversionNotSupported(ConversionNotSupportedException ex,
                                                              HttpHeaders headers,
                                                              HttpStatus status,
                                                              WebRequest request)

Customize the response for ConversionNotSupportedException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleTypeMismatch

protected ResponseEntity<Object> handleTypeMismatch(TypeMismatchException ex,
                                                    HttpHeaders headers,
                                                    HttpStatus status,
                                                    WebRequest request)

Customize the response for TypeMismatchException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleHttpMessageNotReadable

protected ResponseEntity<Object> handleHttpMessageNotReadable(HttpMessageNotReadableException ex,
                                                              HttpHeaders headers,
                                                              HttpStatus status,
                                                              WebRequest request)

Customize the response for HttpMessageNotReadableException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleHttpMessageNotWritable

protected ResponseEntity<Object> handleHttpMessageNotWritable(HttpMessageNotWritableException ex,
                                                              HttpHeaders headers,
                                                              HttpStatus status,
                                                              WebRequest request)

Customize the response for HttpMessageNotWritableException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleMethodArgumentNotValid

protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex,
                                                              HttpHeaders headers,
                                                              HttpStatus status,
                                                              WebRequest request)

Customize the response for MethodArgumentNotValidException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleMissingServletRequestPart

protected ResponseEntity<Object> handleMissingServletRequestPart(MissingServletRequestPartException ex,
                                                                 HttpHeaders headers,
                                                                 HttpStatus status,
                                                                 WebRequest request)

Customize the response for MissingServletRequestPartException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleBindException

protected ResponseEntity<Object> handleBindException(BindException ex,
                                                     HttpHeaders headers,
                                                     HttpStatus status,
                                                     WebRequest request)

Customize the response for BindException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance

handleNoHandlerFoundException

protected ResponseEntity<Object> handleNoHandlerFoundException(NoHandlerFoundException ex,
                                                               HttpHeaders headers,
                                                               HttpStatus status,
                                                               WebRequest request)

Customize the response for NoHandlerFoundException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; request - the current request
返回:: a ResponseEntity instance
从以下版本开始:: 4.0

handleAsyncRequestTimeoutException

protected ResponseEntity<Object> handleAsyncRequestTimeoutException(AsyncRequestTimeoutException ex,
                                                                    HttpHeaders headers,
                                                                    HttpStatus status,
                                                                    WebRequest webRequest)

Customize the response for AsyncRequestTimeoutException.

This method delegates to handleExceptionInternal(java.lang.Exception, java.lang.Object, org.springframework.http.HttpHeaders, org.springframework.http.HttpStatus, org.springframework.web.context.request.WebRequest).

参数:: ex - the exception; headers - the headers to be written to the response; status - the selected response status; webRequest - the current request
返回:: a ResponseEntity instance
从以下版本开始:: 4.2.8

handleExceptionInternal

protected ResponseEntity<Object> handleExceptionInternal(Exception ex,
                                                         Object body,
                                                         HttpHeaders headers,
                                                         HttpStatus status,
                                                         WebRequest request)

A single place to customize the response body of all exception types.

The default implementation sets the WebUtils.ERROR_EXCEPTION_ATTRIBUTE request attribute and creates a ResponseEntity from the given body, headers, and status.

参数:: ex - the exception; body - the body for the response; headers - the headers for the response; status - the response status; request - the current request

类 ResponseEntityExceptionHandler

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

PAGE_NOT_FOUND_LOG_CATEGORY

pageNotFoundLogger

logger

构造器详细资料

ResponseEntityExceptionHandler

方法详细资料

handleException

handleNoSuchRequestHandlingMethod

handleHttpRequestMethodNotSupported

handleHttpMediaTypeNotSupported

handleHttpMediaTypeNotAcceptable

handleMissingPathVariable

handleMissingServletRequestParameter

handleServletRequestBindingException

handleConversionNotSupported

handleTypeMismatch

handleHttpMessageNotReadable

handleHttpMessageNotWritable

handleMethodArgumentNotValid

handleMissingServletRequestPart

handleBindException

handleNoHandlerFoundException

handleAsyncRequestTimeoutException

handleExceptionInternal