likes
comments
collection
share

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

作者站长头像
站长
· 阅读数 4

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

标准的 Java 应用布局：

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

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.jar、dependency2.jar）通常位于 lib 目录下，或者完全分离，需要在运行时通过类路径（classpath）指定。

Spring Boot 的可执行 jar 布局：

Spring Boot 改变了这种布局来支持自包含的、可执行的 jar 文件，这种文件被称为“胖 jar”（Fat Jar）或“超级 jar”（Uber Jar），其结构如下：

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 应用变得非常简单，因为所有需要的东西都被封装在一个文件内，无需额外的配置或外部依赖。