Spring Boot 生成 jar/war包的布局应用

在 Spring Boot 中,"布局应用"(Application Layout)指的是打包生成的可执行 jar 或 war 文件中的内容组织结构。Spring Boot 使用一种特殊的布局来确保打包的应用可以通过 java -jar 命令直接运行,同时内嵌 Servlet 容器(如 Tomcat、Jetty 或 Undertow)也被包含在内,使得应用可以作为一个独立的微服务运行,无需外部的 Servlet 容器。

标准的 Java 应用布局:

在传统的 Java 应用中,一个 jar 文件通常包含以下结构:

js 复制代码
my-application.jar
│
├── META-INF
│   └── MANIFEST.MF
├── com
│   └── example
│       └── MyApplication.class
└── lib
    ├── dependency1.jar
    ├── dependency2.jar
    └── ...
  • META-INF/MANIFEST.MF 文件包含元数据,如主类(Main-Class)。
  • 应用的类文件(如 MyApplication.class)直接包含在 jar 文件的根目录下。
  • 依赖的库(如 dependency1.jardependency2.jar)通常位于 lib 目录下,或者完全分离,需要在运行时通过类路径(classpath)指定。

Spring Boot 的可执行 jar 布局:

Spring Boot 改变了这种布局来支持自包含的、可执行的 jar 文件,这种文件被称为"胖 jar"(Fat Jar)或"超级 jar"(Uber Jar),其结构如下:

vbnet 复制代码
vbnetCopy code
my-spring-boot-application.jar
│
├── META-INF
│   ├── MANIFEST.MF
│   └── ...
├── org
│   └── springframework
│       └── boot
│           └── loader
│               ├── JarLauncher.class
│               ├── WarLauncher.class
│               ├── ...
│
├── BOOT-INF
│   ├── classes
│   │   └── com
│   │       └── example
│   │           └── MyApplication.class
│   │
│   └── lib
│       ├── spring-boot-starter-web-2.3.0.RELEASE.jar
│       ├── my-other-dependency-1.0.0.jar
│       └── ...
│
└── application.properties
  • META-INF/MANIFEST.MF 包含 Spring Boot 特有的元数据,指定了使用 Spring Boot 类加载器框架的启动类(如 JarLauncher)。
  • 应用的类文件被放在 BOOT-INF/classes 目录下。
  • 应用的所有依赖库被放在 BOOT-INF/lib 目录下。
  • Spring Boot 的类加载器框架相关的类位于 org/springframework/boot/loader 下,这些类负责正确地加载 BOOT-INF 下的类和库。

为什么需要这种特殊布局:

这种特殊的布局允许 Spring Boot 应用将自己的类和第三方库隔离开来,避免了类路径冲突的问题,并确保了应用可以作为一个独立的单元被运行。这种布局使得部署和分发 Spring Boot 应用变得非常简单,因为所有需要的东西都被封装在一个文件内,无需额外的配置或外部依赖。

相关推荐
Flittly2 天前
【AgentScope Java新手村系列】(16)从RAG到多路检索
java·spring boot·spring
人活一口气2 天前
从JVM调优到MCP协议:Java全栈技术体系深度总结与企业级架构实践
java·spring boot
Java陈序员3 天前
企业级!一个基于 Java 开发的开源 AI 应用开发平台!
spring boot·agent·mcp
杨运交3 天前
[041][公共模块]分布式唯一ID生成器设计与实现:一款灵活可扩展的雪花算法框架
spring boot
Flittly4 天前
【AgentScope Java新手村系列】(14)人机交互
java·spring boot·spring
Flynt5 天前
从Spring Boot 4.0升到4.1,我在Maven和gRPC上栽了跟头
java·spring boot·后端
掉鱼的猫6 天前
Spring Boot → Solon 注解迁移实战指南:一张对照表说清楚
java·spring boot
人活一口气7 天前
Spring Boot与AIGC的完美结合:从零搭建智能内容生成平台
java·spring boot·aigc
java小白小10 天前
SpringBoot(01): 初识SpringBoot,从Spring的痛点说起
spring boot
用户31693538118310 天前
如何从零编写一个 Spring Boot Starter
spring boot