创建可执行 JAR 文件
📦 创建可执行 JAR 文件
🔹 概述
在完成示例的最后环节,我们将创建一个完全自包含的可执行 jar
文件,该文件可直接在生产环境运行。可执行 jar
(又称 uber jar
或 fat jar
)是一种包含编译后类文件及全部运行时依赖包的归档文件。
🌐 可执行 JAR 与 Java 的兼容性
❗ 问题
Java 原生不支持加载嵌套 jar
文件(即包含在 jar
内的其他 jar
文件),这一特性在分发独立应用程序时会造成不便。
🔄 解决方案对比
🔸 传统方案:uber jar
将所有依赖库的类文件打包进单一归档,但存在以下缺陷:
1️⃣ 难以识别应用程序实际使用的库文件
2️⃣ 当不同 jar
中包含同名文件时会产生冲突
🔹 Spring Boot 方案
采用创新方案,支持原生嵌套 jar
文件结构。
🏗 Maven 构建方式
1️⃣ 配置插件
在 pom.xml
文件的 dependencies
章节之后添加 spring-boot-maven-plugin
插件配置:
<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins>
</build>
⚠ 注意
使用 spring-boot-starter-parent
作为父 POM
时会自动配置 repackage
目标,否则需手动声明(详见插件文档)。
2️⃣ 执行打包命令
在命令行运行打包指令:
$ mvn package
📌 输出示例
[INFO] Building jar: /Users/developer/example/spring-boot-example/target/myproject-0.0.1-SNAPSHOT.jar
[INFO] BUILD SUCCESS
3️⃣ 检查生成文件
• 🏷 主文件:18MB 左右的 myproject-0.0.1-SNAPSHOT.jar
• ⏮ 原始文件:体积较小的 myproject-0.0.1-SNAPSHOT.jar.original
(Spring Boot 重打包前的初始文件)
4️⃣ 运行应用
$ java -jar target/myproject-0.0.1-SNAPSHOT.jar
🖥 控制台将显示 Spring Boot 启动日志,按 ctrl-c
可退出应用。
📦 Gradle 构建方式
1️⃣ 执行构建命令
$ gradle bootJar
📌 输出示例
BUILD SUCCESSFUL in 639ms
2️⃣ 检查生成文件
在 build/libs
目录可找到约 18MB 的 jar
文件,使用以下命令查看内容:
$ jar tvf build/libs/myproject-0.0.1-SNAPSHOT.jar
3️⃣ 运行应用
$ java -jar build/libs/myproject-0.0.1-SNAPSHOT.jar
🔄 运行效果与 Maven
版本一致,通过 ctrl-c
终止应用。
📚 [术语对照]
• 🏷 uber jar
- 超级归档包
• 📦 fat jar
- 胖归档包
• 🔄 nested jar
- 嵌套式归档包
• ⚙ repackage goal
- 重新打包目标
• 📂 build/libs directory
- 构建/库目录