Package org.springframework.boot.web.server

Class AbstractConfigurableWebServerFactory

java.lang.Object

org.springframework.boot.web.server.AbstractConfigurableWebServerFactory

All Implemented Interfaces:

ConfigurableWebServerFactory, ErrorPageRegistry, WebServerFactory

Direct Known Subclasses:

AbstractReactiveWebServerFactory, AbstractServletWebServerFactory

public abstract class AbstractConfigurableWebServerFactory
extends Object
implements ConfigurableWebServerFactory

Abstract base class for ConfigurableWebServerFactory implementations.

Since:

2.0.0

Author:

Phillip Webb, Dave Syer, Andy Wilkinson, Stephane Nicoll, Ivan Sopov, Eddú Meléndez, Brian Clozel, Scott Frederick

Constructor Summary

Constructors

Constructor	Description
AbstractConfigurableWebServerFactory()	Create a new AbstractConfigurableWebServerFactory instance.
AbstractConfigurableWebServerFactory(int port)	Create a new AbstractConfigurableWebServerFactory instance with the specified port.

Method Summary

Modifier and Type	Method	Description
void	addErrorPages(ErrorPage... errorPages)	Adds error pages that will be used when handling exceptions.
protected final File	createTempDir(String prefix)	Return the absolute temp dir for given web server.
InetAddress	getAddress()	Return the address that the web server binds to.
Compression	getCompression()
Set<ErrorPage>	getErrorPages()	Returns a mutable set of ErrorPages that will be used when handling exceptions.
Http2	getHttp2()
final SslStoreProvider	getOrCreateSslStoreProvider()	Deprecated, for removal: This API element is subject to removal in a future version. since 3.1.0 for removal in 3.3.0 in favor of getSslBundle()
int	getPort()	The port that the web server listens on.
String	getServerHeader()
Shutdown	getShutdown()	Returns the shutdown configuration that will be applied to the server.
Ssl	getSsl()
protected final SslBundle	getSslBundle()	Return the SslBundle that should be used with this server.
SslBundles	getSslBundles()	Return the configured SslBundles.
SslStoreProvider	getSslStoreProvider()
void	setAddress(InetAddress address)	Sets the specific network address that the server should bind to.
void	setCompression(Compression compression)	Sets the compression configuration that will be applied to the server's default connector.
void	setErrorPages(Set<? extends ErrorPage> errorPages)	Sets the error pages that will be used when handling exceptions.
void	setHttp2(Http2 http2)	Sets the HTTP/2 configuration that will be applied to the server.
void	setPort(int port)	Sets the port that the web server should listen on.
void	setServerHeader(String serverHeader)	Sets the server header value.
void	setShutdown(Shutdown shutdown)	Sets the shutdown configuration that will be applied to the server.
void	setSsl(Ssl ssl)	Sets the SSL configuration that will be applied to the server's default connector.
void	setSslBundles(SslBundles sslBundles)	Sets the SSL bundles that can be used to configure SSL connections.
void	setSslStoreProvider(SslStoreProvider sslStoreProvider)	Sets a provider that will be used to obtain SSL stores.

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractConfigurableWebServerFactory

public AbstractConfigurableWebServerFactory()

Create a new AbstractConfigurableWebServerFactory instance.

AbstractConfigurableWebServerFactory

public AbstractConfigurableWebServerFactory(int port)

Create a new AbstractConfigurableWebServerFactory instance with the specified port.

Parameters:

port - the port number for the web server

Method Details

getPort

public int getPort()

The port that the web server listens on.

Returns:

the port

setPort

public void setPort(int port)

Description copied from interface: ConfigurableWebServerFactory

Sets the port that the web server should listen on. If not specified port '8080' will be used. Use port -1 to disable auto-start (i.e. start the web application context but not have it listen to any port).

Specified by:

setPort in interface ConfigurableWebServerFactory

Parameters:

port - the port to set

getAddress

public InetAddress getAddress()

Return the address that the web server binds to.

Returns:

the address

setAddress

public void setAddress(InetAddress address)

Description copied from interface: ConfigurableWebServerFactory

Sets the specific network address that the server should bind to.

Specified by:

setAddress in interface ConfigurableWebServerFactory

Parameters:

address - the address to set (defaults to null)

getErrorPages

public Set<ErrorPage> getErrorPages()

Returns a mutable set of ErrorPages that will be used when handling exceptions.

Returns:

the error pages

setErrorPages

public void setErrorPages(Set<? extends ErrorPage> errorPages)

Description copied from interface: ConfigurableWebServerFactory

Sets the error pages that will be used when handling exceptions.

Specified by:

setErrorPages in interface ConfigurableWebServerFactory

Parameters:

errorPages - the error pages

addErrorPages

public void addErrorPages(ErrorPage... errorPages)

Description copied from interface: ErrorPageRegistry

Adds error pages that will be used when handling exceptions.

Specified by:

addErrorPages in interface ErrorPageRegistry

Parameters:

errorPages - the error pages

getSsl

public Ssl getSsl()

setSsl

public void setSsl(Ssl ssl)

Description copied from interface: ConfigurableWebServerFactory

Sets the SSL configuration that will be applied to the server's default connector.

Specified by:

setSsl in interface ConfigurableWebServerFactory

Parameters:

ssl - the SSL configuration

getSslStoreProvider

public SslStoreProvider getSslStoreProvider()

setSslStoreProvider

public void setSslStoreProvider(SslStoreProvider sslStoreProvider)

Description copied from interface: ConfigurableWebServerFactory

Sets a provider that will be used to obtain SSL stores.

Specified by:

setSslStoreProvider in interface ConfigurableWebServerFactory

Parameters:

sslStoreProvider - the SSL store provider

getSslBundles

public SslBundles getSslBundles()

Return the configured SslBundles.

Returns:

the SslBundles or null

Since:

3.2.0

setSslBundles

public void setSslBundles(SslBundles sslBundles)

Description copied from interface: ConfigurableWebServerFactory

Sets the SSL bundles that can be used to configure SSL connections.

Specified by:

setSslBundles in interface ConfigurableWebServerFactory

Parameters:

sslBundles - the SSL bundles

getHttp2

public Http2 getHttp2()

setHttp2

public void setHttp2(Http2 http2)

Description copied from interface: ConfigurableWebServerFactory

Sets the HTTP/2 configuration that will be applied to the server.

Specified by:

setHttp2 in interface ConfigurableWebServerFactory

Parameters:

http2 - the HTTP/2 configuration

getCompression

public Compression getCompression()

setCompression

public void setCompression(Compression compression)

Description copied from interface: ConfigurableWebServerFactory

Sets the compression configuration that will be applied to the server's default connector.

Specified by:

setCompression in interface ConfigurableWebServerFactory

Parameters:

compression - the compression configuration

getServerHeader

public String getServerHeader()

setServerHeader

public void setServerHeader(String serverHeader)

Description copied from interface: ConfigurableWebServerFactory

Sets the server header value.

Specified by:

setServerHeader in interface ConfigurableWebServerFactory

Parameters:

serverHeader - the server header value

setShutdown

public void setShutdown(Shutdown shutdown)

Description copied from interface: ConfigurableWebServerFactory

Sets the shutdown configuration that will be applied to the server.

Specified by:

setShutdown in interface ConfigurableWebServerFactory

Parameters:

shutdown - the shutdown configuration

getShutdown

public Shutdown getShutdown()

Returns the shutdown configuration that will be applied to the server.

Returns:

the shutdown configuration

Since:

2.3.0

getOrCreateSslStoreProvider

@Deprecated(since="3.1.0",
            forRemoval=true)
public final SslStoreProvider getOrCreateSslStoreProvider()

Deprecated, for removal: This API element is subject to removal in a future version.

since 3.1.0 for removal in 3.3.0 in favor of getSslBundle()

Return the provided SslStoreProvider or create one using Ssl properties.

Returns:

the SslStoreProvider

getSslBundle

protected final SslBundle getSslBundle()

Return the SslBundle that should be used with this server.

Returns:

the SSL bundle

createTempDir

protected final File createTempDir(String prefix)

Return the absolute temp dir for given web server.

Parameters:

prefix - server name

Returns:

the temp dir for given server.