java.lang.Object | |
↳ | org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver |
Known Direct Subclasses |
Abstract base class for HandlerExceptionResolver
implementations.
Provides a set of mapped handlers that the resolver should map to,
and the Ordered
implementation.
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
org.springframework.core.Ordered
|
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
logger | Logger available to subclasses |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Return the order value of this object, with a
higher value meaning greater in terms of sorting.
| |||||||||||
Checks whether this resolver is supposed to apply (i.e.
| |||||||||||
Specify the set of classes that this exception resolver should apply to.
| |||||||||||
Specify the set of handlers that this exception resolver should apply to.
| |||||||||||
Specify whether to prevent HTTP response caching for any view resolved
by this HandlerExceptionResolver.
| |||||||||||
Set the log category for warn logging.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Build a log message for the given exception, occured during processing the given request.
| |||||||||||
Actually resolve the given exception that got thrown during on handler execution,
returning a ModelAndView that represents a specific error page if appropriate.
| |||||||||||
Log the given exception at warn level, provided that warn logging has been
activated through the
"warnLogCategory" property. | |||||||||||
Prepare the response for the exceptional case.
| |||||||||||
Prevents the response from being cached, through setting corresponding
HTTP headers.
| |||||||||||
Check whether this resolver is supposed to apply to the given handler.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
org.springframework.core.Ordered
| |||||||||||
From interface
org.springframework.web.servlet.HandlerExceptionResolver
|
Logger available to subclasses
Return the order value of this object, with a higher value meaning greater in terms of sorting.
Normally starting with 0, with Integer.MAX_VALUE
indicating the greatest value. Same order values will result
in arbitrary positions for the affected objects.
Higher values can be interpreted as lower priority. As a consequence, the object with the lowest value has highest priority (somewhat analogous to Servlet "load-on-startup" values).
Checks whether this resolver is supposed to apply (i.e. the handler matches
in case of "mappedHandlers" having been specified), then delegates to the
doResolveException(HttpServletRequest, HttpServletResponse, Object, Exception)
template method.
request | current HTTP request |
---|---|
response | current HTTP response |
handler | the executed handler, or null if none chosen at the
time of the exception (for example, if multipart resolution failed) |
ex | the exception that got thrown during handler execution |
null
for default processing
Specify the set of classes that this exception resolver should apply to. The exception mappings and the default error view will only apply to handlers of the specified type; the specified types may be interfaces and superclasses of handlers as well.
If no handlers and handler classes are set, the exception mappings and the default error view will apply to all handlers. This means that a specified default error view will be used as fallback for all exceptions; any further HandlerExceptionResolvers in the chain will be ignored in this case.
Specify the set of handlers that this exception resolver should apply to. The exception mappings and the default error view will only apply to the specified handlers.
If no handlers and handler classes are set, the exception mappings and the default error view will apply to all handlers. This means that a specified default error view will be used as fallback for all exceptions; any further HandlerExceptionResolvers in the chain will be ignored in this case.
Specify whether to prevent HTTP response caching for any view resolved by this HandlerExceptionResolver.
Default is "false". Switch this to "true" in order to automatically generate HTTP response headers that suppress response caching.
Set the log category for warn logging. The name will be passed to the underlying logger implementation through Commons Logging, getting interpreted as log category according to the logger's configuration.
Default is no warn logging. Specify this setting to activate warn logging into a specific
category. Alternatively, override the logException(Exception, HttpServletRequest)
method for custom logging.
getLogger(String)
Build a log message for the given exception, occured during processing the given request.
ex | the exception that got thrown during handler execution |
---|---|
request | current HTTP request (useful for obtaining metadata) |
Actually resolve the given exception that got thrown during on handler execution, returning a ModelAndView that represents a specific error page if appropriate.
May be overridden in subclasses, in order to apply specific exception checks. Note that this template method will be invoked after checking whether this resolved applies ("mappedHandlers" etc), so an implementation may simply proceed with its actual exception handling.
request | current HTTP request |
---|---|
response | current HTTP response |
handler | the executed handler, or null if none chosen at the time
of the exception (for example, if multipart resolution failed) |
ex | the exception that got thrown during handler execution |
null
for default processing
Log the given exception at warn level, provided that warn logging has been
activated through the "warnLogCategory"
property.
Calls buildLogMessage(Exception, HttpServletRequest)
in order to determine the concrete message to log.
Always passes the full exception to the logger.
ex | the exception that got thrown during handler execution |
---|---|
request | current HTTP request (useful for obtaining metadata) |
setWarnLogCategory(String)
buildLogMessage(Exception, HttpServletRequest)
Prepare the response for the exceptional case.
The default implementation prevents the response from being cached,
if the "preventResponseCaching"
property
has been set to "true".
ex | the exception that got thrown during handler execution |
---|---|
response | current HTTP response |
Prevents the response from being cached, through setting corresponding
HTTP headers. See http://www.mnot.net/cache_docs
.
response | current HTTP response |
---|
Check whether this resolver is supposed to apply to the given handler.
The default implementation checks against the specified mapped handlers and handler classes, if any.
request | current HTTP request |
---|---|
handler | the executed handler, or null if none chosen
at the time of the exception (for example, if multipart resolution failed) |