org.springframework.boot.web.servlet.support

Class ErrorPageFilter

java.lang.Object

org.springframework.boot.web.servlet.support.ErrorPageFilter

All Implemented Interfaces:

Filter, ErrorPageRegistry, Ordered

public class ErrorPageFilter
extends Object
implements Filter, ErrorPageRegistry, Ordered

A Servlet Filter that provides an ErrorPageRegistry for non-embedded applications (i.e. deployed WAR files). It registers error pages and handles application errors by filtering requests and forwarding to the error pages instead of letting the server handle them. Error pages are a feature of the servlet spec but there is no Java API for registering them in the spec. This filter works around that by accepting error page registrations from Spring Boot's ErrorPageRegistrar (any beans of that type in the context will be applied to this server).

Since:

2.0.0

Author:

Dave Syer, Phillip Webb, Andy Wilkinson

Field Summary

Fields

Modifier and Type	Field and Description
static String	ERROR_REQUEST_URI The name of the servlet attribute containing request URI.

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
ErrorPageFilter()

Method Summary

Modifier and Type	Method and Description
void	addErrorPages(ErrorPage... errorPages) Adds error pages that will be used when handling exceptions.
void	destroy()
void	doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
protected String	getDescription(HttpServletRequest request) Return the description for the given request.
int	getOrder()
void	init(FilterConfig filterConfig)

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_REQUEST_URI

public static final String ERROR_REQUEST_URI

The name of the servlet attribute containing request URI.

See Also:

Constant Field Values

Constructor Detail

ErrorPageFilter

public ErrorPageFilter()

Method Detail

init

public void init(FilterConfig filterConfig)
          throws ServletException

Specified by:

init in interface Filter

Throws:

ServletException

doFilter

public void doFilter(ServletRequest request,
                     ServletResponse response,
                     FilterChain chain)
              throws IOException,
                     ServletException

Specified by:

doFilter in interface Filter

Throws:

IOException

ServletException

getDescription

protected String getDescription(HttpServletRequest request)

Return the description for the given request. By default this method will return a description based on the request servletPath and pathInfo.

Parameters:

request - the source request

Returns:

the description

Since:

1.5.0

addErrorPages

public void addErrorPages(ErrorPage... errorPages)

Description copied from interface: ErrorPageRegistry

Adds error pages that will be used when handling exceptions.

Specified by:

addErrorPages in interface ErrorPageRegistry

Parameters:

errorPages - the error pages

destroy

public void destroy()

Specified by:

destroy in interface Filter

getOrder

public int getOrder()

Specified by:

getOrder in interface Ordered