嵌套 JAR (Nested JARs) _ Spring Boot 3.3.2-SNAPSHOT 中文文档(官方文档中文翻译) —

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.1！Spring中文文档

Java 不提供任何标准方法来加载嵌套的 jar 文件（即 jar 文件本身包含在 jar 中）。如果您需要分发一个独立的应用程序，该应用程序可以从命令行运行而无需解压缩，这可能会有问题。Spring中文文档

为了解决这个问题，许多开发人员使用“阴影”罐。阴影罐将所有罐子中的所有类打包到一个“超级罐子”中。阴影罐的问题在于，很难看到哪些库实际上在您的应用程序中。如果在多个 jar 中使用相同的文件名（但内容不同），也可能有问题。 Spring Boot 采用了不同的方法，让您直接嵌套 jar。Spring中文文档

可执行 jar 文件结构

与 Spring Boot Loader 兼容的 jar 文件应按以下方式构建：Spring中文文档

example.jar
 |
 +-META-INF
 |  +-MANIFEST.MF
 +-org
 |  +-springframework
 |     +-boot
 |        +-loader
 |           +-<spring boot loader classes>
 +-BOOT-INF
    +-classes
    |  +-mycompany
    |     +-project
    |        +-YourClasses.class
    +-lib
       +-dependency1.jar
       +-dependency2.jar

应用程序类应放在嵌套目录中。依赖项应放在嵌套目录中。BOOT-INF/classesBOOT-INF/libSpring中文文档

可执行战争文件结构

与Spring Boot Loader兼容的war文件应按以下方式构建：Spring中文文档

example.war
 |
 +-META-INF
 |  +-MANIFEST.MF
 +-org
 |  +-springframework
 |     +-boot
 |        +-loader
 |           +-<spring boot loader classes>
 +-WEB-INF
    +-classes
    |  +-com
    |     +-mycompany
    |        +-project
    |           +-YourClasses.class
    +-lib
    |  +-dependency1.jar
    |  +-dependency2.jar
    +-lib-provided
       +-servlet-api.jar
       +-dependency3.jar

依赖项应放在嵌套目录中。运行嵌入式时需要但部署到传统 Web 容器时不需要的任何依赖项都应放在中。WEB-INF/libWEB-INF/lib-providedSpring中文文档

索引文件

与 Spring Boot Loader 兼容的 jar 和 war 存档可以在目录下包含其他索引文件。可以为 jar 和 wars 提供文件，并提供应将 jar 添加到类路径的顺序。该文件只能用于 jar，它允许将 jar 拆分为逻辑层，以便创建 Docker/OCI 映像。BOOT-INF/classpath.idxlayers.idxSpring中文文档

索引文件遵循 YAML 兼容的语法，以便第三方工具可以轻松解析它们。但是，这些文件不会在内部解析为 YAML，它们必须完全按照下面描述的格式编写才能使用。Spring中文文档

类路径索引

类路径索引文件可以在中提供。通常，它是由 Spring Boot 的 Maven 和 Gradle 构建插件自动生成的。它提供了 jar 名称（包括目录）的列表，其顺序应将它们添加到类路径中。当由构建插件生成时，此类路径排序与构建系统用于运行和测试应用程序的排序匹配。每行必须以短划线空格（）开头，并且名称必须用双引号引起来。BOOT-INF/classpath.idx"-·"Spring中文文档

例如，给定以下 jar：Spring中文文档

example.jar
 |
 +-META-INF
 |  +-...
 +-BOOT-INF
    +-classes
    |  +...
    +-lib
       +-dependency1.jar
       +-dependency2.jar

索引文件如下所示：Spring中文文档

- "BOOT-INF/lib/dependency2.jar"
- "BOOT-INF/lib/dependency1.jar"

图层索引

图层索引文件可以在中提供。它提供了层和应包含在其中的罐子部分的列表。层的写入顺序应添加到 Docker/OCI 映像中。图层名称写成带引号的字符串，前缀为短划线空格（）和冒号（）后缀。图层内容是以带引号的字符串编写的文件或目录名称，以空格、短划线、空格（）为前缀。目录名称以结尾，文件名不以结尾。使用目录名称时，这意味着该目录中的所有文件都位于同一层中。BOOT-INF/layers.idx"-·"":""··-·"/Spring中文文档

图层索引的典型示例是：Spring中文文档

- "dependencies":
  - "BOOT-INF/lib/dependency1.jar"
  - "BOOT-INF/lib/dependency2.jar"
- "application":
  - "BOOT-INF/classes/"
  - "META-INF/"