注释类型 ExceptionHandler
@Target(METHOD) @Retention(RUNTIME) @Documented public @interface ExceptionHandler
Annotation for handling exceptions in specific handler classes and/or handler methods.Handler methods which are annotated with this annotation are allowed to have very flexible signatures. They may have parameters of the following types, in arbitrary order:
- An exception argument: declared as a general Exception or as a more specific exception. This also serves as a mapping hint if the annotation itself does not narrow the exception types through its
value(). - Request and/or response objects (typically from the Servlet API). You may choose any specific request/response type, e.g.
ServletRequest/HttpServletRequest. - Session object: typically
HttpSession. An argument of this type will enforce the presence of a corresponding session. As a consequence, such an argument will never benull. Note that session access may not be thread-safe, in particular in a Servlet environment: Consider switching the"synchronizeOnSession"flag to "true" if multiple requests are allowed to access a session concurrently. WebRequestorNativeWebRequest. Allows for generic request parameter access as well as request/session attribute access, without ties to the native Servlet API.Localefor the current request locale (determined by the most specific locale resolver available, i.e. the configuredLocaleResolverin a Servlet environment).InputStream/Readerfor access to the request's content. This will be the raw InputStream/Reader as exposed by the Servlet API.OutputStream/Writerfor generating the response's content. This will be the raw OutputStream/Writer as exposed by the Servlet API.Modelas an alternative to returning a model map from the handler method. Note that the provided model is not pre-populated with regular model attributes and therefore always empty, as a convenience for preparing the model for an exception-specific view.
The following return types are supported for handler methods:
- A
ModelAndViewobject (from Servlet MVC). - A
Modelobject, with the view name implicitly determined through aRequestToViewNameTranslator. - A
Mapobject for exposing a model, with the view name implicitly determined through aRequestToViewNameTranslator. - A
Viewobject. - A
Stringvalue which is interpreted as view name. @ResponseBodyannotated methods (Servlet-only) to set the response content. The return value will be converted to the response stream using message converters.- An
HttpEntity<?>orResponseEntity<?>object (Servlet-only) to set response headers and content. The ResponseEntity body will be converted and written to the response stream using message converters. voidif the method handles the response itself (by writing the response content directly, declaring an argument of typeServletResponse/HttpServletResponsefor that purpose) or if the view name is supposed to be implicitly determined through aRequestToViewNameTranslator(not declaring a response argument in the handler method signature).
You may combine the
ExceptionHandlerannotation with@ResponseStatusfor a specific HTTP error status.- 从以下版本开始:
- 3.0
- 作者:
- Arjen Poutsma, Juergen Hoeller
- 另请参阅:
WebRequest
- An exception argument: declared as a general Exception or as a more specific exception. This also serves as a mapping hint if the annotation itself does not narrow the exception types through its