org.springframework.boot.context.web

Class ErrorPageFilter

java.lang.Object

org.springframework.boot.context.embedded.AbstractConfigurableEmbeddedServletContainer

org.springframework.boot.context.web.ErrorPageFilter

All Implemented Interfaces:

Filter, ConfigurableEmbeddedServletContainer, NonEmbeddedServletContainerFactory

@Component
public class ErrorPageFilter
extends AbstractConfigurableEmbeddedServletContainer
implements Filter, NonEmbeddedServletContainerFactory

A special AbstractConfigurableEmbeddedServletContainer 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 container 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 EmbeddedServletContainerCustomizer (any beans of that type in the context will be applied to this container).

Author:

Dave Syer, Phillip Webb, Andy Wilkinson

Field Summary

Fields

Modifier and Type	Field and Description
static String	ERROR_REQUEST_URI

Constructor Summary

Constructors

Constructor and Description
ErrorPageFilter()

Method Summary

Methods

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)
void	init(FilterConfig filterConfig)

Methods inherited from class org.springframework.boot.context.embedded.AbstractConfigurableEmbeddedServletContainer

addInitializers, getAddress, getContextPath, getDocumentRoot, getErrorPages, getJspServletClassName, getMimeMappings, getPort, getSessionTimeout, getSsl, isRegisterDefaultServlet, isRegisterJspServlet, mergeInitializers, setAddress, setContextPath, setDocumentRoot, setErrorPages, setInitializers, setJspServletClassName, setMimeMappings, setPort, setRegisterDefaultServlet, setRegisterJspServlet, setSessionTimeout, setSessionTimeout, setSsl

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

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

addErrorPages

public void addErrorPages(ErrorPage... errorPages)

Description copied from interface: ConfigurableEmbeddedServletContainer

Adds error pages that will be used when handling exceptions.

Specified by:

addErrorPages in interface ConfigurableEmbeddedServletContainer

Overrides:

addErrorPages in class AbstractConfigurableEmbeddedServletContainer

Parameters:

errorPages - the error pages

destroy

public void destroy()

Specified by:

destroy in interface Filter