/*
* Copyright 2012-2019 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.boot.web.servlet.server;
import java.io.File;
import java.nio.charset.Charset;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import javax.servlet.ServletContext;
import org.springframework.boot.web.server.ConfigurableWebServerFactory;
import org.springframework.boot.web.server.MimeMappings;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.boot.web.servlet.ServletContextInitializer;
A configurable ServletWebServerFactory
. Author: Dave Syer, Andy Wilkinson, Stephane Nicoll, Eddú Meléndez, Brian Clozel See Also: Since: 2.0.0
/**
* A configurable {@link ServletWebServerFactory}.
*
* @author Dave Syer
* @author Andy Wilkinson
* @author Stephane Nicoll
* @author Eddú Meléndez
* @author Brian Clozel
* @since 2.0.0
* @see ServletWebServerFactory
* @see WebServerFactoryCustomizer
*/
public interface ConfigurableServletWebServerFactory extends ConfigurableWebServerFactory, ServletWebServerFactory {
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.
Params: - contextPath – the contextPath to set
/**
* 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.
* @param contextPath the contextPath to set
*/
void setContextPath(String contextPath);
Sets the display name of the application deployed in the web server.
Params: - displayName – the displayName to set
Since: 1.3.0
/**
* Sets the display name of the application deployed in the web server.
* @param displayName the displayName to set
* @since 1.3.0
*/
void setDisplayName(String displayName);
Sets the configuration that will be applied to the container's HTTP session
support.
Params: - session – the session configuration
/**
* Sets the configuration that will be applied to the container's HTTP session
* support.
* @param session the session configuration
*/
void setSession(Session session);
Set if the DefaultServlet should be registered. Defaults to true
so that files from the document root
will be served. Params: - registerDefaultServlet – if the default servlet should be registered
/**
* Set if the DefaultServlet should be registered. Defaults to {@code true} so that
* files from the {@link #setDocumentRoot(File) document root} will be served.
* @param registerDefaultServlet if the default servlet should be registered
*/
void setRegisterDefaultServlet(boolean registerDefaultServlet);
Sets the mime-type mappings.
Params: - mimeMappings – the mime type mappings (defaults to
MimeMappings.DEFAULT
)
/**
* Sets the mime-type mappings.
* @param mimeMappings the mime type mappings (defaults to
* {@link MimeMappings#DEFAULT})
*/
void setMimeMappings(MimeMappings mimeMappings);
Sets the document root directory which will be used by the web context to serve
static files.
Params: - documentRoot – the document root or
null
if not required
/**
* Sets the document root directory which will be used by the web context to serve
* static files.
* @param documentRoot the document root or {@code null} if not required
*/
void setDocumentRoot(File documentRoot);
Sets ServletContextInitializer
that should be applied in addition to ServletWebServerFactory.getWebServer(ServletContextInitializer...)
parameters. This method will replace any previously set or added initializers. Params: - initializers – the initializers to set
See Also:
/**
* Sets {@link ServletContextInitializer} that should be applied in addition to
* {@link ServletWebServerFactory#getWebServer(ServletContextInitializer...)}
* parameters. This method will replace any previously set or added initializers.
* @param initializers the initializers to set
* @see #addInitializers
*/
void setInitializers(List<? extends ServletContextInitializer> initializers);
Add ServletContextInitializer
s to those that should be applied in addition to ServletWebServerFactory.getWebServer(ServletContextInitializer...)
parameters. Params: - initializers – the initializers to add
See Also:
/**
* Add {@link ServletContextInitializer}s to those that should be applied in addition
* to {@link ServletWebServerFactory#getWebServer(ServletContextInitializer...)}
* parameters.
* @param initializers the initializers to add
* @see #setInitializers
*/
void addInitializers(ServletContextInitializer... initializers);
Sets the configuration that will be applied to the server's JSP servlet.
Params: - jsp – the JSP servlet configuration
/**
* Sets the configuration that will be applied to the server's JSP servlet.
* @param jsp the JSP servlet configuration
*/
void setJsp(Jsp jsp);
Sets the Locale to Charset mappings.
Params: - localeCharsetMappings – the Locale to Charset mappings
/**
* Sets the Locale to Charset mappings.
* @param localeCharsetMappings the Locale to Charset mappings
*/
void setLocaleCharsetMappings(Map<Locale, Charset> localeCharsetMappings);
Sets the init parameters that are applied to the container's ServletContext
. Params: - initParameters – the init parameters
/**
* Sets the init parameters that are applied to the container's
* {@link ServletContext}.
* @param initParameters the init parameters
*/
void setInitParameters(Map<String, String> initParameters);
}