org.springframework.boot.web.servlet

Class FilterRegistrationBean

java.lang.Object

org.springframework.boot.web.servlet.RegistrationBean

org.springframework.boot.web.servlet.FilterRegistrationBean

All Implemented Interfaces:

ServletContextInitializer, Ordered

Direct Known Subclasses:

FilterRegistrationBean

public class FilterRegistrationBean
extends RegistrationBean

A ServletContextInitializer to register Filters in a Servlet 3.0+ container. Similar to the registration features provided by ServletContext but with a Spring Bean friendly design.

The Filter must be specified before calling onStartup(ServletContext). Registrations can be associated with URL patterns and/or servlets (either by name or via a ServletRegistrationBeans. When no URL pattern or servlets are specified the filter will be associated to '/*'. The filter name will be deduced if not specified.

Since:

1.4.0

Author:

Phillip Webb

See Also:

ServletContextInitializer, ServletContext.addFilter(String, Filter), DelegatingFilterProxyRegistrationBean

Field Summary

Fields

Modifier and Type	Field and Description
static int	REQUEST_WRAPPER_FILTER_MAX_ORDER Filters that wrap the servlet request should be ordered less than or equal to this.

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
FilterRegistrationBean() Create a new FilterRegistrationBean instance.
FilterRegistrationBean(Filter filter, ServletRegistrationBean... servletRegistrationBeans) Create a new FilterRegistrationBean instance to be registered with the specified ServletRegistrationBeans.

Method Summary

Modifier and Type	Method and Description
void	addServletNames(String... servletNames) Add servlet names for the filter.
void	addServletRegistrationBeans(ServletRegistrationBean... servletRegistrationBeans) Add ServletRegistrationBeans for the filter.
void	addUrlPatterns(String... urlPatterns) Add URL patterns that the filter will be registered against.
protected void	configure(FilterRegistration.Dynamic registration) Configure registration settings.
Filter	getFilter() Return the Filter to be registered.
Collection<String>	getServletNames() Return a mutable collection of servlet names that the filter will be registered against.
Collection<ServletRegistrationBean>	getServletRegistrationBeans() Return a mutable collection of the ServletRegistrationBean that the filter will be registered against.
Collection<String>	getUrlPatterns() Return a mutable collection of URL patterns that the filter will be registered against.
boolean	isMatchAfter() Return if filter mappings should be matched after any declared Filter mappings of the ServletContext.
void	onStartup(ServletContext servletContext) Configure the given ServletContext with any servlets, filters, listeners context-params and attributes necessary for initialization.
void	setDispatcherTypes(DispatcherType first, DispatcherType... rest) Convenience method to set dispatcher types using the specified elements.
void	setDispatcherTypes(EnumSet<DispatcherType> dispatcherTypes) Sets the dispatcher types that should be used with the registration.
void	setFilter(Filter filter) Set the filter to be registered.
void	setMatchAfter(boolean matchAfter) Set if the filter mappings should be matched after any declared filter mappings of the ServletContext.
void	setServletNames(Collection<String> servletNames) Set servlet names that the filter will be registered against.
void	setServletRegistrationBeans(Collection<? extends ServletRegistrationBean> servletRegistrationBeans) Set ServletRegistrationBeans that the filter will be registered against.
void	setUrlPatterns(Collection<String> urlPatterns) Set the URL patterns that the filter will be registered against.

Methods inherited from class org.springframework.boot.web.servlet.RegistrationBean

addInitParameter, configure, getInitParameters, getOrDeduceName, getOrder, isAsyncSupported, isEnabled, setAsyncSupported, setEnabled, setInitParameters, setName, setOrder

Methods inherited from class java.lang.Object

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

Field Detail

REQUEST_WRAPPER_FILTER_MAX_ORDER

public static final int REQUEST_WRAPPER_FILTER_MAX_ORDER

Filters that wrap the servlet request should be ordered less than or equal to this.

See Also:

Constant Field Values

Constructor Detail

FilterRegistrationBean

public FilterRegistrationBean()

Create a new FilterRegistrationBean instance.

FilterRegistrationBean

public FilterRegistrationBean(Filter filter,
                              ServletRegistrationBean... servletRegistrationBeans)

Create a new FilterRegistrationBean instance to be registered with the specified ServletRegistrationBeans.

Parameters:

filter - the filter to register

servletRegistrationBeans - associate ServletRegistrationBeans

Method Detail

getFilter

public Filter getFilter()

Return the Filter to be registered.

Returns:

the filter

setFilter

public void setFilter(Filter filter)

Set the filter to be registered.

Parameters:

filter - the filter

setServletRegistrationBeans

public void setServletRegistrationBeans(Collection<? extends ServletRegistrationBean> servletRegistrationBeans)

Set ServletRegistrationBeans that the filter will be registered against.

Parameters:

servletRegistrationBeans - the Servlet registration beans

getServletRegistrationBeans

public Collection<ServletRegistrationBean> getServletRegistrationBeans()

Return a mutable collection of the ServletRegistrationBean that the filter will be registered against. ServletRegistrationBeans.

Returns:

the Servlet registration beans

See Also:

setServletNames(java.util.Collection<java.lang.String>), setUrlPatterns(java.util.Collection<java.lang.String>)

addServletRegistrationBeans

public void addServletRegistrationBeans(ServletRegistrationBean... servletRegistrationBeans)

Add ServletRegistrationBeans for the filter.

Parameters:

servletRegistrationBeans - the servlet registration beans to add

See Also:

setServletRegistrationBeans(java.util.Collection<? extends org.springframework.boot.web.servlet.ServletRegistrationBean>)

setServletNames

public void setServletNames(Collection<String> servletNames)

Set servlet names that the filter will be registered against. This will replace any previously specified servlet names.

Parameters:

servletNames - the servlet names

See Also:

setServletRegistrationBeans(java.util.Collection<? extends org.springframework.boot.web.servlet.ServletRegistrationBean>), setUrlPatterns(java.util.Collection<java.lang.String>)

getServletNames

public Collection<String> getServletNames()

Return a mutable collection of servlet names that the filter will be registered against.

Returns:

the servlet names

addServletNames

public void addServletNames(String... servletNames)

Add servlet names for the filter.

Parameters:

servletNames - the servlet names to add

setUrlPatterns

public void setUrlPatterns(Collection<String> urlPatterns)

Set the URL patterns that the filter will be registered against. This will replace any previously specified URL patterns.

Parameters:

urlPatterns - the URL patterns

See Also:

setServletRegistrationBeans(java.util.Collection<? extends org.springframework.boot.web.servlet.ServletRegistrationBean>), setServletNames(java.util.Collection<java.lang.String>)

getUrlPatterns

public Collection<String> getUrlPatterns()

Return a mutable collection of URL patterns that the filter will be registered against.

Returns:

the URL patterns

addUrlPatterns

public void addUrlPatterns(String... urlPatterns)

Add URL patterns that the filter will be registered against.

Parameters:

urlPatterns - the URL patterns

setDispatcherTypes

public void setDispatcherTypes(DispatcherType first,
                               DispatcherType... rest)

Convenience method to set dispatcher types using the specified elements.

Parameters:

first - the first dispatcher type

rest - additional dispatcher types

setDispatcherTypes

public void setDispatcherTypes(EnumSet<DispatcherType> dispatcherTypes)

Sets the dispatcher types that should be used with the registration. If not specified the types will be deduced based on the value of RegistrationBean.isAsyncSupported().

Parameters:

dispatcherTypes - the dispatcher types

setMatchAfter

public void setMatchAfter(boolean matchAfter)

Set if the filter mappings should be matched after any declared filter mappings of the ServletContext. Defaults to false indicating the filters are supposed to be matched before any declared filter mappings of the ServletContext.

Parameters:

matchAfter - if filter mappings are matched after

isMatchAfter

public boolean isMatchAfter()

Return if filter mappings should be matched after any declared Filter mappings of the ServletContext.

Returns:

if filter mappings are matched after

onStartup

public void onStartup(ServletContext servletContext)
               throws ServletException

Description copied from interface: ServletContextInitializer

Configure the given ServletContext with any servlets, filters, listeners context-params and attributes necessary for initialization.

Parameters:

servletContext - the ServletContext to initialize

Throws:

ServletException - if any call against the given ServletContext throws a ServletException

configure

protected void configure(FilterRegistration.Dynamic registration)

Configure registration settings. Subclasses can override this method to perform additional configuration if required.

Parameters:

registration - the registration