SpringBoot Maven编译打包_exec

springboot打包插件

Spring Boot 中默认打包成的 jar 叫做 可执行 jar，这种 jar 不同于普通的 jar，普通的 jar 不可以通过 java -jar xxx.jar 命令执行，普通的 jar 主要是被其他应用依赖。Spring Boot 打成的 jar 可以独立执行，但是不可以被其他的应用所依赖，即使强制依赖，也无法获取里边的类。

Spring Boot 项目中一个默认的插件配置 spring-boot-maven-plugin，这个打包插件有 7 个功能：

• build-image：构建docker镜像
• build-info：生成项目的构建信息文件 build-info.properties
• help：帮助信息
• repackage：这个是默认 goal，在 mvn package 执行之后，这个命令再次打包生成可执行的 jar，同时将 mvn package 生成的 jar 重命名为 *.origin
• run：这个可以用来运行 Spring Boot 应用
• start：这个在 mvn integration-test 阶段，进行 Spring Boot 应用生命周期的管理
• stop：这个在 mvn integration-test 阶段，进行 Spring Boot 应用生命周期的管理
  这里功能，默认情况下使用就是 repackage 功能，其他功能要使用，则需要开发者显式配置。

package打包

repackage 功能的 作用，就是在打包的时候，多做一点额外的事情：

1. 首先 mvn package 命令 对项目进行打包，打成一个 jar，这个 jar 就是一个普通的 jar，可以被其他项目依赖，但是不可以被执行；

2. repackage 命令，对第一步 打包成的 jar 进行再次打包，将之打成一个 可执行 jar ，通过将第一步打成的 jar 重命名为 *.original 文件

这里有两个文件，第一个 actuator_demo-0.0.1-SNAPSHOT.jar 表示打包成的可执行 jar ，第二个 actuator_demo-0.0.1-SNAPSHOT.jar.original 则是在打包过程中 ，被重命名的 jar，这是一个不可执行 jar，但是可以被其他项目依赖的 jar。

一次打包两个 jar

给 spring-boot-maven-plugin 插件添加<classifier>标签，如下配置：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>2.3.7.RELEASE</version>
    <configuration>
        <mainClass>com.example.actuator_demo.ActuatorDemoApplication</mainClass>
        <!--配置可执行jar的名称，不对原jar重命名为.original-->
        <classifier>exec</classifier>
    </configuration>
    <executions>
        <execution>
            <id>repackage</id>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

配置的 classifier 表示可执行 jar 的名字，配置了这个之后，在插件执行 repackage 命令时，就不会给 mvn package 所打成的 jar 重命名了，所以，打包后的 jar 如下：

第一个 jar 表示可以被其他项目依赖的 jar ，第二个 jar 则表示一个可执行 jar。

依赖 jar 分离打包

多数情况下，项目本身代码量不多，打出的jar包往往也很大，这是因为打包时包含很多其他依赖，才能保证jar包可以独立运行。

可单独打包本项目相关代码，不打包其他依赖jar，配置如下：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>2.3.7.RELEASE</version>
    <configuration>
        <mainClass>com.example.actuator_demo.ActuatorDemoApplication</mainClass>
        <classifier>exec</classifier>
        <!--只打包本项目相关代码，不打包其他依赖jar-->
        <layout>ZIP</layout>
        <includes>
            <include>
                <groupId>com.example</groupId>
                <artifactId>actuator_demo</artifactId>
            </include>
        </includes>
    </configuration>
    <executions>
        <execution>
            <id>repackage</id>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

启动jar包时，需指定依赖的其他jar

java -Dloader.path=./otherJars/BOOT-INF/lib/ -jar actuator_demo-0.0.1-SNAPSHOT-exec.jar

打war包

1. 修改packaging为war

<packaging>war</packaging>
1

2. 修改Tomcat的作用域为provider

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>
1
2
3
4
5

3. 新增 ServletInitializer 类 继承 SpringBootServletInitializer

public class ServletInitializer extends SpringBootServletInitializer {

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

}
1
2
3
4
5
6
7
8

参考文章：http://itboyhub.com/2021/01/25/spring-boot2-jar/