org.springframework.boot.web.embedded.undertow

Class UndertowServletWebServerFactory

java.lang.Object

org.springframework.boot.web.server.AbstractConfigurableWebServerFactory

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

org.springframework.boot.web.embedded.undertow.UndertowServletWebServerFactory

All Implemented Interfaces:

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

public class UndertowServletWebServerFactory
extends AbstractServletWebServerFactory
implements ResourceLoaderAware

ServletWebServerFactory that can be used to create UndertowServletWebServers.

Unless explicitly configured otherwise, the factory will create servers that listen for HTTP requests on port 8080.

Since:

2.0.0

Author:

Ivan Sopov, Andy Wilkinson, Marcos Barbero, Eddú Meléndez

See Also:

UndertowServletWebServer

Field Summary

Fields inherited from class org.springframework.boot.web.servlet.server.AbstractServletWebServerFactory

logger

Constructor Summary

Constructors

Constructor and Description
UndertowServletWebServerFactory() Create a new UndertowServletWebServerFactory instance.
UndertowServletWebServerFactory(int port) Create a new UndertowServletWebServerFactory that listens for requests using the specified port.
UndertowServletWebServerFactory(String contextPath, int port) Create a new UndertowServletWebServerFactory with the specified context path and port.

Method Summary

Modifier and Type	Method and Description
void	addBuilderCustomizers(UndertowBuilderCustomizer... customizers) Add UndertowBuilderCustomizers that should be used to customize the Undertow Undertow.Builder.
void	addDeploymentInfoCustomizers(UndertowDeploymentInfoCustomizer... customizers) Add UndertowDeploymentInfoCustomizers that should be used to customize the Undertow DeploymentInfo.
String	getAccessLogPrefix()
Collection<UndertowBuilderCustomizer>	getBuilderCustomizers() Returns a mutable collection of the UndertowBuilderCustomizers that will be applied to the Undertow Undertow.Builder .
Collection<UndertowDeploymentInfoCustomizer>	getDeploymentInfoCustomizers() Returns a mutable collection of the UndertowDeploymentInfoCustomizers that will be applied to the Undertow DeploymentInfo .
protected UndertowServletWebServer	getUndertowWebServer(io.undertow.Undertow.Builder builder, io.undertow.servlet.api.DeploymentManager manager, int port) Factory method called to create the UndertowServletWebServer.
WebServer	getWebServer(ServletContextInitializer... initializers) Gets a new fully configured but paused WebServer instance.
boolean	isAccessLogEnabled()
boolean	isEagerInitFilters() Return if filters should be initialized eagerly.
protected boolean	isUseForwardHeaders()
void	setAccessLogDirectory(File accessLogDirectory)
void	setAccessLogEnabled(boolean accessLogEnabled)
void	setAccessLogPattern(String accessLogPattern)
void	setAccessLogPrefix(String accessLogPrefix)
void	setAccessLogRotate(boolean accessLogRotate)
void	setAccessLogSuffix(String accessLogSuffix)
void	setBufferSize(Integer bufferSize)
void	setBuilderCustomizers(Collection<? extends UndertowBuilderCustomizer> customizers) Set UndertowBuilderCustomizers that should be applied to the Undertow Undertow.Builder.
void	setDeploymentInfoCustomizers(Collection<? extends UndertowDeploymentInfoCustomizer> customizers) Set UndertowDeploymentInfoCustomizers that should be applied to the Undertow DeploymentInfo.
void	setDirectBuffers(Boolean directBuffers)
void	setEagerInitFilters(boolean eagerInitFilters) Set whether filters should be initialized eagerly.
void	setIoThreads(Integer ioThreads)
void	setResourceLoader(ResourceLoader resourceLoader)
void	setUseForwardHeaders(boolean useForwardHeaders) Set if x-forward-* headers should be processed.
void	setWorkerThreads(Integer workerThreads)

Methods inherited from class org.springframework.boot.web.servlet.server.AbstractServletWebServerFactory

addInitializers, getContextPath, getDisplayName, getDocumentRoot, getJsp, getLocaleCharsetMappings, getMimeMappings, getSessionStoreDir, getSessionTimeout, getUrlsOfJarsWithMetaInfResources, getValidDocumentRoot, getValidSessionStoreDir, getValidSessionStoreDir, isPersistSession, isRegisterDefaultServlet, mergeInitializers, setContextPath, setDisplayName, setDocumentRoot, setInitializers, setJsp, setLocaleCharsetMappings, setMimeMappings, setPersistSession, setRegisterDefaultServlet, setSessionStoreDir, setSessionTimeout, setSessionTimeout, shouldRegisterJspServlet

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

addErrorPages, createTempDir, getAddress, getCompression, getErrorPages, getPort, getServerHeader, getSsl, getSslStoreProvider, setAddress, setCompression, setErrorPages, 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, setPort, setServerHeader, setSsl, setSslStoreProvider

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

addErrorPages

Constructor Detail

UndertowServletWebServerFactory

public UndertowServletWebServerFactory()

Create a new UndertowServletWebServerFactory instance.

UndertowServletWebServerFactory

public UndertowServletWebServerFactory(int port)

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

Parameters:

port - the port to listen on

UndertowServletWebServerFactory

public UndertowServletWebServerFactory(String contextPath,
                                       int port)

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

Parameters:

contextPath - the root context path

port - the port to listen on

Method Detail

setBuilderCustomizers

public void setBuilderCustomizers(Collection<? extends UndertowBuilderCustomizer> customizers)

Set UndertowBuilderCustomizers that should be applied to the Undertow Undertow.Builder. Calling this method will replace any existing customizers.

Parameters:

customizers - the customizers to set

getBuilderCustomizers

public Collection<UndertowBuilderCustomizer> getBuilderCustomizers()

Returns a mutable collection of the UndertowBuilderCustomizers that will be applied to the Undertow Undertow.Builder .

Returns:

the customizers that will be applied

addBuilderCustomizers

public void addBuilderCustomizers(UndertowBuilderCustomizer... customizers)

Add UndertowBuilderCustomizers that should be used to customize the Undertow Undertow.Builder.

Parameters:

customizers - the customizers to add

setDeploymentInfoCustomizers

public void setDeploymentInfoCustomizers(Collection<? extends UndertowDeploymentInfoCustomizer> customizers)

Set UndertowDeploymentInfoCustomizers that should be applied to the Undertow DeploymentInfo. Calling this method will replace any existing customizers.

Parameters:

customizers - the customizers to set

getDeploymentInfoCustomizers

public Collection<UndertowDeploymentInfoCustomizer> getDeploymentInfoCustomizers()

Returns a mutable collection of the UndertowDeploymentInfoCustomizers that will be applied to the Undertow DeploymentInfo .

Returns:

the customizers that will be applied

addDeploymentInfoCustomizers

public void addDeploymentInfoCustomizers(UndertowDeploymentInfoCustomizer... customizers)

Add UndertowDeploymentInfoCustomizers that should be used to customize the Undertow DeploymentInfo.

Parameters:

customizers - the customizers to add

getWebServer

public WebServer getWebServer(ServletContextInitializer... initializers)

Description copied from interface: 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).

Specified by:

getWebServer in interface ServletWebServerFactory

Parameters:

initializers - ServletContextInitializers that should be applied as the server starts

Returns:

a fully configured and started WebServer

See Also:

WebServer.stop()

getUndertowWebServer

protected UndertowServletWebServer getUndertowWebServer(io.undertow.Undertow.Builder builder,
                                                        io.undertow.servlet.api.DeploymentManager manager,
                                                        int port)

Factory method called to create the UndertowServletWebServer. Subclasses can override this method to return a different UndertowServletWebServer or apply additional processing to the Undertow.Builder and DeploymentManager used to bootstrap Undertow

Parameters:

builder - the builder

manager - the deployment manager

port - the port that Undertow should listen on

Returns:

a new UndertowServletWebServer instance

setResourceLoader

public void setResourceLoader(ResourceLoader resourceLoader)

Specified by:

setResourceLoader in interface ResourceLoaderAware

setBufferSize

public void setBufferSize(Integer bufferSize)

setIoThreads

public void setIoThreads(Integer ioThreads)

setWorkerThreads

public void setWorkerThreads(Integer workerThreads)

setDirectBuffers

public void setDirectBuffers(Boolean directBuffers)

setAccessLogDirectory

public void setAccessLogDirectory(File accessLogDirectory)

setAccessLogPattern

public void setAccessLogPattern(String accessLogPattern)

getAccessLogPrefix

public String getAccessLogPrefix()

setAccessLogPrefix

public void setAccessLogPrefix(String accessLogPrefix)

setAccessLogSuffix

public void setAccessLogSuffix(String accessLogSuffix)

setAccessLogEnabled

public void setAccessLogEnabled(boolean accessLogEnabled)

isAccessLogEnabled

public boolean isAccessLogEnabled()

setAccessLogRotate

public void setAccessLogRotate(boolean accessLogRotate)

isUseForwardHeaders

protected final boolean isUseForwardHeaders()

setUseForwardHeaders

public void setUseForwardHeaders(boolean useForwardHeaders)

Set if x-forward-* headers should be processed.

Parameters:

useForwardHeaders - if x-forward headers should be used

Since:

1.3.0

isEagerInitFilters

public boolean isEagerInitFilters()

Return if filters should be initialized eagerly.

Returns:

true if filters are initialized eagerly, otherwise false.

Since:

2.0.0

setEagerInitFilters

public void setEagerInitFilters(boolean eagerInitFilters)

Set whether filters should be initialized eagerly.

Parameters:

eagerInitFilters - true if filters are initialized eagerly, otherwise false.

Since:

2.0.0