类 ServletRegistrationBean
- java.lang.Object
- org.springframework.boot.web.servlet.RegistrationBean
- org.springframework.boot.web.servlet.ServletRegistrationBean
- 所有已实现的接口:
ServletContextInitializer,org.springframework.core.Ordered
public class ServletRegistrationBean extends RegistrationBean
AServletContextInitializerto registerServlets in a Servlet 3.0+ container. Similar to theregistrationfeatures provided byServletContextbut with a Spring Bean friendly design.The
servletmust be specified before callingonStartup(javax.servlet.ServletContext). URL mapping can be configured usedsetUrlMappings(java.util.Collection<java.lang.String>)or omitted when mapping to '/*' (unlessalwaysMapUrlis set tofalse). The servlet name will be deduced if not specified.- 从以下版本开始:
- 1.4.0
- 另请参阅:
ServletContextInitializer,ServletContext.addServlet(String, Servlet)
构造器概要
构造器 构造器 说明 ServletRegistrationBean()Create a newServletRegistrationBeaninstance.ServletRegistrationBean(javax.servlet.Servlet servlet, boolean alwaysMapUrl, String... urlMappings)Create a newServletRegistrationBeaninstance with the specifiedServletand URL mappings.ServletRegistrationBean(javax.servlet.Servlet servlet, String... urlMappings)Create a newServletRegistrationBeaninstance with the specifiedServletand URL mappings.
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 voidaddUrlMappings(String... urlMappings)Add URL mappings for the servlet.protected voidconfigure(javax.servlet.ServletRegistration.Dynamic registration)Configure registration settings.javax.servlet.MultipartConfigElementgetMultipartConfig()Returns themulti-part configurationto be applied ornull.protected javax.servlet.ServletgetServlet()Returns the servlet being registered.StringgetServletName()Returns the servlet name that will be registered.Collection<String>getUrlMappings()Return a mutable collection of the URL mappings for the servlet.voidonStartup(javax.servlet.ServletContext servletContext)Configure the givenServletContextwith any servlets, filters, listeners context-params and attributes necessary for initialization.voidsetLoadOnStartup(int loadOnStartup)Sets theloadOnStartuppriority.voidsetMultipartConfig(javax.servlet.MultipartConfigElement multipartConfig)Set themulti-part configuration.voidsetServlet(javax.servlet.Servlet servlet)Sets the servlet to be registered.voidsetUrlMappings(Collection<String> urlMappings)Set the URL mappings for the servlet.从类继承的方法 org.springframework.boot.web.servlet.RegistrationBean
addInitParameter, configure, getInitParameters, getOrDeduceName, getOrder, isAsyncSupported, isEnabled, setAsyncSupported, setEnabled, setInitParameters, setName, setOrder
构造器详细资料
ServletRegistrationBean
public ServletRegistrationBean()
Create a newServletRegistrationBeaninstance.
ServletRegistrationBean
public ServletRegistrationBean(javax.servlet.Servlet servlet, String... urlMappings)
Create a newServletRegistrationBeaninstance with the specifiedServletand URL mappings.- 参数:
servlet- the servlet being mappedurlMappings- the URLs being mapped
ServletRegistrationBean
public ServletRegistrationBean(javax.servlet.Servlet servlet, boolean alwaysMapUrl, String... urlMappings)
Create a newServletRegistrationBeaninstance with the specifiedServletand URL mappings.- 参数:
servlet- the servlet being mappedalwaysMapUrl- if omitted URL mappings should be replaced with '/*'urlMappings- the URLs being mapped
方法详细资料
getServlet
protected javax.servlet.Servlet getServlet()
Returns the servlet being registered.- 返回:
- the servlet
setServlet
public void setServlet(javax.servlet.Servlet servlet)
Sets the servlet to be registered.- 参数:
servlet- the servlet
setUrlMappings
public void setUrlMappings(Collection<String> urlMappings)
Set the URL mappings for the servlet. If not specified the mapping will default to '/'. This will replace any previously specified mappings.- 参数:
urlMappings- the mappings to set- 另请参阅:
addUrlMappings(String...)
getUrlMappings
public Collection<String> getUrlMappings()
Return a mutable collection of the URL mappings for the servlet.- 返回:
- the urlMappings
addUrlMappings
public void addUrlMappings(String... urlMappings)
Add URL mappings for the servlet.- 参数:
urlMappings- the mappings to add- 另请参阅:
setUrlMappings(Collection)
setLoadOnStartup
public void setLoadOnStartup(int loadOnStartup)
Sets theloadOnStartuppriority. SeeServletRegistration.Dynamic.setLoadOnStartup(int)for details.- 参数:
loadOnStartup- if load on startup is enabled
setMultipartConfig
public void setMultipartConfig(javax.servlet.MultipartConfigElement multipartConfig)
Set themulti-part configuration.- 参数:
multipartConfig- the multi-part configuration to set ornull
getMultipartConfig
public javax.servlet.MultipartConfigElement getMultipartConfig()
Returns themulti-part configurationto be applied ornull.- 返回:
- the multipart config
getServletName
public String getServletName()
Returns the servlet name that will be registered.- 返回:
- the servlet name
onStartup
public void onStartup(javax.servlet.ServletContext servletContext) throws javax.servlet.ServletException
从接口复制的说明:ServletContextInitializerConfigure the givenServletContextwith any servlets, filters, listeners context-params and attributes necessary for initialization.- 参数:
servletContext- theServletContextto initialize- 抛出:
javax.servlet.ServletException- if any call against the givenServletContextthrows aServletException
configure
protected void configure(javax.servlet.ServletRegistration.Dynamic registration)
Configure registration settings. Subclasses can override this method to perform additional configuration if required.- 参数:
registration- the registration