Spring Boot-4.servlet容器配置

Spring Boot默认Tomcat为Servlet容器,以Tomcat为例进行说明,Tomcat,Jetty,Undertow都是通用的。

1.配置Tomcat

*Tomcat的所有属性都在org.spring framework.boot.autoconfiguration.web.ServerProperties配置类中做了定义。

  • 定制的配置在application.properties中配置属性即可。
  • 通常Servlet容器配置都已“server”作为前缀,Tomcat的配置都以“server.tomcat”作为前缀
Servlet容器
server.port=# 配置程序端口,默认8080
server.serrsion-timeout= #用户会话session过期时间,以秒为单位
server.context-path= #配置访问路径。默认为/
Tomcat
server.tomcat.uri-encoding = #配置Tomcat编码,默认UTF-8
server.tomcat.compression = # Tomcat 是否开启压缩,默认为关闭off

2. 代码配置

  • 需要通过代码的方式配置servlet容器,可以注册一个实现EmbeddedServletContainerCustomizer接口的Bean。
  • 若想直接配置Tomcat,Jetty,Undertow等,可以直接定义TomcatEmbeddedServletContainer、...

2.1 通用配置

(1)新建类的配置

@Component
public class CustomServletContainer implements EmbeddedServletContainerCustomizer {
    @Override
    public void customize(ConfigurationEmbeddedServletContainer container) {
        container.setPort(8888);
        container.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/404.html"));
        container.setSessionTimeout(10, TimeUnit.MINUTES);
  }
}

(2) 当前配置文件内配置。
在当前已有的配置文件内添加类的Bean,需要在Spring配置中,当前类要声明为static:

    @Component
    public static class CustomServletContainer implements EmbeddedServletContainerCustomizer{
        @Override
        public void customize(ConfigurableEmbeddedServletContainer container){
            container.setPort(8888); // 配置端口号
            container.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/404")); // 配置错误页面
            container.setSessionTimeout(10, TimeUnit.MINUTES); // 配置Servlet容器session过期时间
        }
    }

2.2 特定配置

Tomcat使用TomcatEmbeddedServletContainerFactory、Jetty使用JettyEmbeddedServletContainerFactory、Undertow使用UndertowEmbeddedServletContainerFactory。
以Tomcat为例:

@Bean
    public EmbeddedServletContainerFactory servletContainerFactory(){
        TomcatEmbeddedServletContainerFactory factory = new TomcatEmbeddedServletContainerFactory();
        factory.setPort(8888);//配置端口号
        factory.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/404.html")); // 配置错误页面
        factory.setSessionTimeout(10, TimeUnit.MINUTES);//设置session失效时间
        return factory;
    }

3. 替换Tomcat

Spring Boot默认使用tomcat作为Servlet容器。如果要替换,需要修改spring-boot-starter-web的依赖。

3.1 替换为Jetty

在pom.xml中,将spring-boot-starter-web的依赖由spring-boot-starter-tomcat替换为spring-boot-starter-Jetty:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jetty</artifactId>
</dependency>

此时可以看到。容器已经变为Jetty:


容器已经变为Jetty

3.2 Tomcat换成Undertow

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-undetow</artifactId>
</dependency>

4.SSL配置

Spring Boot使用的是内嵌的Tomcat,因此SSL配置操作如下:

4.1生成证书

SSL需要一个证书,可以是自签名的,也可以是SSL证书授权中心获得。

在JDK或者JRE都有名为keytoo的证书管理工具,可以用来生成自签名的证书。这里需要指定-keyalg RSA,不然会出现ERR_SSL_VERSION_OR_CIPHER_MISMATCH 错误 导致无法访问。

keytool -genkey -alias tomcat -keyalg RSA

根据提示输入内容后,可以在当前目录生成一个.keystore文件,就是我们要用的证书文件。

4.2 Spring Boot配置SSL

/src/main/resources/static目录下添加index.html作为测试。
.keysotre文件复制到项目的根目录,然后在application.properties中添加SSL配置:

server.ssl.key-store=.keystore
server.ssl.key-store-password=tomcat
server.ssl.key-store-type=JKS
server.ssl.key-alias=tomcat

之后启动spring boot后,控制台输出中可以看到:

Tomcat started on port(s): 8080 (https)

在浏览器中访问可以看到:


访问localhost:8080

4.3 http跳转https

在地址栏中输入http,自动跳转https,这一功能需要配置TomcatEmbeddedServletContainerFactory,并添加Tomcat的connector来实现。

@Bean
    public EmbeddedServletContainerFactory servletContainer(){
        TomcatEmbeddedServletContainerFactory tomcat = new TomcatEmbeddedServletContainerFactory(){
            @Override
            protected void postProcessContext(Context context){
                SecurityConstraint securityConstraint = new SecurityConstraint();
                securityConstraint.setUserConstraint("CONFIDENTIAL");
                SecurityCollection collection = new SecurityCollection();
                collection.addPattern("/*");
                securityConstraint.addCollection(collection);
                context.addConstraint(securityConstraint);
            }
        };
        tomcat.addAdditionalTomcatConnectors(httpConnector());
        return tomcat;
    }

    private Connector httpConnector() {
        Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
        connector.setScheme("http");
        connector.setPort(8888);
        connector.setSecure(false);
        connector.setRedirectPort(8080);
        return connector;
    }

启动Spring Boot后,日志中可以看到

Tomcat started on port(s): 8080 (https) 8888 (http)

此时在浏览器中以http协议对8888端口发起请求会自动跳转到https协议的8080端口:


请求http://localhost:8888端口

自动跳转到https://localhost:8080
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,591评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,448评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,823评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,204评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,228评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,190评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,078评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,923评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,334评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,550评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,727评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,428评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,022评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,672评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,826评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,734评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,619评论 2 354

推荐阅读更多精彩内容