org.springframework.boot.web.servlet.server

Class AbstractServletWebServerFactory

java.lang.Object

org.springframework.boot.web.server.AbstractConfigurableWebServerFactory

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

All Implemented Interfaces:

ConfigurableWebServerFactory, ErrorPageRegistry, WebServerFactory, ConfigurableServletWebServerFactory, ServletWebServerFactory

Direct Known Subclasses:

JettyServletWebServerFactory, TomcatServletWebServerFactory, UndertowServletWebServerFactory

public abstract class AbstractServletWebServerFactory
extends AbstractConfigurableWebServerFactory
implements ConfigurableServletWebServerFactory

Abstract base class for ConfigurableServletWebServerFactory implementations.

Since:

2.0.0

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.logging.Log	logger

Constructor Summary

Constructors

Constructor and Description
AbstractServletWebServerFactory() Create a new AbstractServletWebServerFactory instance.
AbstractServletWebServerFactory(int port) Create a new AbstractServletWebServerFactory instance with the specified port.
AbstractServletWebServerFactory(String contextPath, int port) Create a new AbstractServletWebServerFactory instance with the specified context path and port.

Method Summary

Modifier and Type	Method and Description
void	addInitializers(ServletContextInitializer... initializers) Add ServletContextInitializers to those that should be applied in addition to ServletWebServerFactory.getWebServer(ServletContextInitializer...) parameters.
String	getContextPath() Returns the context path for the web server.
String	getDisplayName()
File	getDocumentRoot() Returns the document root which will be used by the web context to serve static files.
Jsp	getJsp()
Map<Locale,Charset>	getLocaleCharsetMappings() Return the Locale to Charset mappings.
MimeMappings	getMimeMappings() Returns the mime-type mappings.
File	getSessionStoreDir()
int	getSessionTimeout() Return the session timeout in seconds.
protected List<URL>	getUrlsOfJarsWithMetaInfResources()
protected File	getValidDocumentRoot() Returns the absolute document root when it points to a valid directory, logging a warning and returning null otherwise.
protected File	getValidSessionStoreDir()
protected File	getValidSessionStoreDir(boolean mkdirs)
boolean	isPersistSession()
boolean	isRegisterDefaultServlet() Flag to indicate that the default servlet should be registered.
protected ServletContextInitializer[]	mergeInitializers(ServletContextInitializer... initializers) Utility method that can be used by subclasses wishing to combine the specified ServletContextInitializer parameters with those defined in this instance.
void	setContextPath(String contextPath) Sets the context path for the web server.
void	setDisplayName(String displayName) Sets the display name of the application deployed in the web server.
void	setDocumentRoot(File documentRoot) Sets the document root directory which will be used by the web context to serve static files.
void	setInitializers(List<? extends ServletContextInitializer> initializers) Sets ServletContextInitializer that should be applied in addition to ServletWebServerFactory.getWebServer(ServletContextInitializer...) parameters.
void	setJsp(Jsp jsp) Sets the configuration that will be applied to the server's JSP servlet.
void	setLocaleCharsetMappings(Map<Locale,Charset> localeCharsetMappings) Sets the Locale to Charset mappings.
void	setMimeMappings(MimeMappings mimeMappings) Sets the mime-type mappings.
void	setPersistSession(boolean persistSession) Sets if session data should be persisted between restarts.
void	setRegisterDefaultServlet(boolean registerDefaultServlet) Set if the DefaultServlet should be registered.
void	setSessionStoreDir(File sessionStoreDir) Set the directory used to store serialized session data.
void	setSessionTimeout(int sessionTimeout) The session timeout in seconds (default 30 minutes).
void	setSessionTimeout(int sessionTimeout, TimeUnit timeUnit) The session timeout in the specified TimeUnit (default 30 minutes).
protected boolean	shouldRegisterJspServlet() Returns whether or not the JSP servlet should be registered with the web server.

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

Methods inherited from interface org.springframework.boot.web.servlet.server.ServletWebServerFactory

getWebServer

Field Detail

logger

protected final org.apache.commons.logging.Log logger

Constructor Detail

AbstractServletWebServerFactory

public AbstractServletWebServerFactory()

Create a new AbstractServletWebServerFactory instance.

AbstractServletWebServerFactory

public AbstractServletWebServerFactory(int port)

Create a new AbstractServletWebServerFactory instance with the specified port.

Parameters:

port - the port number for the web server

AbstractServletWebServerFactory

public AbstractServletWebServerFactory(String contextPath,
                                       int port)

Create a new AbstractServletWebServerFactory instance with the specified context path and port.

Parameters:

contextPath - the context path for the web server

port - the port number for the web server

Method Detail

getContextPath

public String getContextPath()

Returns the context path for the web server. The path will start with "/" and not end with "/". The root context is represented by an empty string.

Returns:

the context path

setContextPath

public void setContextPath(String contextPath)

Description copied from interface: ConfigurableServletWebServerFactory

Sets the context path for the web server. The context should start with a "/" character but not end with a "/" character. The default context path can be specified using an empty string.

Specified by:

setContextPath in interface ConfigurableServletWebServerFactory

Parameters:

contextPath - the contextPath to set

getDisplayName

public String getDisplayName()

setDisplayName

public void setDisplayName(String displayName)

Description copied from interface: ConfigurableServletWebServerFactory

Sets the display name of the application deployed in the web server.

Specified by:

setDisplayName in interface ConfigurableServletWebServerFactory

Parameters:

displayName - the displayName to set

getSessionTimeout

public int getSessionTimeout()

Return the session timeout in seconds.

Returns:

the timeout in seconds

setSessionTimeout

public void setSessionTimeout(int sessionTimeout)

Description copied from interface: ConfigurableServletWebServerFactory

The session timeout in seconds (default 30 minutes). If 0 or negative then sessions never expire.

Specified by:

setSessionTimeout in interface ConfigurableServletWebServerFactory

Parameters:

sessionTimeout - the session timeout

setSessionTimeout

public void setSessionTimeout(int sessionTimeout,
                              TimeUnit timeUnit)

Description copied from interface: ConfigurableServletWebServerFactory

The session timeout in the specified TimeUnit (default 30 minutes). If 0 or negative then sessions never expire.

Specified by:

setSessionTimeout in interface ConfigurableServletWebServerFactory

Parameters:

sessionTimeout - the session timeout

timeUnit - the time unit

isPersistSession

public boolean isPersistSession()

setPersistSession

public void setPersistSession(boolean persistSession)

Description copied from interface: ConfigurableServletWebServerFactory

Sets if session data should be persisted between restarts.

Specified by:

setPersistSession in interface ConfigurableServletWebServerFactory

Parameters:

persistSession - true if session data should be persisted

getSessionStoreDir

public File getSessionStoreDir()

setSessionStoreDir

public void setSessionStoreDir(File sessionStoreDir)

Description copied from interface: ConfigurableServletWebServerFactory

Set the directory used to store serialized session data.

Specified by:

setSessionStoreDir in interface ConfigurableServletWebServerFactory

Parameters:

sessionStoreDir - the directory or null to use a default location.

isRegisterDefaultServlet

public boolean isRegisterDefaultServlet()

Flag to indicate that the default servlet should be registered.

Returns:

true if the default servlet is to be registered

setRegisterDefaultServlet

public void setRegisterDefaultServlet(boolean registerDefaultServlet)

Description copied from interface: ConfigurableServletWebServerFactory

Set if the DefaultServlet should be registered. Defaults to true so that files from the document root will be served.

Specified by:

setRegisterDefaultServlet in interface ConfigurableServletWebServerFactory

Parameters:

registerDefaultServlet - if the default servlet should be registered

getMimeMappings

public MimeMappings getMimeMappings()

Returns the mime-type mappings.

Returns:

the mimeMappings the mime-type mappings.

setMimeMappings

public void setMimeMappings(MimeMappings mimeMappings)

Description copied from interface: ConfigurableServletWebServerFactory

Sets the mime-type mappings.

Specified by:

setMimeMappings in interface ConfigurableServletWebServerFactory

Parameters:

mimeMappings - the mime type mappings (defaults to MimeMappings.DEFAULT)

getDocumentRoot

public File getDocumentRoot()

Returns the document root which will be used by the web context to serve static files.

Returns:

the document root

setDocumentRoot

public void setDocumentRoot(File documentRoot)

Description copied from interface: ConfigurableServletWebServerFactory

Sets the document root directory which will be used by the web context to serve static files.

Specified by:

setDocumentRoot in interface ConfigurableServletWebServerFactory

Parameters:

documentRoot - the document root or null if not required

setInitializers

public void setInitializers(List<? extends ServletContextInitializer> initializers)

Description copied from interface: ConfigurableServletWebServerFactory

Sets ServletContextInitializer that should be applied in addition to ServletWebServerFactory.getWebServer(ServletContextInitializer...) parameters. This method will replace any previously set or added initializers.

Specified by:

setInitializers in interface ConfigurableServletWebServerFactory

Parameters:

initializers - the initializers to set

See Also:

ConfigurableServletWebServerFactory.addInitializers(org.springframework.boot.web.servlet.ServletContextInitializer...)

addInitializers

public void addInitializers(ServletContextInitializer... initializers)

Description copied from interface: ConfigurableServletWebServerFactory

Add ServletContextInitializers to those that should be applied in addition to ServletWebServerFactory.getWebServer(ServletContextInitializer...) parameters.

Specified by:

addInitializers in interface ConfigurableServletWebServerFactory

Parameters:

initializers - the initializers to add

See Also:

ConfigurableServletWebServerFactory.setInitializers(java.util.List<? extends org.springframework.boot.web.servlet.ServletContextInitializer>)

getJsp

public Jsp getJsp()

setJsp

public void setJsp(Jsp jsp)

Description copied from interface: ConfigurableServletWebServerFactory

Sets the configuration that will be applied to the server's JSP servlet.

Specified by:

setJsp in interface ConfigurableServletWebServerFactory

Parameters:

jsp - the JSP servlet configuration

getLocaleCharsetMappings

public Map<Locale,Charset> getLocaleCharsetMappings()

Return the Locale to Charset mappings.

Returns:

the charset mappings

setLocaleCharsetMappings

public void setLocaleCharsetMappings(Map<Locale,Charset> localeCharsetMappings)

Description copied from interface: ConfigurableServletWebServerFactory

Sets the Locale to Charset mappings.

Specified by:

setLocaleCharsetMappings in interface ConfigurableServletWebServerFactory

Parameters:

localeCharsetMappings - the Locale to Charset mappings

mergeInitializers

protected final ServletContextInitializer[] mergeInitializers(ServletContextInitializer... initializers)

Utility method that can be used by subclasses wishing to combine the specified ServletContextInitializer parameters with those defined in this instance.

Parameters:

initializers - the initializers to merge

Returns:

a complete set of merged initializers (with the specified parameters appearing first)

shouldRegisterJspServlet

protected boolean shouldRegisterJspServlet()

Returns whether or not the JSP servlet should be registered with the web server.

Returns:

true if the servlet should be registered, otherwise false

getValidDocumentRoot

protected final File getValidDocumentRoot()

Returns the absolute document root when it points to a valid directory, logging a warning and returning null otherwise.

Returns:

the valid document root

getUrlsOfJarsWithMetaInfResources

protected final List<URL> getUrlsOfJarsWithMetaInfResources()

getValidSessionStoreDir

protected final File getValidSessionStoreDir()

getValidSessionStoreDir

protected final File getValidSessionStoreDir(boolean mkdirs)