org.springframework.boot.context.embedded

Class FilterRegistrationBean

java.lang.Object

org.springframework.boot.web.servlet.RegistrationBean

org.springframework.boot.web.servlet.FilterRegistrationBean

org.springframework.boot.context.embedded.FilterRegistrationBean

All Implemented Interfaces:

ServletContextInitializer, Ordered

Deprecated.

as of 1.4 in favor of FilterRegistrationBean

@Deprecated
public class FilterRegistrationBean
extends FilterRegistrationBean
implements ServletContextInitializer

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.

Author:

Phillip Webb

See Also:

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

Field Summary

Fields inherited from class org.springframework.boot.web.servlet.FilterRegistrationBean

REQUEST_WRAPPER_FILTER_MAX_ORDER

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
FilterRegistrationBean() Deprecated.
FilterRegistrationBean(Filter filter, ServletRegistrationBean... servletRegistrationBeans) Deprecated.

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.
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	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.FilterRegistrationBean

getFilter, setFilter

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

Methods inherited from interface org.springframework.boot.web.servlet.ServletContextInitializer

onStartup

Constructor Detail

FilterRegistrationBean

public FilterRegistrationBean()

Deprecated.

FilterRegistrationBean

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

Deprecated.

Method Detail

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