org.springframework.boot.web.embedded.tomcat

Class TomcatReactiveWebServerFactory

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:

ConfigurableReactiveWebServerFactory, ReactiveWebServerFactory, ConfigurableWebServerFactory, ErrorPageRegistry, WebServerFactory

public class TomcatReactiveWebServerFactory
extends AbstractReactiveWebServerFactory

ReactiveWebServerFactory that can be used to create a TomcatWebServer.

Since:

2.0.0

Author:

Brian Clozel

Field Summary

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

Modifier and Type	Method and Description
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.
protected void	configureContext(Context context) Configure the Tomcat Context.
protected void	customizeConnector(Connector connector)
Collection<LifecycleListener>	getContextLifecycleListeners() Returns a mutable collection of the LifecycleListeners that will be applied to the Tomcat Context .
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 .
protected TomcatWebServer	getTomcatWebServer(Tomcat tomcat) Factory method called to create the TomcatWebServer.
WebServer	getWebServer(org.springframework.http.server.reactive.HttpHandler httpHandler) Gets a new fully configured but paused WebServer instance.
protected void	prepareContext(Host host, org.springframework.http.server.reactive.TomcatHttpHandlerAdapter servlet)
void	setContextLifecycleListeners(Collection<? extends LifecycleListener> contextLifecycleListeners) Set LifecycleListeners that should be applied to the Tomcat Context .
void	setProtocol(String protocol) The Tomcat protocol to use when create the Connector.
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 .

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).

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(Host host,
                              org.springframework.http.server.reactive.TomcatHttpHandlerAdapter servlet)

configureContext

protected void configureContext(Context context)

Configure the Tomcat Context.

Parameters:

context - the Tomcat context

customizeConnector

protected void customizeConnector(Connector connector)

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.

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.

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

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.

Parameters:

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 .

Returns:

the context lifecycle listeners that will be applied

addContextLifecycleListeners

public void addContextLifecycleListeners(LifecycleListener... contextLifecycleListeners)

Add LifecycleListeners that should be added to the Tomcat Context.

Parameters:

contextLifecycleListeners - the listeners to add

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.

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)