SpringBoot的java -jar命令启动原理解读

更新时间：2024年02月26日 11:03:40 作者：寒山道杳

这篇文章主要介绍了SpringBoot的java -jar命令启动原理,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

导语

在运用Spring Boot 后，我们基本上摆脱之前项目每次上线的时候把项目打成war包。

当然也不排除一些奇葩的规定，必须要用war包上线，不过很多时候，我们对一些东西只是处在使用的阶段，并不会去深入的研究使用的原理是什么，这貌似也是大多数人的固定思维。

或许正是如此，总会有些没有固定思维的人会去积极的探索原理，当然这话不是说我是积极的，我其实也是只原理的搬运工。

今天和大家来简单的说下Spring Boot 的项目在运行Java -jar的原理。

jar包目录和jar命令启动入口

在正式开始之前，我们先来看看把jar包进行解压。

然后用tree /f命令查看目录结构（由于笔者写博文时用的是window，所以用的是tree /f命令），由于目录结构太长，这里做了相应省略，如下：

├─BOOT-INF
│  ├─classes
│  │  │  application.properties
│  │  │
│  │  └─com
│  │      └─spring
│  │          └─boot
│  │              └─test
│  │                      SpringBootTestApplication.class
│  │
│  └─lib
│          classmate-1.5.1.jar
│          hibernate-validator-6.0.18.Final.jar
│          …………此处省略…………
│
├─META-INF
│  │  MANIFEST.MF
│  │
│  └─maven
│      └─com.spring.boot.test
│          └─spring-boot-test
│                  pom.properties
│                  pom.xml
│
└─org
    └─springframework
        └─boot
            └─loader
                │  ExecutableArchiveLauncher.class
                │  JarLauncher.class
                │  LaunchedURLClassLoader$UseFastConnectionExceptionsEnumeration.class
                │  LaunchedURLClassLoader.class
                │  Launcher.class
                │  MainMethodRunner.class
                │  PropertiesLauncher$1.class
                │  PropertiesLauncher$ArchiveEntryFilter.class
                │  PropertiesLauncher$PrefixMatchingArchiveFilter.class
                │  PropertiesLauncher.class
                │  WarLauncher.class
                │
                ├─archive
                │      Archive$Entry.class
                │      …………此处省略…………
                │
                ├─data
                │      RandomAccessData.class
                │      …………此处省略…………
                │
                ├─jar
                │      AsciiBytes.class
                │      Bytes.class
                │      …………此处省略…………
                │
                └─util
                        SystemPropertyUtils.class

先简单说下上面目录结构，大体目录分三层：BOOT-INF、META-INF、org，BOOT-INF是存放对应的应用服务的.class文件和Maven依赖的jar包，包括启动类SpringBootTestApplication，META-INF下存放的是Maven相关的pom信息和MANIFEST.MF文件，org文件夹下存放的是Spring boot loader模块编译的.class文件，也就是jar启动的关键代码所在。

在执行java -jar命令的时候，它的启动类配置实在jar包目录下META-INF文件夹下的名MANIFEST.MF文件中，在这个文件中有一个名为Main-Class的属性，我们来看下这个文件的具体内容：

Manifest-Version: 1.0
Implementation-Title: spring-boot-test
Implementation-Version: 0.0.1-SNAPSHOT
Start-Class: com.spring.boot.test.SpringBootTestApplication
Spring-Boot-Classes: BOOT-INF/classes/
Spring-Boot-Lib: BOOT-INF/lib/
Build-Jdk-Spec: 1.8
Spring-Boot-Version: 2.2.3.RELEASE
Created-By: Maven Archiver 3.4.0
Main-Class: org.springframework.boot.loader.JarLauncher

从上面的配置文件中，可以看到Main-Class属性指向的Class为org.springframework.boot.loader.JarLauncher，而JarLauncher是JAR的启动器，这个类是在org/springframework/boot/loader/,然后可以看到项目所定义的启动类是指向Start-Class这个属性的。

JAR文件启动器——JarLauncher

在上面我们说了JarLauncher是JAR可执行的启动器，那么它和项目的启动类SpringBootTestApplication有什么关联呢？

先给大家来个示例，先来到解压目录下执行命令：java org.springframework.boot.loader.JarLauncher ，然后便是如下界面：

C:\Users\elisha\Desktop\spring-boot-test-0.0.1-SNAPSHOT>java org.springframework.boot.loader.JarLauncher
 
  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.2.3.RELEASE)
2020-01-18 14:28:19.866  INFO 3644 --- [           main] c.s.boot.test.SpringBootTestApplication  : Starting SpringBootTestApplication on LAPTOP-R2NNI9CM with PID 3644 (C:\Users\elisha\Desktop\spring-boot-test-0.0.1-SNAPSHOT\BOOT-INF\classes started by elisha in C:\Users\elisha\Desktop\spring-boot-test-0.0.1-SNAPSHOT)

从上面的执行接口可以看到项目引导类SpringBootTestApplication会被JarLauncher类进行引导，但是如果我们到BOOT-INF/class目录下，然后也执行java com.spring.boot.test.SpringBootTestApplication,会报SpringApplication的ClassNotFoundException这个错误，由此可以得知这是因为java命令未指定Class Path。

不过当前Spring Boot依赖的JAR文件都是存放在BOOT-INF/lib下，而org.springframework.boot.loader.JarLauncher会将JAR作为SpringBootTestApplication类库的依赖，这也就是为什么JarLauncher能引导SpringBootTestApplication，反之则是不可以的，那么对于SpringBootTestApplication是JarLauncher的子进程，还是处于同一层级呢？

接下来我们来看看JarLauncher的原理。

JarLauncher实现引导原理

因为org.springframework.boot.loader.JarLauncher的类是在spring-boot-loader中，但是若想在IDEA中来看源码，需要在pom文件中引入如下配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-loader</artifactId>
    <scope>provided</scope>
</dependency>

在引入上面的配置文件后，便可以在IDEA中查看源码了，使用CTRL+N命令来搜索JarLauncher类，那就来看下源码，如下：

public class JarLauncher extends ExecutableArchiveLauncher {
 
	static final String BOOT_INF_CLASSES = "BOOT-INF/classes/";
 
	static final String BOOT_INF_LIB = "BOOT-INF/lib/";
 
	public JarLauncher() {
	}
 
	protected JarLauncher(Archive archive) {
		super(archive);
	}
 
	@Override
	protected boolean isNestedArchive(Archive.Entry entry) {
		if (entry.isDirectory()) {
			return entry.getName().equals(BOOT_INF_CLASSES);
		}
		return entry.getName().startsWith(BOOT_INF_LIB);
	}
 
	public static void main(String[] args) throws Exception {
		new JarLauncher().launch(args);
	}
 
}

从上面的JarLauncher类中，可以看到两个常量：BOOT_INF_CLASSES、BOOT_INF_LIB，而它们又分别指向如下路径：BOOT-INF/classes/、BOOT-INF/lib/，并用isNestedArchive(Archive.Entry entry)方法进行判断（在Spring Boot中Archive，抽象出了Archive的概念，一个Archive可以是一个Jar（JarFileArchive）、也可以是一个目录（ExplodedArchive），在这里可以理解为Spring Boot抽象出来的同一访问资源层。），从isNestedArchive方法的参数Archive.Entry对象貌似为一个JAR文件中的资源，譬如application.properties，同时这个对象和JarEntry是类似的，其name属性（Archive.Entry#getName()）便是Jar资源的相对路径。当application.properties资源在FAT JAR目录下时，其实Archive.Entry#getName()就是/BOOT-INF/classes/application.properties,此时便符合startsWith方法的判断，所以isNestedArchive(Archive.Entry entry)便返回为true。

当返回为false时，便说明FAT JAR被解压到文件目录了，由此也说明了Spring Boot应用可以通过java org.springframework.boot.loader.JarLauncher 命令启动的原因了。

Archive.Entry的实现

上面说了在Spring Boot中Archive，抽象出了Archive的概念，一个Archive可以是一个Jar（JarFileArchive）、也可以是一个目录（ExplodedArchive），这里所说的JarFileArchive、ExplodedArchive便是Archive的两种是想方式，对于这两个类的实现代码感兴趣额同学可以自己去看看。

不过由此也说明了JarLauncher 既支持JAR启动，又支持文件系统启动。

同时JarLauncher 在作为引导类的时候，当执行java -jar 命令式，/META-INF/ 下MANIFEST.MF文件中的Main-Class属性将调用它的,main(String [])方法，其实它还是调用JarLauncher #launch(args)方法，这个方法是实现基类Launcher，这里简单看下这个方法的实现：

protected void launch(String[] args) throws Exception {
	JarFile.registerUrlProtocolHandler();
	ClassLoader classLoader = createClassLoader(getClassPathArchives());
	launch(args, getMainClass(), classLoader);
}

总结

本篇文章简单的讲解了一下，java -jar命令的一个执行的原理，首先说了下jar包目录和jar命令启动入口，然后说了下JAR文件启动器——JarLauncher和JarLauncher实现引导原理，最后说了下Archive.Entry的实现，这个实现的原理也是比较复杂，后面如果有机会，会再写篇文章来进行说明。

这些仅为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

使用session实现简易购物车功能
这篇文章主要为大家详细介绍了使用session实现简易购物车功能，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-02-02
Java 括号匹配问题案例详解
这篇文章主要介绍了Java 括号匹配问题案例详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
2021-08-08
java直接插入排序示例
这篇文章主要介绍了java直接插入排序示例,插入排序的比较次数仍然是n的平方，但在一般情况下，它要比冒泡排序快一倍，比选择排序还要快一点。它常常被用在复杂排序算法的最后阶段，比如快速排序。
2014-05-05
SpringMVC自定义日期转换器方式
这篇文章主要介绍了SpringMVC如何自定义日期转换器问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-07-07
MyBatis与Spring整合过程实例解析
这篇文章主要介绍了MyBatis与Spring整合过程实例解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-02-02
Java死锁_动力节点Java学院整理
死锁是两个甚至多个线程被永久阻塞时的一种运行局面，这种局面的生成伴随着至少两个线程和两个或者多个资源。在这里我已写好一个简单的程序，它将会引起死锁方案然后我们就会明白如何分析它
2017-06-06
Java中程序的运行全过程
这篇文章主要介绍了Java中程序的运行全过程，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
Velocity基本语法介绍
以下是对Velocity的基本语法进行了深入的介绍。需要的朋友可以过来参考下
2013-08-08
Maven安装与配置图文教程
这篇文章主要为大家详细介绍了Maven安装与配置图文教程，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2018-10-10
Java DOM4J方式生成XML的方法
今天小编就为大家分享一篇Java DOM4J方式生成XML的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-07-07