org.springframework.boot.web.servlet

Class AbstractFilterRegistrationBean<T extends Filter>

java.lang.Object

org.springframework.boot.web.servlet.RegistrationBean

org.springframework.boot.web.servlet.DynamicRegistrationBean<FilterRegistration.Dynamic>

org.springframework.boot.web.servlet.AbstractFilterRegistrationBean<T>

Type Parameters:

T - the type of Filter to register

All Implemented Interfaces:

ServletContextInitializer, Ordered

Direct Known Subclasses:

DelegatingFilterProxyRegistrationBean, FilterRegistrationBean

public abstract class AbstractFilterRegistrationBean<T extends Filter>
extends DynamicRegistrationBean<FilterRegistration.Dynamic>

Abstract base ServletContextInitializer to register Filters in a Servlet 3.0+ container.

Since:

1.5.22

Author:

Phillip Webb, Brian Clozel

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Method Summary

Modifier and Type	Method and Description
protected FilterRegistration.Dynamic	addRegistration(String description, ServletContext servletContext)
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, as defined in the Servlet specification, that the filter will be registered against.
protected void	configure(FilterRegistration.Dynamic registration) Configure registration settings.
protected String	getDescription() Return a description of the registration.
abstract T	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, as defined in the Servlet specification, 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	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.
String	toString()

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

addInitParameter, getInitParameters, getOrDeduceName, isAsyncSupported, register, setAsyncSupported, setInitParameters, setName

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

getOrder, isEnabled, onStartup, setEnabled, setOrder

Methods inherited from class java.lang.Object

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

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, as defined in the Servlet specification, that the filter will be registered against.

Returns:

the URL patterns

addUrlPatterns

public void addUrlPatterns(String... urlPatterns)

Add URL patterns, as defined in the Servlet specification, 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 DynamicRegistrationBean.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

getDescription

protected String getDescription()

Description copied from class: RegistrationBean

Return a description of the registration. For example "Servlet resourceServlet"

Specified by:

getDescription in class RegistrationBean

Returns:

a description of the registration

addRegistration

protected FilterRegistration.Dynamic addRegistration(String description,
                                                     ServletContext servletContext)

Specified by:

addRegistration in class DynamicRegistrationBean<FilterRegistration.Dynamic>

configure

protected void configure(FilterRegistration.Dynamic registration)

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

Overrides:

configure in class DynamicRegistrationBean<FilterRegistration.Dynamic>

Parameters:

registration - the registration

getFilter

public abstract T getFilter()

Return the Filter to be registered.

Returns:

the filter

toString

public String toString()

Overrides:

toString in class Object