Class AbstractDispatcherServletInitializer
- All Implemented Interfaces:
WebApplicationInitializer
- Direct Known Subclasses:
AbstractAnnotationConfigDispatcherServletInitializer
WebApplicationInitializer
implementations that register a DispatcherServlet
in the servlet context.
Most applications should consider extending the Spring Java config subclass
AbstractAnnotationConfigDispatcherServletInitializer
.
- Since:
- 3.2
- Author:
- Arjen Poutsma, Chris Beams, Rossen Stoyanchev, Juergen Hoeller, Stephane Nicoll
-
Field Summary
Fields inherited from class org.springframework.web.context.AbstractContextLoaderInitializer
logger
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected FrameworkServlet
createDispatcherServlet
(WebApplicationContext servletAppContext) Create aDispatcherServlet
(or other kind ofFrameworkServlet
-derived dispatcher) with the specifiedWebApplicationContext
.protected abstract WebApplicationContext
Create a servlet application context to be provided to theDispatcherServlet
.protected void
customizeRegistration
(ServletRegistration.Dynamic registration) Optionally perform further registration customization onceregisterDispatcherServlet(ServletContext)
has completed.protected ApplicationContextInitializer<?>[]
Specify application context initializers to be applied to the servlet-specific application context that theDispatcherServlet
is being created with.protected Filter[]
Specify filters to add and map to theDispatcherServlet
.protected abstract String[]
Specify the servlet mapping(s) for theDispatcherServlet
— for example"/"
,"/app"
, etc.protected String
Return the name under which theDispatcherServlet
will be registered.protected boolean
A single place to control theasyncSupported
flag for theDispatcherServlet
and all filters added viagetServletFilters()
.void
onStartup
(ServletContext servletContext) Configure the givenServletContext
with any servlets, filters, listeners context-params and attributes necessary for initializing this web application.protected void
registerDispatcherServlet
(ServletContext servletContext) Register aDispatcherServlet
against the given servlet context.protected FilterRegistration.Dynamic
registerServletFilter
(ServletContext servletContext, Filter filter) Add the given filter to the ServletContext and map it to theDispatcherServlet
as follows: a default filter name is chosen based on its concrete type theasyncSupported
flag is set depending on the return value ofasyncSupported
a filter mapping is created with dispatcher typesREQUEST
,FORWARD
,INCLUDE
, and conditionallyASYNC
depending on the return value ofasyncSupported
Methods inherited from class org.springframework.web.context.AbstractContextLoaderInitializer
createRootApplicationContext, getRootApplicationContextInitializers, registerContextLoaderListener
-
Field Details
-
DEFAULT_SERVLET_NAME
The default servlet name. Can be customized by overridinggetServletName()
.- See Also:
-
-
Constructor Details
-
AbstractDispatcherServletInitializer
public AbstractDispatcherServletInitializer()
-
-
Method Details
-
onStartup
Description copied from interface:WebApplicationInitializer
Configure the givenServletContext
with any servlets, filters, listeners context-params and attributes necessary for initializing this web application. See examples above.- Specified by:
onStartup
in interfaceWebApplicationInitializer
- Overrides:
onStartup
in classAbstractContextLoaderInitializer
- Parameters:
servletContext
- theServletContext
to initialize- Throws:
ServletException
- if any call against the givenServletContext
throws aServletException
-
registerDispatcherServlet
Register aDispatcherServlet
against the given servlet context.This method will create a
DispatcherServlet
with the name returned bygetServletName()
, initializing it with the application context returned fromcreateServletApplicationContext()
, and mapping it to the patterns returned fromgetServletMappings()
.Further customization can be achieved by overriding
customizeRegistration(ServletRegistration.Dynamic)
orcreateDispatcherServlet(WebApplicationContext)
.- Parameters:
servletContext
- the context to register the servlet against
-
getServletName
Return the name under which theDispatcherServlet
will be registered. Defaults toDEFAULT_SERVLET_NAME
. -
createServletApplicationContext
Create a servlet application context to be provided to theDispatcherServlet
.The returned context is delegated to Spring's
DispatcherServlet(WebApplicationContext)
. As such, it typically contains controllers, view resolvers, locale resolvers, and other web-related beans. -
createDispatcherServlet
Create aDispatcherServlet
(or other kind ofFrameworkServlet
-derived dispatcher) with the specifiedWebApplicationContext
.Note: This allows for any
FrameworkServlet
subclass as of 4.2.3. Previously, it insisted on returning aDispatcherServlet
or subclass thereof. -
getServletApplicationContextInitializers
Specify application context initializers to be applied to the servlet-specific application context that theDispatcherServlet
is being created with. -
getServletMappings
Specify the servlet mapping(s) for theDispatcherServlet
— for example"/"
,"/app"
, etc. -
getServletFilters
Specify filters to add and map to theDispatcherServlet
.- Returns:
- an array of filters or
null
- See Also:
-
registerServletFilter
protected FilterRegistration.Dynamic registerServletFilter(ServletContext servletContext, Filter filter) Add the given filter to the ServletContext and map it to theDispatcherServlet
as follows:- a default filter name is chosen based on its concrete type
- the
asyncSupported
flag is set depending on the return value ofasyncSupported
- a filter mapping is created with dispatcher types
REQUEST
,FORWARD
,INCLUDE
, and conditionallyASYNC
depending on the return value ofasyncSupported
If the above defaults are not suitable or insufficient, override this method and register filters directly with the
ServletContext
.- Parameters:
servletContext
- the servlet context to register filters withfilter
- the filter to be registered- Returns:
- the filter registration
-
isAsyncSupported
protected boolean isAsyncSupported()A single place to control theasyncSupported
flag for theDispatcherServlet
and all filters added viagetServletFilters()
.The default value is "true".
-
customizeRegistration
Optionally perform further registration customization onceregisterDispatcherServlet(ServletContext)
has completed.- Parameters:
registration
- theDispatcherServlet
registration to be customized- See Also:
-