org.springframework.web.servlet.mvc.annotation

Class ResponseStatusExceptionResolver

java.lang.Object

org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver

org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolver

All Implemented Interfaces:

Aware, MessageSourceAware, Ordered, HandlerExceptionResolver

public class ResponseStatusExceptionResolver
extends AbstractHandlerExceptionResolver
implements MessageSourceAware

A HandlerExceptionResolver that uses the @ResponseStatus annotation to map exceptions to HTTP status codes.

This exception resolver is enabled by default in the DispatcherServlet and the MVC Java config and the MVC namespace.

As of 4.2 this resolver also looks recursively for @ResponseStatus present on cause exceptions, and as of 4.2.2 this resolver supports attribute overrides for @ResponseStatus in custom composed annotations.

As of 5.0 this resolver also supports ResponseStatusException.

Since:

3.0

Author:

Arjen Poutsma, Rossen Stoyanchev, Sam Brannen

See Also:

ResponseStatus, ResponseStatusException

Field Summary

Fields inherited from class org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver

logger

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
ResponseStatusExceptionResolver()

Method Summary

Modifier and Type	Method and Description
protected ModelAndView	applyStatusAndReason(int statusCode, java.lang.String reason, HttpServletResponse response) Apply the resolved status code and reason to the response.
protected ModelAndView	doResolveException(HttpServletRequest request, HttpServletResponse response, java.lang.Object handler, java.lang.Exception ex) Actually resolve the given exception that got thrown during handler execution, returning a ModelAndView that represents a specific error page if appropriate.
protected ModelAndView	resolveResponseStatus(ResponseStatus responseStatus, HttpServletRequest request, HttpServletResponse response, java.lang.Object handler, java.lang.Exception ex) Template method that handles the @ResponseStatus annotation.
protected ModelAndView	resolveResponseStatusException(ResponseStatusException ex, HttpServletRequest request, HttpServletResponse response, java.lang.Object handler) Template method that handles an ResponseStatusException.
void	setMessageSource(MessageSource messageSource) Set the MessageSource that this object runs in.

Methods inherited from class org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver

buildLogMessage, getOrder, logException, prepareResponse, preventCaching, resolveException, setMappedHandlerClasses, setMappedHandlers, setOrder, setPreventResponseCaching, setWarnLogCategory, shouldApplyTo

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ResponseStatusExceptionResolver

public ResponseStatusExceptionResolver()

Method Detail

setMessageSource

public void setMessageSource(MessageSource messageSource)

Description copied from interface: MessageSourceAware

Set the MessageSource that this object runs in.

Invoked after population of normal bean properties but before an init callback like InitializingBean's afterPropertiesSet or a custom init-method. Invoked before ApplicationContextAware's setApplicationContext.

Specified by:

setMessageSource in interface MessageSourceAware

Parameters:

messageSource - message source to be used by this object

doResolveException

@Nullable
protected ModelAndView doResolveException(HttpServletRequest request,
                                                    HttpServletResponse response,
                                                    @Nullable
                                                    java.lang.Object handler,
                                                    java.lang.Exception ex)

Description copied from class: AbstractHandlerExceptionResolver

Actually resolve the given exception that got thrown during 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.

Specified by:

doResolveException in class AbstractHandlerExceptionResolver

Parameters:

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

Returns:

a corresponding ModelAndView to forward to, or null for default processing in the resolution chain

resolveResponseStatus

protected ModelAndView resolveResponseStatus(ResponseStatus responseStatus,
                                             HttpServletRequest request,
                                             HttpServletResponse response,
                                             @Nullable
                                             java.lang.Object handler,
                                             java.lang.Exception ex)
                                      throws java.lang.Exception

Template method that handles the @ResponseStatus annotation.

The default implementation delegates to applyStatusAndReason(int, java.lang.String, javax.servlet.http.HttpServletResponse) with the status code and reason from the annotation.

Parameters:

responseStatus - the @ResponseStatus annotation

request - current HTTP request

response - current HTTP response

handler - the executed handler, or null if none chosen at the time of the exception, e.g. if multipart resolution failed

ex - the exception

Returns:

an empty ModelAndView, i.e. exception resolved

Throws:

java.lang.Exception

resolveResponseStatusException

protected ModelAndView resolveResponseStatusException(ResponseStatusException ex,
                                                      HttpServletRequest request,
                                                      HttpServletResponse response,
                                                      @Nullable
                                                      java.lang.Object handler)
                                               throws java.lang.Exception

Template method that handles an ResponseStatusException.

The default implementation delegates to applyStatusAndReason(int, java.lang.String, javax.servlet.http.HttpServletResponse) with the status code and reason from the exception.

Parameters:

ex - the exception

request - current HTTP request

response - current HTTP response

handler - the executed handler, or null if none chosen at the time of the exception, e.g. if multipart resolution failed

Returns:

an empty ModelAndView, i.e. exception resolved

Throws:

java.lang.Exception

Since:

5.0

applyStatusAndReason

protected ModelAndView applyStatusAndReason(int statusCode,
                                            @Nullable
                                            java.lang.String reason,
                                            HttpServletResponse response)
                                     throws java.io.IOException

Apply the resolved status code and reason to the response.

The default implementation sends a response error using HttpServletResponse.sendError(int) or HttpServletResponse.sendError(int, String) if there is a reason and then returns an empty ModelAndView.

Parameters:

statusCode - the HTTP status code

reason - the associated reason (may be null or empty)

response - current HTTP response

Throws:

java.io.IOException

Since:

5.0