UndertowServletWebServerFactory (spring-boot 2.6.6)

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:

org.springframework.beans.factory.Aware, ConfigurableUndertowWebServerFactory, ConfigurableWebServerFactory, ErrorPageRegistry, WebServerFactory, ConfigurableServletWebServerFactory, ServletWebServerFactory, WebListenerRegistry, org.springframework.context.ResourceLoaderAware
```
public class UndertowServletWebServerFactory
extends AbstractServletWebServerFactory
implements ConfigurableUndertowWebServerFactory, org.springframework.context.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

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(java.lang.String contextPath, int port)` Create a new `UndertowServletWebServerFactory` with the specified context path and port.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addBuilderCustomizers(UndertowBuilderCustomizer... customizers)` Add `UndertowBuilderCustomizer`s that should be used to customize the Undertow `Undertow.Builder`.
`void`	`addDeploymentInfoCustomizers(UndertowDeploymentInfoCustomizer... customizers)` Add `UndertowDeploymentInfoCustomizer`s that should be used to customize the Undertow `DeploymentInfo`.
`java.lang.String`	`getAccessLogPrefix()`
`java.util.Collection<UndertowBuilderCustomizer>`	`getBuilderCustomizers()` Returns a mutable collection of the `UndertowBuilderCustomizer`s that will be applied to the Undertow `Undertow.Builder`.
`java.util.Collection<UndertowDeploymentInfoCustomizer>`	`getDeploymentInfoCustomizers()` Returns a mutable collection of the `UndertowDeploymentInfoCustomizer`s 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`	`isEagerFilterInit()` Return if filters should be eagerly initialized.
`boolean`	`isPreservePathOnForward()` Return whether the request path should be preserved on forward.
`protected boolean`	`isUseForwardHeaders()`
`void`	`setAccessLogDirectory(java.io.File accessLogDirectory)` Set the access log directory.
`void`	`setAccessLogEnabled(boolean accessLogEnabled)` Set whether access logs are enabled.
`void`	`setAccessLogPattern(java.lang.String accessLogPattern)` Set the access log pattern.
`void`	`setAccessLogPrefix(java.lang.String accessLogPrefix)` Set the access log prefix.
`void`	`setAccessLogRotate(boolean accessLogRotate)` Set whether access logs rotation is enabled.
`void`	`setAccessLogSuffix(java.lang.String accessLogSuffix)` Set the access log suffix.
`void`	`setBufferSize(java.lang.Integer bufferSize)` Set the buffer size.
`void`	`setBuilderCustomizers(java.util.Collection<? extends UndertowBuilderCustomizer> customizers)` Set `UndertowBuilderCustomizer`s that should be applied to the Undertow `Undertow.Builder`.
`void`	`setDeploymentInfoCustomizers(java.util.Collection<? extends UndertowDeploymentInfoCustomizer> customizers)` Set `UndertowDeploymentInfoCustomizer`s that should be applied to the Undertow `DeploymentInfo`.
`void`	`setEagerFilterInit(boolean eagerFilterInit)` Set whether filters should be eagerly initialized.
`void`	`setIoThreads(java.lang.Integer ioThreads)` Set the number of IO Threads.
`void`	`setPreservePathOnForward(boolean preservePathOnForward)` Set whether the request path should be preserved on forward.
`void`	`setResourceLoader(org.springframework.core.io.ResourceLoader resourceLoader)`
`void`	`setUseDirectBuffers(java.lang.Boolean directBuffers)` Set whether direct buffers should be used.
`void`	`setUseForwardHeaders(boolean useForwardHeaders)` Set if x-forward-* headers should be processed.
`void`	`setWorkerThreads(java.lang.Integer workerThreads)` Set the number of Worker Threads.

Methods inherited from class org.springframework.boot.web.server.AbstractConfigurableWebServerFactory
addErrorPages, createTempDir, getAddress, getCompression, getErrorPages, getHttp2, getPort, getServerHeader, getShutdown, getSsl, getSslStoreProvider, setAddress, setCompression, setErrorPages, setHttp2, setPort, setServerHeader, setShutdown, 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, setShutdown, 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(java.lang.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(java.util.Collection<? extends UndertowBuilderCustomizer> customizers)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set UndertowBuilderCustomizers that should be applied to the Undertow Undertow.Builder. Calling this method will replace any existing customizers.
    
    Specified by:
    
    setBuilderCustomizers in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    customizers - the customizers to set
  - addBuilderCustomizers
```
public void addBuilderCustomizers(UndertowBuilderCustomizer... customizers)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Add UndertowBuilderCustomizers that should be used to customize the Undertow Undertow.Builder.
    
    Specified by:
    
    addBuilderCustomizers in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    customizers - the customizers to add
  - getBuilderCustomizers
```
public java.util.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
  - setBufferSize
```
public void setBufferSize(java.lang.Integer bufferSize)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set the buffer size.
    
    Specified by:
    
    setBufferSize in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    bufferSize - buffer size
  - setIoThreads
```
public void setIoThreads(java.lang.Integer ioThreads)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set the number of IO Threads.
    
    Specified by:
    
    setIoThreads in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    ioThreads - number of IO Threads
  - setWorkerThreads
```
public void setWorkerThreads(java.lang.Integer workerThreads)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set the number of Worker Threads.
    
    Specified by:
    
    setWorkerThreads in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    workerThreads - number of Worker Threads
  - setUseDirectBuffers
```
public void setUseDirectBuffers(java.lang.Boolean directBuffers)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set whether direct buffers should be used.
    
    Specified by:
    
    setUseDirectBuffers in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    directBuffers - whether direct buffers should be used
  - setAccessLogDirectory
```
public void setAccessLogDirectory(java.io.File accessLogDirectory)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set the access log directory.
    
    Specified by:
    
    setAccessLogDirectory in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    accessLogDirectory - access log directory
  - setAccessLogPattern
```
public void setAccessLogPattern(java.lang.String accessLogPattern)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set the access log pattern.
    
    Specified by:
    
    setAccessLogPattern in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    accessLogPattern - access log pattern
  - setAccessLogPrefix
```
public void setAccessLogPrefix(java.lang.String accessLogPrefix)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set the access log prefix.
    
    Specified by:
    
    setAccessLogPrefix in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    accessLogPrefix - log prefix
  - getAccessLogPrefix
```
public java.lang.String getAccessLogPrefix()
```
  - setAccessLogSuffix
```
public void setAccessLogSuffix(java.lang.String accessLogSuffix)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set the access log suffix.
    
    Specified by:
    
    setAccessLogSuffix in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    accessLogSuffix - access log suffix
  - setAccessLogEnabled
```
public void setAccessLogEnabled(boolean accessLogEnabled)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set whether access logs are enabled.
    
    Specified by:
    
    setAccessLogEnabled in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    accessLogEnabled - whether access logs are enabled
  - isAccessLogEnabled
```
public boolean isAccessLogEnabled()
```
  - setAccessLogRotate
```
public void setAccessLogRotate(boolean accessLogRotate)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set whether access logs rotation is enabled.
    
    Specified by:
    
    setAccessLogRotate in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    accessLogRotate - whether access logs rotation is enabled
  - setUseForwardHeaders
```
public void setUseForwardHeaders(boolean useForwardHeaders)
```
    Description copied from interface: ConfigurableUndertowWebServerFactory
    
    Set if x-forward-* headers should be processed.
    
    Specified by:
    
    setUseForwardHeaders in interface ConfigurableUndertowWebServerFactory
    
    Parameters:
    
    useForwardHeaders - if x-forward headers should be used
  - isUseForwardHeaders
```
protected final boolean isUseForwardHeaders()
```
  - setDeploymentInfoCustomizers
```
public void setDeploymentInfoCustomizers(java.util.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
  - addDeploymentInfoCustomizers
```
public void addDeploymentInfoCustomizers(UndertowDeploymentInfoCustomizer... customizers)
```
    Add UndertowDeploymentInfoCustomizers that should be used to customize the Undertow DeploymentInfo.
    
    Parameters:
    
    customizers - the customizers to add
  - getDeploymentInfoCustomizers
```
public java.util.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
  - setResourceLoader
```
public void setResourceLoader(org.springframework.core.io.ResourceLoader resourceLoader)
```
    Specified by:
    
    setResourceLoader in interface org.springframework.context.ResourceLoaderAware
  - isEagerFilterInit
```
public boolean isEagerFilterInit()
```
    Return if filters should be eagerly initialized.
    
    Returns:
    
    true if filters are eagerly initialized, otherwise false.
    
    Since:
    
    2.4.0
  - setEagerFilterInit
```
public void setEagerFilterInit(boolean eagerFilterInit)
```
    Set whether filters should be eagerly initialized.
    
    Parameters:
    
    eagerFilterInit - true if filters are eagerly initialized, otherwise false.
    
    Since:
    
    2.4.0
  - isPreservePathOnForward
```
public boolean isPreservePathOnForward()
```
    Return whether the request path should be preserved on forward.
    
    Returns:
    
    true if the path should be preserved when a request is forwarded, otherwise false.
    
    Since:
    
    2.4.0
  - setPreservePathOnForward
```
public void setPreservePathOnForward(boolean preservePathOnForward)
```
    Set whether the request path should be preserved on forward.
    
    Parameters:
    
    preservePathOnForward - true if the path should be preserved when a request is forwarded, otherwise false.
    
    Since:
    
    2.4.0
  - 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

Class UndertowServletWebServerFactory

Field Summary

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

Constructor Summary

Method Summary

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

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

Constructor Detail

UndertowServletWebServerFactory

UndertowServletWebServerFactory

UndertowServletWebServerFactory

Method Detail

setBuilderCustomizers

addBuilderCustomizers

getBuilderCustomizers

setBufferSize

setIoThreads

setWorkerThreads

setUseDirectBuffers

setAccessLogDirectory

setAccessLogPattern

setAccessLogPrefix

getAccessLogPrefix

setAccessLogSuffix

setAccessLogEnabled

isAccessLogEnabled

setAccessLogRotate

setUseForwardHeaders

isUseForwardHeaders

setDeploymentInfoCustomizers

addDeploymentInfoCustomizers

getDeploymentInfoCustomizers

setResourceLoader

isEagerFilterInit

setEagerFilterInit

isPreservePathOnForward

setPreservePathOnForward

getWebServer

getUndertowWebServer