文章篇幅较长,但是包含了SpringBoot 可执行jar包从头到尾的原理,请读者耐心观看。同时文章是基于 SpringBoot-2.1.3进行分析。涉及的知识点主要包括Maven的生命周期以及自定义插件,JDK提供关于jar包的工具类以及Springboot如何扩展,最后是自定义类加载器

spring-boot-maven-plugin

SpringBoot 的可执行jar包又称 fat jar ,是包含所有第三方依赖的 jar 包,jar 包中嵌入了除 java 虚拟机以外的所有依赖,是一个 all-in-one jar 包。普通插件 maven-jar-plugin生成的包和 spring-boot-maven-plugin生成的包之间的直接区别,是 fat jar中主要增加了两部分,第一部分是lib目录,存放的是Maven依赖的jar包文件,第二部分是 spring boot loader相关的类。

  1. fat jar 目录结构

  2. ├─BOOT-INF

  3. ├─classes

  4. └─lib

  5. ├─META-INF

  6. ├─maven

  7. ├─app.properties

  8. ├─MANIFEST.MF

  9. └─org

  10. └─springframework

  11. └─boot

  12. └─loader

  13. ├─archive

  14. ├─data

  15. ├─jar

  16. └─util

也就是说想要知道 fat jar是如何生成的,就必须知道 spring-boot-maven-plugin工作机制,而 spring-boot-maven-plugin属于自定义插件,因此我们又必须知道,Maven的自定义插件是如何工作的

Maven的自定义插件

Maven 拥有三套相互独立的生命周期: cleandefaultsite, 而每个生命周期包含一些phase阶段, 阶段是有顺序的, 并且后面的阶段依赖于前面的阶段。生命周期的阶段phase与插件的目标goal相互绑定,用以完成实际的构建任务。

  1. <plugin>

  2. <groupId>org.springframework.boot</groupId>

  3. <artifactId>spring-boot-maven-plugin</artifactId>

  4. <executions>

  5. <execution>

  6. <goals>

  7. <goal>repackage</goal>

  8. </goals>

  9. </execution>

  10. </executions>

  11. </plugin>

repackage目标对应的将执行到 org.springframework.boot.maven.RepackageMojo#execute,该方法的主要逻辑是调用了 org.springframework.boot.maven.RepackageMojo#repackage

  1. private void repackage() throws MojoExecutionException {

  2. //获取使用maven-jar-plugin生成的jar,最终的命名将加上.orignal后缀

  3. Artifact source = getSourceArtifact();

  4. //最终文件,即Fat jar

  5. File target = getTargetFile();

  6. //获取重新打包器,将重新打包成可执行jar文件

  7. Repackager repackager = getRepackager(source.getFile());

  8. //查找并过滤项目运行时依赖的jar

  9. Set < Artifact > artifacts = filterDependencies(this.project.getArtifacts(), getFilters(getAdditionalFilters()));

  10. //将artifacts转换成libraries

  11. Libraries libraries = new ArtifactsLibraries(artifacts, this.requiresUnpack, getLog());

  12. try {

  13. //提供Spring Boot启动脚本

  14. LaunchScript launchScript = getLaunchScript();

  15. //执行重新打包逻辑,生成最后fat jar

  16. repackager.repackage(target, libraries, launchScript);

  17. } catch (IOException ex) {

  18. throw new MojoExecutionException(ex.getMessage(), ex);

  19. }

  20. //将source更新成 xxx.jar.orignal文件

  21. updateArtifact(source, target, repackager.getBackupFile());

  22. }

我们关心一下 org.springframework.boot.maven.RepackageMojo#getRepackager这个方法,知道 Repackager是如何生成的,也就大致能够推测出内在的打包逻辑。

  1. private Repackager getRepackager(File source) {

  2. Repackager repackager = new Repackager(source, this.layoutFactory);

  3. repackager.addMainClassTimeoutWarningListener(

  4. new LoggingMainClassTimeoutWarningListener());

  5. //设置main class的名称,如果不指定的话则会查找第一个包含main方法的类,repacke最后将会设置org.springframework.boot.loader.JarLauncher

  6. repackager.setMainClass(this.mainClass);

  7. if (this.layout != null) {

  8. getLog().info("Layout: " + this.layout);

  9. //重点关心下layout 最终返回了 org.springframework.boot.loader.tools.Layouts.Jar

  10. repackager.setLayout(this.layout.layout());

  11. }

  12. return repackager;

  13. }

  1. /**

  2. * Executable JAR layout.

  3. */

  4. public static class Jar implements RepackagingLayout {

  5. @Override

  6. public String getLauncherClassName() {

  7. return "org.springframework.boot.loader.JarLauncher";

  8. }

  9. @Override

  10. public String getLibraryDestination(String libraryName, LibraryScope scope) {

  11. return "BOOT-INF/lib/";

  12. }

  13. @Override

  14. public String getClassesLocation() {

  15. return "";

  16. }

  17. @Override

  18. public String getRepackagedClassesLocation() {

  19. return "BOOT-INF/classes/";

  20. }

  21. @Override

  22. public boolean isExecutable() {

  23. return true;

  24. }

  25. }

layout我们可以将之翻译为文件布局,或者目录布局,代码一看清晰明了,同时我们需要关注,也是下一个重点关注对象 org.springframework.boot.loader.JarLauncher,从名字推断,这很可能是返回可执行 jar文件的启动类。

MANIFEST.MF文件内容

  1. Manifest-Version: 1.0

  2. Implementation-Title: oneday-auth-server

  3. Implementation-Version: 1.0.0-SNAPSHOT

  4. Archiver-Version: Plexus Archiver

  5. Built-By: oneday

  6. Implementation-Vendor-Id: com.oneday

  7. Spring-Boot-Version: 2.1.3.RELEASE

  8. Main-Class: org.springframework.boot.loader.JarLauncher

  9. Start-Class: com.oneday.auth.Application

  10. Spring-Boot-Classes: BOOT-INF/classes/

  11. Spring-Boot-Lib: BOOT-INF/lib/

  12. Created-By: Apache Maven 3.3.9

  13. Build-Jdk: 1.8.0_171

repackager生成的MANIFEST.MF文件为以上信息,可以看到两个关键信息 Main-ClassStart-Class。我们可以进一步,程序的启动入口并不是我们SpringBoot中定义的 main,而是 JarLauncher#main,而再在其中利用反射调用定义好的 Start-Classmain方法

JarLauncher

重点类介绍

1、 java.util.jar.JarFile JDK工具类提供的读取 jar文件

2、 org.springframework.boot.loader.jar.JarFileSpringboot-loader 继承JDK提供 JarFile

3、 java.util.jar.JarEntryDK工具类提供的``jar```文件条目

4、 org.springframework.boot.loader.jar.JarEntry Springboot-loader 继承JDK提供 JarEntry

5、 org.springframework.boot.loader.archive.Archive Springboot抽象出来的统一访问资源的层

6、 JarFileArchivejar包文件的抽象

7、 ExplodedArchive文件目录

这里重点描述一下 JarFile的作用,每个 JarFileArchive都会对应一个 JarFile。在构造的时候会解析内部结构,去获取 jar包里的各个文件文件夹类。我们可以看一下该类的注释。

  1. /* Extended variant of {@link java.util.jar.JarFile} that behaves in the same way but

  2. * offers the following additional functionality.

  3. * <ul>

  4. * <li>A nested {@link JarFile} can be {@link #getNestedJarFile(ZipEntry) obtained} based

  5. * on any directory entry.</li>

  6. * <li>A nested {@link JarFile} can be {@link #getNestedJarFile(ZipEntry) obtained} for

  7. * embedded JAR files (as long as their entry is not compressed).</li>

  8. **/ </ul>

jar里的资源分隔符是 !/,在JDK提供的 JarFile URL只支持一个’!/‘,而Spring boot扩展了这个协议,让它支持多个’!/‘,就可以表示jar in jar、jar in directory、fat jar的资源了。

自定义类加载机制

最基础:Bootstrap ClassLoader(加载JDK的/lib目录下的类)

次基础:Extension ClassLoader(加载JDK的/lib/ext目录下的类)

普通:Application ClassLoader(程序自己classpath下的类)

首先需要关注双亲委派机制很重要的一点是,如果一个类可以被委派最基础的ClassLoader加载,就不能让高层的ClassLoader加载,这样是为了范围错误的引入了非JDK下但是类名一样的类。其二,如果在这个机制下,由于 fat jar中依赖的各个第三方 jar文件,并不在程序自己 classpath下,也就是说,如果我们采用双亲委派机制的话,根本获取不到我们所依赖的jar包,因此我们需要修改双亲委派机制的查找class的方法,自定义类加载机制

先简单的介绍Springboot2中 LaunchedURLClassLoader,该类继承了 java.net.URLClassLoader,重写了 java.lang.ClassLoader#loadClass(java.lang.String, boolean),然后我们再探讨他是如何修改双亲委派机制。

在上面我们讲到Spring boot支持多个’!/‘以表示多个jar,而我们的问题在于,如何解决查找到这多个jar包。我们看一下 LaunchedURLClassLoader的构造方法。

  1. public LaunchedURLClassLoader(URL[] urls, ClassLoader parent) {

  2. super(urls, parent);

  3. }

urls注释解释道 theURLsfromwhich to load classesandresources,即fat jar包依赖的所有类和资源,将该urls参数传递给父类 java.net.URLClassLoader,由父类的 java.net.URLClassLoader#findClass执行查找类方法,该类的查找来源即构造方法传递进来的urls参数

  1. //LaunchedURLClassLoader的实现

  2. protected Class <? > loadClass(String name, boolean resolve)

  3. throws ClassNotFoundException {

  4. Handler.setUseFastConnectionExceptions(true);

  5. try {

  6. try {

  7. //尝试根据类名去定义类所在的包,即java.lang.Package,确保jar in jar里匹配的manifest能够和关联的package关联起来

  8. definePackageIfNecessary(name);

  9. } catch (IllegalArgumentException ex) {

  10. // Tolerate race condition due to being parallel capable

  11. if (getPackage(name) == null) {

  12. // This should never happen as the IllegalArgumentException indicates

  13. // that the package has already been defined and, therefore,

  14. // getPackage(name) should not return null.

  15. //这里异常表明,definePackageIfNecessary方法的作用实际上是预先过滤掉查找不到的包

  16. throw new AssertionError("Package " + name + " has already been " + "defined but it could not be found");

  17. }

  18. }

  19. return super.loadClass(name, resolve);

  20. } finally {

  21. Handler.setUseFastConnectionExceptions(false);

  22. }

  23. }

方法 super.loadClass(name,resolve)实际上会回到了 java.lang.ClassLoader#loadClass(java.lang.String, boolean),遵循双亲委派机制进行查找类,而 BootstrapClassLoaderExtensionClassLoader将会查找不到fat jar依赖的类,最终会来到 ApplicationClassLoader,调用 java.net.URLClassLoader#findClass

如何真正的启动

Springboot2和Springboot1的最大区别在于,Springboo1会新起一个线程,来执行相应的反射调用逻辑,而SpringBoot2则去掉了构建新的线程这一步。方法是 org.springframework.boot.loader.Launcher#launch(java.lang.String[], java.lang.String, java.lang.ClassLoader)反射调用逻辑比较简单,这里就不再分析,比较关键的一点是,在调用 main方法之前,将当前线程的上下文类加载器设置成 LaunchedURLClassLoader

  1. protected void launch(String[] args, String mainClass, ClassLoader classLoader)

  2. throws Exception {

  3. Thread.currentThread().setContextClassLoader(classLoader);

  4. createMainMethodRunner(mainClass, args, classLoader).run();

  5. }

Demo

  1. public static void main(String[] args) throws ClassNotFoundException, MalformedURLException {

  2. JarFile.registerUrlProtocolHandler();

  3. // 构造LaunchedURLClassLoader类加载器,这里使用了2个URL,分别对应jar包中依赖包spring-boot-loader和spring-boot,使用 "!/" 分开,需要org.springframework.boot.loader.jar.Handler处理器处理

  4. LaunchedURLClassLoader classLoader = new LaunchedURLClassLoader(new URL[] {

  5. new URL("jar:file:/E:/IdeaProjects/oneday-auth/oneday-auth-server/target/oneday-auth-server-1.0.0-SNAPSHOT.jar!/BOOT-INF/lib/spring-boot-loader-1.2.3.RELEASE.jar!/"), new URL("jar:file:/E:/IdeaProjects/oneday-auth/oneday-auth-server/target/oneday-auth-server-1.0.0-SNAPSHOT.jar!/BOOT-INF/lib/spring-boot-2.1.3.RELEASE.jar!/")

  6. }, Application.class.getClassLoader());

  7. // 加载类

  8. // 这2个类都会在第二步本地查找中被找出(URLClassLoader的findClass方法)

  9. classLoader.loadClass("org.springframework.boot.loader.JarLauncher");

  10. classLoader.loadClass("org.springframework.boot.SpringApplication");

  11. // 在第三步使用默认的加载顺序在ApplicationClassLoader中被找出

  12. classLoader.loadClass("org.springframework.boot.autoconfigure.web.DispatcherServletAutoConfiguration");

  13. // SpringApplication.run(Application.class, args);

  14. }

Maven

  1. <dependency>

  2. <groupId>org.springframework.boot</groupId>

  3. <artifactId>spring-boot-loader</artifactId>

  4. <version>2.1.3.RELEASE</version>

  5. </dependency>

  6. <dependency>

  7. <groupId>org.springframework.boot</groupId>

  8. <artifactId>spring-boot-maven-plugin</artifactId>

  9. <version>2.1.3.RELEASE</version>

  10. </dependency>

总结

对于源码分析,这次的较大收获则是不能一下子去追求弄懂源码中的每一步代码的逻辑,即便我知道该方法的作用。我们需要搞懂的是关键代码,以及涉及到的知识点。我从Maven的自定义插件开始进行追踪,巩固了对Maven的知识点,在这个过程中甚至了解到JDK对jar的读取是有提供对应的工具类。最后最重要的知识点则是自定义类加载器。整个代码下来并不是说代码究竟有多优秀,而是要学习他因何而优秀。

敬请关注「搜云库技术团队」微信公众号,获取最新文章


评论关闭
IT干货网

微信公众号号:IT虾米 (左侧二维码扫一扫)欢迎添加!

java selenium常用API汇总