程序包 org.springframework.boot.web.embedded.tomcat

类 TomcatServletWebServerFactory

java.lang.Object

org.springframework.boot.web.server.AbstractConfigurableWebServerFactory

org.springframework.boot.web.servlet.server.AbstractServletWebServerFactory

org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory

所有已实现的接口:

Aware, ConfigurableTomcatWebServerFactory, ConfigurableWebServerFactory, ErrorPageRegistry, WebServerFactory, ConfigurableServletWebServerFactory, ServletWebServerFactory, WebListenerRegistry, ResourceLoaderAware

public class TomcatServletWebServerFactory
extends AbstractServletWebServerFactory
implements ConfigurableTomcatWebServerFactory, ResourceLoaderAware

AbstractServletWebServerFactory that can be used to create TomcatWebServers. Can be initialized using Spring's ServletContextInitializers or Tomcat LifecycleListeners.

Unless explicitly configured otherwise this factory will create containers that listen for HTTP requests on port 8080.

从以下版本开始:

2.0.0

作者:

Phillip Webb, Dave Syer, Brock Mills, Stephane Nicoll, Andy Wilkinson, Eddú Meléndez, Christoffer Sawicki, Dawid Antecki, Moritz Halbritter, Scott Frederick

另请参阅:

• AbstractConfigurableWebServerFactory.setPort(int)
• setContextLifecycleListeners(Collection)
• TomcatWebServer

字段概要

字段

修饰符和类型	字段	说明
static final String	DEFAULT_PROTOCOL	The class name of default protocol used.

构造器概要

构造器

构造器	说明
TomcatServletWebServerFactory()	Create a new TomcatServletWebServerFactory instance.
TomcatServletWebServerFactory(int port)	Create a new TomcatServletWebServerFactory that listens for requests using the specified port.
TomcatServletWebServerFactory(String contextPath, int port)	Create a new TomcatServletWebServerFactory with the specified context path and port.

方法概要

修饰符和类型	方法	说明
void	addAdditionalTomcatConnectors(Connector... connectors)	Add Connectors in addition to the default connector, e.g. for SSL or AJP.
void	addConnectorCustomizers(TomcatConnectorCustomizer... tomcatConnectorCustomizers)	Add TomcatConnectorCustomizers that should be added to the Tomcat Connector.
void	addContextCustomizers(TomcatContextCustomizer... tomcatContextCustomizers)	Add TomcatContextCustomizers that should be added to the Tomcat Context.
void	addContextLifecycleListeners(LifecycleListener... contextLifecycleListeners)	Add LifecycleListeners that should be added to the Tomcat Context.
void	addContextValves(Valve... contextValves)	Add Valves that should be applied to the Tomcat Context.
void	addEngineValves(Valve... engineValves)	Add Valves that should be applied to the Tomcat Engine.
void	addProtocolHandlerCustomizers(TomcatProtocolHandlerCustomizer<?>... tomcatProtocolHandlerCustomizers)	Add TomcatProtocolHandlerCustomizers that should be added to the Tomcat Connector.
void	addTldSkipPatterns(String... patterns)	Add patterns that match jars to ignore for TLD scanning.
protected void	configureContext(Context context, ServletContextInitializer[] initializers)	Configure the Tomcat Context.
protected void	customizeConnector(Connector connector)
List<Connector>	getAdditionalTomcatConnectors()	Returns a mutable collection of the Connectors that will be added to the Tomcat.
Collection<LifecycleListener>	getContextLifecycleListeners()	Returns a mutable collection of the LifecycleListeners that will be applied to the Tomcat Context.
Collection<Valve>	getContextValves()	Returns a mutable collection of the Valves that will be applied to the Tomcat Context.
Collection<Valve>	getEngineValves()	Returns a mutable collection of the Valves that will be applied to the Tomcat Engine.
Set<String>	getTldSkipPatterns()	Returns a mutable set of the patterns that match jars to ignore for TLD scanning.
Collection<TomcatConnectorCustomizer>	getTomcatConnectorCustomizers()	Returns a mutable collection of the TomcatConnectorCustomizers that will be applied to the Tomcat Connector.
Collection<TomcatContextCustomizer>	getTomcatContextCustomizers()	Returns a mutable collection of the TomcatContextCustomizers that will be applied to the Tomcat Context.
Collection<TomcatProtocolHandlerCustomizer<?>>	getTomcatProtocolHandlerCustomizers()	Returns a mutable collection of the TomcatProtocolHandlerCustomizers that will be applied to the Tomcat Connector.
protected TomcatWebServer	getTomcatWebServer(Tomcat tomcat)	Factory method called to create the TomcatWebServer.
Charset	getUriEncoding()	Returns the character encoding to use for URL decoding.
WebServer	getWebServer(ServletContextInitializer... initializers)	Gets a new fully configured but paused WebServer instance.
protected void	postProcessContext(Context context)	Post process the Tomcat Context before it's used with the Tomcat Server.
protected void	prepareContext(Host host, ServletContextInitializer[] initializers)
void	setBackgroundProcessorDelay(int delay)	Sets the background processor delay in seconds.
void	setBaseDirectory(File baseDirectory)	Set the Tomcat base directory.
void	setContextLifecycleListeners(Collection<? extends LifecycleListener> contextLifecycleListeners)	Set LifecycleListeners that should be applied to the Tomcat Context.
void	setContextValves(Collection<? extends Valve> contextValves)	Set Valves that should be applied to the Tomcat Context.
void	setDisableMBeanRegistry(boolean disableMBeanRegistry)	Set whether the factory should disable Tomcat's MBean registry prior to creating the server.
void	setEngineValves(Collection<? extends Valve> engineValves)	Set Valves that should be applied to the Tomcat Engine.
void	setProtocol(String protocol)	The Tomcat protocol to use when create the Connector.
void	setResourceLoader(ResourceLoader resourceLoader)
void	setTldSkipPatterns(Collection<String> patterns)	Set the patterns that match jars to ignore for TLD scanning.
void	setTomcatConnectorCustomizers(Collection<? extends TomcatConnectorCustomizer> tomcatConnectorCustomizers)	Set TomcatConnectorCustomizers that should be applied to the Tomcat Connector.
void	setTomcatContextCustomizers(Collection<? extends TomcatContextCustomizer> tomcatContextCustomizers)	Set TomcatContextCustomizers that should be applied to the Tomcat Context.
void	setTomcatProtocolHandlerCustomizers(Collection<? extends TomcatProtocolHandlerCustomizer<?>> tomcatProtocolHandlerCustomizer)	Set TomcatProtocolHandlerCustomizers that should be applied to the Tomcat Connector.
void	setUriEncoding(Charset uriEncoding)	Set the character encoding to use for URL decoding.
void	setUseApr(boolean useApr)	Whether to use APR.

从类继承的方法 org.springframework.boot.web.servlet.server.AbstractServletWebServerFactory

addCookieSameSiteSuppliers, addInitializers, addMimeMappings, addWebListeners, getContextPath, getCookieSameSiteSuppliers, getDisplayName, getDocumentRoot, getInitParameters, getJsp, getLocaleCharsetMappings, getMimeMappings, getSession, getUrlsOfJarsWithMetaInfResources, getValidDocumentRoot, getValidSessionStoreDir, getValidSessionStoreDir, getWebListenerClassNames, isRegisterDefaultServlet, mergeInitializers, setContextPath, setCookieSameSiteSuppliers, setDisplayName, setDocumentRoot, setInitializers, setInitParameters, setJsp, setLocaleCharsetMappings, setMimeMappings, setRegisterDefaultServlet, setSession, shouldRegisterJspServlet

从类继承的方法 org.springframework.boot.web.server.AbstractConfigurableWebServerFactory

addErrorPages, createTempDir, getAddress, getCompression, getErrorPages, getHttp2, getPort, getServerHeader, getServerNameSslBundles, getShutdown, getSsl, getSslBundle, getSslBundles, setAddress, setCompression, setErrorPages, setHttp2, setPort, setServerHeader, setShutdown, setSsl, setSslBundles

从类继承的方法 java.lang.Object

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

从接口继承的方法 org.springframework.boot.web.server.ConfigurableWebServerFactory

setAddress, setCompression, setErrorPages, setHttp2, setPort, setServerHeader, setShutdown, setSsl, setSslBundles

从接口继承的方法 org.springframework.boot.web.server.ErrorPageRegistry

addErrorPages

字段详细资料

DEFAULT_PROTOCOL

public static final String DEFAULT_PROTOCOL

The class name of default protocol used.

另请参阅:

• 常量字段值

构造器详细资料

TomcatServletWebServerFactory

public TomcatServletWebServerFactory()

Create a new TomcatServletWebServerFactory instance.

TomcatServletWebServerFactory

public TomcatServletWebServerFactory(int port)

Create a new TomcatServletWebServerFactory that listens for requests using the specified port.

参数:

port - the port to listen on

TomcatServletWebServerFactory

public TomcatServletWebServerFactory(String contextPath,
 int port)

Create a new TomcatServletWebServerFactory with the specified context path and port.

参数:

contextPath - the root context path

port - the port to listen on

方法详细资料

getWebServer

public WebServer getWebServer(ServletContextInitializer... initializers)

从接口复制的说明: ServletWebServerFactory

Gets a new fully configured but paused WebServer instance. Clients should not be able to connect to the returned server until WebServer.start() is called (which happens when the ApplicationContext has been fully refreshed).

指定者:

getWebServer 在接口中 ServletWebServerFactory

参数:

initializers - ServletContextInitializers that should be applied as the server starts

返回:

a fully configured and started WebServer

另请参阅:

• WebServer.stop()

prepareContext

protected void prepareContext(Host host,
 ServletContextInitializer[] initializers)

customizeConnector

protected void customizeConnector(Connector connector)

configureContext

protected void configureContext(Context context,
 ServletContextInitializer[] initializers)

Configure the Tomcat Context.

参数:

context - the Tomcat context

initializers - initializers to apply

postProcessContext

protected void postProcessContext(Context context)

Post process the Tomcat Context before it's used with the Tomcat Server. Subclasses can override this method to apply additional processing to the Context.

参数:

context - the Tomcat Context

getTomcatWebServer

protected TomcatWebServer getTomcatWebServer(Tomcat tomcat)

Factory method called to create the TomcatWebServer. Subclasses can override this method to return a different TomcatWebServer or apply additional processing to the Tomcat server.

参数:

tomcat - the Tomcat server.

返回:

a new TomcatWebServer instance

setResourceLoader

public void setResourceLoader(ResourceLoader resourceLoader)

指定者:

setResourceLoader 在接口中 ResourceLoaderAware

setBaseDirectory

public void setBaseDirectory(File baseDirectory)

从接口复制的说明: ConfigurableTomcatWebServerFactory

Set the Tomcat base directory. If not specified a temporary directory will be used.

指定者:

setBaseDirectory 在接口中 ConfigurableTomcatWebServerFactory

参数:

baseDirectory - the tomcat base directory

getTldSkipPatterns

public Set<String> getTldSkipPatterns()

Returns a mutable set of the patterns that match jars to ignore for TLD scanning.

返回:

the set of jars to ignore for TLD scanning

setTldSkipPatterns

public void setTldSkipPatterns(Collection<String> patterns)

Set the patterns that match jars to ignore for TLD scanning. See Tomcat's catalina.properties for typical values. Defaults to a list drawn from that source.

参数:

patterns - the jar patterns to skip when scanning for TLDs etc

addTldSkipPatterns

public void addTldSkipPatterns(String... patterns)

Add patterns that match jars to ignore for TLD scanning. See Tomcat's catalina.properties for typical values.

参数:

patterns - the additional jar patterns to skip when scanning for TLDs etc

setProtocol

public void setProtocol(String protocol)

The Tomcat protocol to use when create the Connector.

参数:

protocol - the protocol

另请参阅:

• Connector(String)

setEngineValves

public void setEngineValves(Collection<? extends Valve> engineValves)

Set Valves that should be applied to the Tomcat Engine. Calling this method will replace any existing valves.

参数:

engineValves - the valves to set

getEngineValves

public Collection<Valve> getEngineValves()

Returns a mutable collection of the Valves that will be applied to the Tomcat Engine.

返回:

the engine valves that will be applied

addEngineValves

public void addEngineValves(Valve... engineValves)

从接口复制的说明: ConfigurableTomcatWebServerFactory

Add Valves that should be applied to the Tomcat Engine.

指定者:

addEngineValves 在接口中 ConfigurableTomcatWebServerFactory

参数:

engineValves - the valves to add

setContextValves

public void setContextValves(Collection<? extends Valve> contextValves)

Set Valves that should be applied to the Tomcat Context. Calling this method will replace any existing valves.

参数:

contextValves - the valves to set

getContextValves

public Collection<Valve> getContextValves()

Returns a mutable collection of the Valves that will be applied to the Tomcat Context.

返回:

the context valves that will be applied

另请参阅:

• getEngineValves()

addContextValves

public void addContextValves(Valve... contextValves)

Add Valves that should be applied to the Tomcat Context.

参数:

contextValves - the valves to add

setContextLifecycleListeners

public void setContextLifecycleListeners(Collection<? extends LifecycleListener> contextLifecycleListeners)

Set LifecycleListeners that should be applied to the Tomcat Context. Calling this method will replace any existing listeners.

参数:

contextLifecycleListeners - the listeners to set

getContextLifecycleListeners

public Collection<LifecycleListener> getContextLifecycleListeners()

Returns a mutable collection of the LifecycleListeners that will be applied to the Tomcat Context.

返回:

the context lifecycle listeners that will be applied

addContextLifecycleListeners

public void addContextLifecycleListeners(LifecycleListener... contextLifecycleListeners)

Add LifecycleListeners that should be added to the Tomcat Context.

参数:

contextLifecycleListeners - the listeners to add

setTomcatContextCustomizers

public void setTomcatContextCustomizers(Collection<? extends TomcatContextCustomizer> tomcatContextCustomizers)

Set TomcatContextCustomizers that should be applied to the Tomcat Context. Calling this method will replace any existing customizers.

参数:

tomcatContextCustomizers - the customizers to set

getTomcatContextCustomizers

public Collection<TomcatContextCustomizer> getTomcatContextCustomizers()

Returns a mutable collection of the TomcatContextCustomizers that will be applied to the Tomcat Context.

返回:

the listeners that will be applied

addContextCustomizers

public void addContextCustomizers(TomcatContextCustomizer... tomcatContextCustomizers)

从接口复制的说明: ConfigurableTomcatWebServerFactory

Add TomcatContextCustomizers that should be added to the Tomcat Context.

指定者:

addContextCustomizers 在接口中 ConfigurableTomcatWebServerFactory

参数:

tomcatContextCustomizers - the customizers to add

setTomcatConnectorCustomizers

public void setTomcatConnectorCustomizers(Collection<? extends TomcatConnectorCustomizer> tomcatConnectorCustomizers)

Set TomcatConnectorCustomizers that should be applied to the Tomcat Connector. Calling this method will replace any existing customizers.

参数:

tomcatConnectorCustomizers - the customizers to set

addConnectorCustomizers

public void addConnectorCustomizers(TomcatConnectorCustomizer... tomcatConnectorCustomizers)

从接口复制的说明: ConfigurableTomcatWebServerFactory

Add TomcatConnectorCustomizers that should be added to the Tomcat Connector.

指定者:

addConnectorCustomizers 在接口中 ConfigurableTomcatWebServerFactory

参数:

tomcatConnectorCustomizers - the customizers to add

getTomcatConnectorCustomizers

public Collection<TomcatConnectorCustomizer> getTomcatConnectorCustomizers()

Returns a mutable collection of the TomcatConnectorCustomizers that will be applied to the Tomcat Connector.

返回:

the customizers that will be applied

setTomcatProtocolHandlerCustomizers

public void setTomcatProtocolHandlerCustomizers(Collection<? extends TomcatProtocolHandlerCustomizer<?>> tomcatProtocolHandlerCustomizer)

Set TomcatProtocolHandlerCustomizers that should be applied to the Tomcat Connector. Calling this method will replace any existing customizers.

参数:

tomcatProtocolHandlerCustomizer - the customizers to set

从以下版本开始:

2.2.0

addProtocolHandlerCustomizers

public void addProtocolHandlerCustomizers(TomcatProtocolHandlerCustomizer<?>... tomcatProtocolHandlerCustomizers)

Add TomcatProtocolHandlerCustomizers that should be added to the Tomcat Connector.

指定者:

addProtocolHandlerCustomizers 在接口中 ConfigurableTomcatWebServerFactory

参数:

tomcatProtocolHandlerCustomizers - the customizers to add

从以下版本开始:

2.2.0

getTomcatProtocolHandlerCustomizers

public Collection<TomcatProtocolHandlerCustomizer<?>> getTomcatProtocolHandlerCustomizers()

Returns a mutable collection of the TomcatProtocolHandlerCustomizers that will be applied to the Tomcat Connector.

返回:

the customizers that will be applied

从以下版本开始:

2.2.0

addAdditionalTomcatConnectors

public void addAdditionalTomcatConnectors(Connector... connectors)

Add Connectors in addition to the default connector, e.g. for SSL or AJP.

Connector customizers are not applied to connectors added this way.

参数:

connectors - the connectors to add

getAdditionalTomcatConnectors

public List<Connector> getAdditionalTomcatConnectors()

Returns a mutable collection of the Connectors that will be added to the Tomcat.

返回:

the additionalTomcatConnectors

setUriEncoding

public void setUriEncoding(Charset uriEncoding)

从接口复制的说明: ConfigurableTomcatWebServerFactory

Set the character encoding to use for URL decoding. If not specified 'UTF-8' will be used.

指定者:

setUriEncoding 在接口中 ConfigurableTomcatWebServerFactory

参数:

uriEncoding - the uri encoding to set

getUriEncoding

public Charset getUriEncoding()

Returns the character encoding to use for URL decoding.

返回:

the URI encoding

setBackgroundProcessorDelay

public void setBackgroundProcessorDelay(int delay)

从接口复制的说明: ConfigurableTomcatWebServerFactory

Sets the background processor delay in seconds.

指定者:

setBackgroundProcessorDelay 在接口中 ConfigurableTomcatWebServerFactory

参数:

delay - the delay in seconds

setDisableMBeanRegistry

public void setDisableMBeanRegistry(boolean disableMBeanRegistry)

Set whether the factory should disable Tomcat's MBean registry prior to creating the server.

参数:

disableMBeanRegistry - whether to disable the MBean registry

从以下版本开始:

2.2.0

setUseApr

public void setUseApr(boolean useApr)

Whether to use APR.

参数:

useApr - whether to use APR

从以下版本开始:

3.4.4