Java 不提供任何标准方法来加载嵌套的 jar 文件(即 jar 文件本身包含在 jar 中)。 如果您需要分发一个独立的应用程序,该应用程序可以从命令行运行而无需解压缩,这可能会有问题。
为了解决这个问题,许多开发人员使用“阴影”罐。 阴影罐将所有罐子中的所有类打包到一个“超级罐子”中。 阴影罐的问题在于,很难看到哪些库实际上在您的应用程序中。 如果在多个 jar 中使用相同的文件名(但内容不同),也可能有问题。 Spring Boot 采用了不同的方法,让您直接嵌套 jar。
可执行 jar 文件结构
与 Spring Boot Loader 兼容的 jar 文件应按以下方式构建:
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/classes
BOOT-INF/lib
可执行战争文件结构
与Spring Boot Loader兼容的war文件应按以下方式构建:
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/lib
WEB-INF/lib-provided
索引文件
与 Spring Boot Loader 兼容的 jar 和 war 存档可以在目录下包含其他索引文件。
可以为 jar 和 wars 提供文件,并提供应将 jar 添加到类路径的顺序。
该文件只能用于 jar,它允许将 jar 拆分为逻辑层,以便创建 Docker/OCI 映像。BOOT-INF/
classpath.idx
layers.idx
索引文件遵循 YAML 兼容的语法,以便第三方工具可以轻松解析它们。 但是,这些文件不会在内部解析为 YAML,它们必须完全按照下面描述的格式编写才能使用。
类路径索引
类路径索引文件可以在 中提供。
通常,它是由 Spring Boot 的 Maven 和 Gradle 构建插件自动生成的。
它提供了 jar 名称(包括目录)的列表,其顺序应将它们添加到类路径中。
当由构建插件生成时,此类路径排序与构建系统用于运行和测试应用程序的排序匹配。
每行必须以短划线空格 () 开头,并且名称必须用双引号引起来。BOOT-INF/classpath.idx
"-·"
例如,给定以下 jar:
example.jar
|
+-META-INF
| +-...
+-BOOT-INF
+-classes
| +...
+-lib
+-dependency1.jar
+-dependency2.jar
索引文件如下所示:
- "BOOT-INF/lib/dependency2.jar"
- "BOOT-INF/lib/dependency1.jar"
图层索引
图层索引文件可以在 中提供。
它提供了层和应包含在其中的罐子部分的列表。
层的写入顺序应添加到 Docker/OCI 映像中。
图层名称写成带引号的字符串,前缀为短划线空格 () 和冒号 () 后缀。
图层内容是以带引号的字符串编写的文件或目录名称,以空格、短划线、空格 () 为前缀。
目录名称以 结尾,文件名不以 结尾。
使用目录名称时,这意味着该目录中的所有文件都位于同一层中。BOOT-INF/layers.idx
"-·"
":"
"··-·"
/
图层索引的典型示例是:
- "dependencies":
- "BOOT-INF/lib/dependency1.jar"
- "BOOT-INF/lib/dependency2.jar"
- "application":
- "BOOT-INF/classes/"
- "META-INF/"