Spring Boot：内置tomcat启动和外部tomcat部署总结

springboot的web项目的启动主要分为：

一.使用内置tomcat启动

启动方式：

一、IDEA中main函数启动

二、mvn springboot-run 命令

三、java -jar XXX.jar

配置内置tomcat属性：

关于Tomcat的属性都在org.springframework.boot.autoconfigure.web.ServerProperties配置类中作了定义，咱们只需在application.properties配置属性作配置便可。通用的Servlet容器配置都已”server”左右前缀，而Tomcat特有配置都以”server.tomcat”做为前缀。下面举一些经常使用的例子。

配置Servlet容器：

#配置程序端口，默认为8080
server.port= 8080
#用户绘画session过时时间，以秒为单位
server.session.timeout=
# 配置默认访问路径，默认为/
server.context-path=

 

配置Tomcat：

# 配置Tomcat编码,默认为UTF-8
server.tomcat.uri-encoding=UTF-8
# 配置最大线程数
server.tomcat.max-threads=1000

 

二.使用外置tomcat部署

配置步骤：

一、继承SpringBootServletInitializer

• 外部容器部署的话，就不能依赖于Application的main函数了，而是要以相似于web.xml文件配置的方式来启动Spring应用上下文，此时咱们须要在启动类中继承SpringBootServletInitializer并实现configure方法：

package com.zjt.chapter05;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.support.SpringBootServletInitializer;

@SpringBootApplication
public class Chapter05Application extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Chapter05Application.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(Chapter05Application.class, args);
    }
}

 

这个类的做用与在web.xml中配置负责初始化Spring应用上下文的监听器做用相似，只不过在这里不须要编写额外的XML文件了。

 二、pom.xml修改tomcat相关的配置

　　首先介绍下maven中scope依赖范围的概念，由于后续涉及到这个会有问题。

　　依赖范围就是用来控制依赖和三种classpath(编译classpath，测试classpath、运行classpath)的关系，Maven有以下几种依赖范围：

• compile:编译依赖范围。若是没有指定，就会默认使用该依赖范围。使用此依赖范围的Maven依赖，对于编译、测试、运行三种classpath都有效。典型的例子是spring-code,在编译、测试和运行的时候都须要使用该依赖。

• test: 测试依赖范围。使用次依赖范围的Maven依赖，只对于测试classpath有效，在编译主代码或者运行项目的使用时将没法使用此依赖。典型的例子是Jnuit,它只有在编译测试代码及运行测试的时候才须要。

• provided:已提供依赖范围。使用此依赖范围的Maven依赖，对于编译和测试classpath有效，但在运行时候无效。典型的例子是servlet-api,编译和测试项目的时候须要该依赖，但在运行项目的时候，因为容器以及提供，就不须要Maven重复地引入一遍。

 

 

若是要将最终的打包形式改成war的话，还须要对pom.xml文件进行修改，由于spring-boot-starter-web中包含内嵌的tomcat容器，因此直接部署在外部容器会冲突报错。这里有两种方法能够解决，以下

方法一：

<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>

 

在这里须要移除对嵌入式Tomcat的依赖，这样打出的war包中，在lib目录下才不会包含Tomcat相关的jar包，不然将会出现启动错误。

还有一个很关键的关键点，就是tomcat-embed-jasper中scope必须是provided。

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <scope>provided</scope>
</dependency>

 

由于SpringBootServletInitializer须要依赖 javax.servlet，而tomcat-embed-jasper下面的tomcat-embed-core中就有这个javax.servlet，若是没用provided，最终打好的war里面会有servlet-api这个jar，这样就会跟tomcat自己的冲突了。这个关键点一样适应于下面说的第二种方法。

方法二：

直接添加以下配置便可：

<!--部署成war包时开启↓↓↓↓-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <scope>provided</scope>
        </dependency>
        <!--部署成war包时开启↑↑↑↑-->

 

provided的做用上面已经介绍的很透彻了，这里就不啰嗦了，这种方式的好处是，打包的war包同时适合java -jar命令启动以及部署到外部容器中。

 

三、由jar变成war

<packaging>war</packaging>

四、注意的问题

此时打成的包的名称应该和application.properties的 
server.context-path=/test

保持一致

<build>
    <finalName>test</finalName>
</build>

 

若是不同发布到tomcat的webapps下上下文会变化