SpringBoot文档之Jar文件格式的阅读笔记

• The Executable Jar Format
  使用spring-boot-maven-plugin构建项目时，生成的目标jar文件的格式的说明。

• Nested JARs
  以JarLauncher为例：

  • META-INF/MANIFEST.MF，定义jar的元数据。
  • org.springframework.boot.loader.launch.JarLauncher.class，jar的启动类。
  • BOOT-INF/classes/，放置项目源码构建得到的class文件。
  • BOOT-INF/lib/，放置项目依赖的jar文件。

• Spring Boot’s “NestedJarFile” Class

• Launching Executable Jars
  文件META-INF/MANIFEST.MF的关键内容，样例如下：

  Main-Class: org.springframework.boot.loader.launch.JarLauncher
  Start-Class: net.jackieathome.MyApplication
  

  org.springframework.boot.loader.launch.JarLauncher为启动类。
  net.jackieathome.MyApplication为项目的主入口。

  常见的启动类，如下：

  • org.springframework.boot.loader.launch.JarLauncher
    从BOOT-INF/lib/下加载项目依赖的jar文件。
  • org.springframework.boot.loader.launch.WarLauncher
    从WEB-INF/lib/和WEB-INF/lib-provided/下加载项目依赖的jar文件。
  • org.springframework.boot.loader.launch.PropertiesLauncher
    从BOOT-INF/lib/下加载项目依赖的jar文件，其它特性可参考PropertiesLauncher Features。

• PropertiesLauncher Features

• Executable Jar Restrictions
  注意事项：

  • 嵌入到目标文件中的jar的压缩方式。
  • 类加载器的选择，目前只支持Thread.getContextClassLoader()。使用其它方式加载类的组件，和SpringBoot无法自然集成。

• Alternative Single Jar Solutions
  假如无法使用SpringBoot提供的uber jar或者fat jar方案，可行的替代方案，如下：

  • Maven Shade Plugin
  • JarClassLoader
  • OneJar
  • Gradle Shadow Plugin

参考资料

• 你了解 SpringBoot java -jar 的启动原理吗？
• Spring Boot 打成的 jar 和普通的 jar
• 为什么SpringBoot的jar可以直接运行