org.springframework.boot.web.servlet

Class DelegatingFilterProxyRegistrationBean

java.lang.Object

org.springframework.boot.web.servlet.RegistrationBean

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

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

org.springframework.boot.web.servlet.DelegatingFilterProxyRegistrationBean

All Implemented Interfaces:

Aware, ServletContextInitializer, ApplicationContextAware, Ordered

public class DelegatingFilterProxyRegistrationBean
extends AbstractFilterRegistrationBean<DelegatingFilterProxy>
implements ApplicationContextAware

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

The bean name of the actual delegate Filter should be specified using the targetBeanName constructor argument. Unlike the FilterRegistrationBean, referenced filters are not instantiated early. In fact, if the delegate filter bean is marked @Lazy it won't be instantiated at all until the filter is called.

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 targetBeanName will be used as the filter name if not otherwise specified.

Since:

1.4.0

Author:

Phillip Webb

See Also:

ServletContextInitializer, ServletContext.addFilter(String, Filter), FilterRegistrationBean, DelegatingFilterProxy

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
DelegatingFilterProxyRegistrationBean(String targetBeanName, ServletRegistrationBean<?>... servletRegistrationBeans) Create a new DelegatingFilterProxyRegistrationBean instance to be registered with the specified ServletRegistrationBeans.

Method Summary

Modifier and Type	Method and Description
DelegatingFilterProxy	getFilter() Return the Filter to be registered.
protected String	getTargetBeanName()
void	setApplicationContext(ApplicationContext applicationContext)

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

addRegistration, addServletNames, addServletRegistrationBeans, addUrlPatterns, configure, getDescription, getServletNames, getServletRegistrationBeans, getUrlPatterns, isMatchAfter, setDispatcherTypes, setDispatcherTypes, setMatchAfter, setServletNames, setServletRegistrationBeans, setUrlPatterns, 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

Constructor Detail

DelegatingFilterProxyRegistrationBean

public DelegatingFilterProxyRegistrationBean(String targetBeanName,
                                             ServletRegistrationBean<?>... servletRegistrationBeans)

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

Parameters:

targetBeanName - name of the target filter bean to look up in the Spring application context (must not be null).

servletRegistrationBeans - associate ServletRegistrationBeans

Method Detail

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)
                           throws BeansException

Specified by:

setApplicationContext in interface ApplicationContextAware

Throws:

BeansException

getTargetBeanName

protected String getTargetBeanName()

getFilter

public DelegatingFilterProxy getFilter()

Description copied from class: AbstractFilterRegistrationBean

Return the Filter to be registered.

Specified by:

getFilter in class AbstractFilterRegistrationBean<DelegatingFilterProxy>

Returns:

the filter