TomcatReactiveWebServerFactory (spring-boot 2.2.0.RELEASE)

java.lang.Object
- org.springframework.boot.web.server.AbstractConfigurableWebServerFactory
- - org.springframework.boot.web.reactive.server.AbstractReactiveWebServerFactory
  - - org.springframework.boot.web.embedded.tomcat.TomcatReactiveWebServerFactory

All Implemented Interfaces:

ConfigurableTomcatWebServerFactory, ConfigurableReactiveWebServerFactory, ReactiveWebServerFactory, ConfigurableWebServerFactory, ErrorPageRegistry, WebServerFactory
```
public class TomcatReactiveWebServerFactory
extends AbstractReactiveWebServerFactory
implements ConfigurableTomcatWebServerFactory
```
ReactiveWebServerFactory that can be used to create a TomcatWebServer.

Since:

2.0.0

Author:

Brian Clozel, HaiTao Zhang

Field Summary

Fields
Modifier and Type Field and Description

static String DEFAULT_PROTOCOL
The class name of default protocol used.

Fields
Modifier and Type	Field and Description
`static String`	`DEFAULT_PROTOCOL` The class name of default protocol used.

Constructor Summary

Constructors
Constructor and Description
`TomcatReactiveWebServerFactory()` Create a new `TomcatServletWebServerFactory` instance.
`TomcatReactiveWebServerFactory(int port)` Create a new `TomcatServletWebServerFactory` that listens for requests using the specified port.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAdditionalTomcatConnectors(org.apache.catalina.connector.Connector... connectors)` Add `Connector`s in addition to the default connector, e.g.
`void`	`addConnectorCustomizers(TomcatConnectorCustomizer... tomcatConnectorCustomizers)` Add `TomcatConnectorCustomizer`s that should be added to the Tomcat `Connector`.
`void`	`addContextCustomizers(TomcatContextCustomizer... tomcatContextCustomizers)` Add `TomcatContextCustomizer`s that should be added to the Tomcat `Context`.
`void`	`addContextLifecycleListeners(org.apache.catalina.LifecycleListener... contextLifecycleListeners)` Add `LifecycleListener`s that should be added to the Tomcat `Context`.
`void`	`addEngineValves(org.apache.catalina.Valve... engineValves)` Add `Valve`s that should be applied to the Tomcat `Engine`.
`void`	`addProtocolHandlerCustomizers(TomcatProtocolHandlerCustomizer<?>... tomcatProtocolHandlerCustomizers)` Add `TomcatProtocolHandlerCustomizer`s that should be added to the Tomcat `Connector`.
`protected void`	`configureContext(org.apache.catalina.Context context)` Configure the Tomcat `Context`.
`protected void`	`customizeConnector(org.apache.catalina.connector.Connector connector)`
`List<org.apache.catalina.connector.Connector>`	`getAdditionalTomcatConnectors()` Returns a mutable collection of the `Connector`s that will be added to the Tomcat.
`Collection<org.apache.catalina.LifecycleListener>`	`getContextLifecycleListeners()` Returns a mutable collection of the `LifecycleListener`s that will be applied to the Tomcat `Context`.
`List<org.apache.catalina.Valve>`	`getEngineValves()` Returns a mutable collection of the `Valve`s that will be applied to the Tomcat `Engine`.
`Collection<TomcatConnectorCustomizer>`	`getTomcatConnectorCustomizers()` Returns a mutable collection of the `TomcatConnectorCustomizer`s that will be applied to the Tomcat `Connector`.
`Collection<TomcatContextCustomizer>`	`getTomcatContextCustomizers()` Returns a mutable collection of the `TomcatContextCustomizer`s that will be applied to the Tomcat `Context`.
`Collection<TomcatProtocolHandlerCustomizer<?>>`	`getTomcatProtocolHandlerCustomizers()` Returns a mutable collection of the `TomcatProtocolHandlerCustomizer`s that will be applied to the Tomcat `Connector`.
`protected TomcatWebServer`	`getTomcatWebServer(org.apache.catalina.startup.Tomcat tomcat)` Factory method called to create the `TomcatWebServer`.
`Charset`	`getUriEncoding()` Returns the character encoding to use for URL decoding.
`WebServer`	`getWebServer(org.springframework.http.server.reactive.HttpHandler httpHandler)` Gets a new fully configured but paused `WebServer` instance.
`protected void`	`prepareContext(org.apache.catalina.Host host, org.springframework.http.server.reactive.TomcatHttpHandlerAdapter servlet)`
`void`	`setBackgroundProcessorDelay(int delay)` Sets the background processor delay in seconds.
`void`	`setBaseDirectory(File baseDirectory)` Set the Tomcat base directory.
`void`	`setContextLifecycleListeners(Collection<? extends org.apache.catalina.LifecycleListener> contextLifecycleListeners)` Set `LifecycleListener`s 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`	`setProtocol(String protocol)` The Tomcat protocol to use when create the `Connector`.
`void`	`setTomcatConnectorCustomizers(Collection<? extends TomcatConnectorCustomizer> tomcatConnectorCustomizers)` Set `TomcatConnectorCustomizer`s that should be applied to the Tomcat `Connector`.
`void`	`setTomcatContextCustomizers(Collection<? extends TomcatContextCustomizer> tomcatContextCustomizers)` Set `TomcatContextCustomizer`s that should be applied to the Tomcat `Context`.
`void`	`setTomcatProtocolHandlerCustomizers(Collection<? extends TomcatProtocolHandlerCustomizer<?>> tomcatProtocolHandlerCustomizers)` Set `TomcatProtocolHandlerCustomizer`s that should be applied to the Tomcat `Connector`.
`void`	`setUriEncoding(Charset uriEncoding)` Set the character encoding to use for URL decoding.

Methods inherited from class org.springframework.boot.web.server.AbstractConfigurableWebServerFactory
addErrorPages, createTempDir, getAddress, getCompression, getErrorPages, getHttp2, getPort, getServerHeader, getSsl, getSslStoreProvider, setAddress, setCompression, setErrorPages, setHttp2, setPort, setServerHeader, setSsl, setSslStoreProvider

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.springframework.boot.web.server.ConfigurableWebServerFactory
setAddress, setCompression, setErrorPages, setHttp2, setPort, setServerHeader, setSsl, setSslStoreProvider

Methods inherited from interface org.springframework.boot.web.server.ErrorPageRegistry
addErrorPages

- Field Detail
  - DEFAULT_PROTOCOL
```
public static final String DEFAULT_PROTOCOL
```
    The class name of default protocol used.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TomcatReactiveWebServerFactory
```
public TomcatReactiveWebServerFactory()
```
    Create a new TomcatServletWebServerFactory instance.
  - TomcatReactiveWebServerFactory
```
public TomcatReactiveWebServerFactory(int port)
```
    Create a new TomcatServletWebServerFactory that listens for requests using the specified port.
    
    Parameters:
    
    port - the port to listen on
- Method Detail
  - getWebServer
```
public WebServer getWebServer(org.springframework.http.server.reactive.HttpHandler httpHandler)
```
    Description copied from interface: ReactiveWebServerFactory
    
    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).
    
    Specified by:
    
    getWebServer in interface ReactiveWebServerFactory
    
    Parameters:
    
    httpHandler - the HTTP handler in charge of processing requests
    
    Returns:
    
    a fully configured and started WebServer
    
    See Also:
    
    WebServer.stop()
  - prepareContext
```
protected void prepareContext(org.apache.catalina.Host host,
                              org.springframework.http.server.reactive.TomcatHttpHandlerAdapter servlet)
```
  - configureContext
```
protected void configureContext(org.apache.catalina.Context context)
```
    Configure the Tomcat Context.
    
    Parameters:
    
    context - the Tomcat context
  - customizeConnector
```
protected void customizeConnector(org.apache.catalina.connector.Connector connector)
```
  - setBaseDirectory
```
public void setBaseDirectory(File baseDirectory)
```
    Description copied from interface: ConfigurableTomcatWebServerFactory
    
    Set the Tomcat base directory. If not specified a temporary directory will be used.
    
    Specified by:
    
    setBaseDirectory in interface ConfigurableTomcatWebServerFactory
    
    Parameters:
    
    baseDirectory - the tomcat base directory
  - setBackgroundProcessorDelay
```
public void setBackgroundProcessorDelay(int delay)
```
    Description copied from interface: ConfigurableTomcatWebServerFactory
    
    Sets the background processor delay in seconds.
    
    Specified by:
    
    setBackgroundProcessorDelay in interface ConfigurableTomcatWebServerFactory
    
    Parameters:
    
    delay - the delay in seconds
  - 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.
    
    Parameters:
    
    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.
    
    Returns:
    
    the listeners that will be applied
  - addContextCustomizers
```
public void addContextCustomizers(TomcatContextCustomizer... tomcatContextCustomizers)
```
    Add TomcatContextCustomizers that should be added to the Tomcat Context.
    
    Specified by:
    
    addContextCustomizers in interface ConfigurableTomcatWebServerFactory
    
    Parameters:
    
    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.
    
    Parameters:
    
    tomcatConnectorCustomizers - the customizers to set
  - addConnectorCustomizers
```
public void addConnectorCustomizers(TomcatConnectorCustomizer... tomcatConnectorCustomizers)
```
    Add TomcatConnectorCustomizers that should be added to the Tomcat Connector.
    
    Specified by:
    
    addConnectorCustomizers in interface ConfigurableTomcatWebServerFactory
    
    Parameters:
    
    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.
    
    Returns:
    
    the customizers that will be applied
  - setTomcatProtocolHandlerCustomizers
```
public void setTomcatProtocolHandlerCustomizers(Collection<? extends TomcatProtocolHandlerCustomizer<?>> tomcatProtocolHandlerCustomizers)
```
    Set TomcatProtocolHandlerCustomizers that should be applied to the Tomcat Connector. Calling this method will replace any existing customizers.
    
    Parameters:
    
    tomcatProtocolHandlerCustomizers - the customizers to set
    
    Since:
    
    2.2.0
  - addProtocolHandlerCustomizers
```
public void addProtocolHandlerCustomizers(TomcatProtocolHandlerCustomizer<?>... tomcatProtocolHandlerCustomizers)
```
    Add TomcatProtocolHandlerCustomizers that should be added to the Tomcat Connector.
    
    Specified by:
    
    addProtocolHandlerCustomizers in interface ConfigurableTomcatWebServerFactory
    
    Parameters:
    
    tomcatProtocolHandlerCustomizers - the customizers to add
    
    Since:
    
    2.2.0
  - getTomcatProtocolHandlerCustomizers
```
public Collection<TomcatProtocolHandlerCustomizer<?>> getTomcatProtocolHandlerCustomizers()
```
    Returns a mutable collection of the TomcatProtocolHandlerCustomizers that will be applied to the Tomcat Connector.
    
    Returns:
    
    the customizers that will be applied
    
    Since:
    
    2.2.0
  - addAdditionalTomcatConnectors
```
public void addAdditionalTomcatConnectors(org.apache.catalina.connector.Connector... connectors)
```
    Add Connectors in addition to the default connector, e.g. for SSL or AJP
    
    Parameters:
    
    connectors - the connectors to add
    
    Since:
    
    2.2.0
  - getAdditionalTomcatConnectors
```
public List<org.apache.catalina.connector.Connector> getAdditionalTomcatConnectors()
```
    Returns a mutable collection of the Connectors that will be added to the Tomcat.
    
    Returns:
    
    the additionalTomcatConnectors
    
    Since:
    
    2.2.0
  - addEngineValves
```
public void addEngineValves(org.apache.catalina.Valve... engineValves)
```
    Description copied from interface: ConfigurableTomcatWebServerFactory
    
    Add Valves that should be applied to the Tomcat Engine.
    
    Specified by:
    
    addEngineValves in interface ConfigurableTomcatWebServerFactory
    
    Parameters:
    
    engineValves - the valves to add
  - getEngineValves
```
public List<org.apache.catalina.Valve> getEngineValves()
```
    Returns a mutable collection of the Valves that will be applied to the Tomcat Engine.
    
    Returns:
    
    the engine valves that will be applied
  - setUriEncoding
```
public void setUriEncoding(Charset uriEncoding)
```
    Set the character encoding to use for URL decoding. If not specified 'UTF-8' will be used.
    
    Specified by:
    
    setUriEncoding in interface ConfigurableTomcatWebServerFactory
    
    Parameters:
    
    uriEncoding - the uri encoding to set
  - getUriEncoding
```
public Charset getUriEncoding()
```
    Returns the character encoding to use for URL decoding.
    
    Returns:
    
    the URI encoding
  - setContextLifecycleListeners
```
public void setContextLifecycleListeners(Collection<? extends org.apache.catalina.LifecycleListener> contextLifecycleListeners)
```
    Set LifecycleListeners that should be applied to the Tomcat Context. Calling this method will replace any existing listeners.
    
    Parameters:
    
    contextLifecycleListeners - the listeners to set
  - getContextLifecycleListeners
```
public Collection<org.apache.catalina.LifecycleListener> getContextLifecycleListeners()
```
    Returns a mutable collection of the LifecycleListeners that will be applied to the Tomcat Context.
    
    Returns:
    
    the context lifecycle listeners that will be applied
  - addContextLifecycleListeners
```
public void addContextLifecycleListeners(org.apache.catalina.LifecycleListener... contextLifecycleListeners)
```
    Add LifecycleListeners that should be added to the Tomcat Context.
    
    Parameters:
    
    contextLifecycleListeners - the listeners to add
  - getTomcatWebServer
```
protected TomcatWebServer getTomcatWebServer(org.apache.catalina.startup.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.
    
    Parameters:
    
    tomcat - the Tomcat server.
    
    Returns:
    
    a new TomcatWebServer instance
  - setProtocol
```
public void setProtocol(String protocol)
```
    The Tomcat protocol to use when create the Connector.
    
    Parameters:
    
    protocol - the protocol
    
    See Also:
    
    Connector.Connector(String)
  - setDisableMBeanRegistry
```
public void setDisableMBeanRegistry(boolean disableMBeanRegistry)
```
    Set whether the factory should disable Tomcat's MBean registry prior to creating the server.
    
    Parameters:
    
    disableMBeanRegistry - whether to disable the MBean registry
    
    Since:
    
    2.2.0

Class TomcatReactiveWebServerFactory

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.springframework.boot.web.server.AbstractConfigurableWebServerFactory

Methods inherited from class java.lang.Object

Methods inherited from interface org.springframework.boot.web.server.ConfigurableWebServerFactory

Methods inherited from interface org.springframework.boot.web.server.ErrorPageRegistry

Field Detail

DEFAULT_PROTOCOL

Constructor Detail

TomcatReactiveWebServerFactory

TomcatReactiveWebServerFactory

Method Detail

getWebServer

prepareContext

configureContext

customizeConnector

setBaseDirectory

setBackgroundProcessorDelay

setTomcatContextCustomizers

getTomcatContextCustomizers

addContextCustomizers

setTomcatConnectorCustomizers

addConnectorCustomizers

getTomcatConnectorCustomizers

setTomcatProtocolHandlerCustomizers

addProtocolHandlerCustomizers

getTomcatProtocolHandlerCustomizers

addAdditionalTomcatConnectors

getAdditionalTomcatConnectors

addEngineValves

getEngineValves

setUriEncoding

getUriEncoding

setContextLifecycleListeners

getContextLifecycleListeners

addContextLifecycleListeners

getTomcatWebServer

setProtocol

setDisableMBeanRegistry