创建可执行 JAR 文件

📦 创建可执行 JAR 文件

🔹 概述

在完成示例的最后环节,我们将创建一个完全自包含的可执行 jar 文件,该文件可直接在生产环境运行。可执行 jar(又称 uber jarfat jar)是一种包含编译后类文件及全部运行时依赖包的归档文件。


🌐 可执行 JAR 与 Java 的兼容性

问题

Java 原生不支持加载嵌套 jar 文件(即包含在 jar 内的其他 jar 文件),这一特性在分发独立应用程序时会造成不便。


🔄 解决方案对比

🔸 传统方案:uber jar

将所有依赖库的类文件打包进单一归档,但存在以下缺陷:

1️⃣ 难以识别应用程序实际使用的库文件

2️⃣ 当不同 jar 中包含同名文件时会产生冲突

🔹 Spring Boot 方案

采用创新方案,支持原生嵌套 jar 文件结构。


🏗 Maven 构建方式

1️⃣ 配置插件

pom.xml 文件的 dependencies 章节之后添加 spring-boot-maven-plugin 插件配置:

xml 复制代码
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

注意

使用 spring-boot-starter-parent 作为父 POM 时会自动配置 repackage 目标,否则需手动声明(详见插件文档)。


2️⃣ 执行打包命令

在命令行运行打包指令:

bash 复制代码
$ 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️⃣ 运行应用
bash 复制代码
$ java -jar target/myproject-0.0.1-SNAPSHOT.jar

🖥 控制台将显示 Spring Boot 启动日志,按 ctrl-c 可退出应用。


📦 Gradle 构建方式

1️⃣ 执行构建命令
bash 复制代码
$ gradle bootJar

📌 输出示例

复制代码
BUILD SUCCESSFUL in 639ms

2️⃣ 检查生成文件

build/libs 目录可找到约 18MB 的 jar 文件,使用以下命令查看内容:

bash 复制代码
$ jar tvf build/libs/myproject-0.0.1-SNAPSHOT.jar

3️⃣ 运行应用
bash 复制代码
$ java -jar build/libs/myproject-0.0.1-SNAPSHOT.jar

🔄 运行效果与 Maven 版本一致,通过 ctrl-c 终止应用。


📚 [术语对照]

• 🏷 uber jar - 超级归档包

• 📦 fat jar - 胖归档包

• 🔄 nested jar - 嵌套式归档包

• ⚙ repackage goal - 重新打包目标

• 📂 build/libs directory - 构建/库目录

相关推荐
白帽子凯哥哥1 天前
SpringBoot + Elasticsearch实战:从零构建高性能搜索与数据分析平台
大数据·spring boot·后端·elasticsearch·搜索引擎·性能优化·聚合查询
zl9798991 天前
SpringBoot-Web开发之嵌入式容器
java·spring boot
zl9798991 天前
SpringBoot-Web开发之请求参数处理
java·spring boot
不爱编程的小九九1 天前
小九源码-springboot097-java付费自习室管理系统
java·开发语言·spring boot
兜兜风d'1 天前
Spring Boot 整合 RabbitMQ :四大核心模式解析
spring boot·rabbitmq·java-rabbitmq
低音钢琴1 天前
【SpringBoot从初学者到专家的成长20】SpringBoot集成MongoDB:非关系型数据库的探索
spring boot·mongodb·nosql
lang201509281 天前
Spring Boot JMX与Jolokia监控实战
spring boot
zl9798991 天前
SpringBoot-数据访问之Druid
java·spring boot
linyb极客之路1 天前
Spring Boot Map 依赖注入血坑实录:为什么我的 Map 总是少了一半数据?
spring boot
zl9798991 天前
SpringBoot-Web开发之内容协商
java·spring boot