2.4 Web容器配置:Tomcat

news2025/1/13 17:28:49

2.4 Web容器配置

2.4.1Tomcat配置
- 1.常规配置
- 2. HTTPS配置
***********

2.4.1Tomcat配置

1.常规配置

在SpringBoot项目中，可以内置Tomcat、Jetly、Undertow、Netty等容器。
当开发者添加了spring-boot-starter-web依赖之后，默认会使用Tomcat作为Web容器。
如果需要对Tomcat做进一步的配置，可以在application.properties中进行配置，
代码如下：

# 配置了Web容器的端口号
server.port=8081
# 配置了当项目出错时跳转去的页面。
server.error.path=/error
# 配置了session失效时间,30m表示30分钟，如果不写单位，默认单位是秒。
server.servlet.session.timeout=30m
# context-path表示项目名称，不配置时默认为/。如果配置了，就要在访问路径中加上配置的路径。
server.servlet.context-path=/chapter02 
# 配置Tomcat请求编码。
server.tomcat.uri-encoding=utf-8
# 表示Tomcat最大线程数。
server.tomcat.max-threads=500
# basedir是一个存放Tomcat运行日志和临时文件的目录，若不配置，则默认使用系统的临时目录。
server.tomcat.basedir=/home/sang/tmp

2. HTTPS配置

由于HTTPS具有良好的安全性，在开发中得到了越来越广泛的应用，像微信公众号、小程序等的开发都要使用HTTPS来完成。对于个人开发者而言，一个HTTPS证书的价格还是有点贵，国内有一些云服务器厂商提供免费的HTTPS证书，一个账号可以申请数个。不过在jdk中提供了一个Java数字证书管理工具keytool,在jdkbin目录下，通过这个工具可以自己生成一个数字证书，生成命令如下：

keytool -genkey -alias tomcathttps -keyalg RSA -keysize 2048 -keystore sang.p12 -validity 365

命令解释：

-genkey表示要创建一个新的密钥。
-alias表示keystore的别名。
-keyalg表示使用的加密算法是RSA,一种非对称加密算法。●-keysize表示密钥的长度。
-keystore表示生成的密钥存放位置。
-validity表示密钥的有效时间，单位为天。

在cmd窗口中直接执行如上命令，在执行的过程中需要输入密钥口令等信息，根据提示输入即可。
命令执行完成后，会在当前用户目录下生成一个名为sang.p12的文件，将这个文件复制到项目的根目录下，然后在application.properties中做如下配置：

server.ssl.key-store=sang.p12
server.ssl.key-alias=tomcathttps
server.ssl.key-store-password=123456

代码解释：
● key-store表示密钥文件名。
● key-alias表示密钥别名。
● key-store-password就是在cmd命令执行过程中输入的密码。

配置成功后，启动项目，在浏览器中输入“https://localhost:8081/chapter02/hello”来查看结果。注意，证书是自己生成的，不被浏览器认可，此时添加信任或者继续前进即可，如图2-5所示。
在这里插入图片描述
成功运行的结果如图2-6所示。

此时，如果以HTTP的方式访问接口，就会访问失败，如图2-7所示。
在这里插入图片描述
这是因为SpringBoot不支持同时在配置中启动HTTP和HTTPS。这个时候可以配置请求重定向，将HTTP请求重定向为HTTPS请求。配置方式如下：

package com.ruoyi.common.config;


import org.apache.catalina.Context;
import org.apache.catalina.connector.Connector;
import org.apache.tomcat.util.descriptor.web.SecurityCollection;
import org.apache.tomcat.util.descriptor.web.SecurityConstraint;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * Tomcat配置
 */
@Configuration
public class TomcatConfig {

    @Bean
    TomcatServletWebServerFactory tomcatServletWebServerFactory() {
        TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory() {
            @Override
            protected void postProcessContext(Context context) {
                SecurityConstraint constraint = new SecurityConstraint();
                constraint.setUserConstraint("CONFIDENTIAL");
                SecurityCollection collection = new SecurityCollection();
                collection.addPattern("/*");
                constraint.addCollection(collection);
                context.addConstraint(constraint);

            }
        };
        factory.addAdditionalTomcatConnectors(createTomcatConnector());
        return factory;
    }

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