本文分享自华为云社区
《【Spring Boot 源码学习】初识 SpringApplication》
,作者: Huazie。

引言

往期的博文,Huazie 围绕 Spring Boot 的核心功能,带大家从总整体上了解 Spring Boot 自动配置的原理以及自动配置核心组件的运作过程。这些内容大家需要重点关注,只有了解这些基础的组件和功能,我们在后续集成其他三方类库的 Starters 时,才能够更加清晰地了解它们都运用了自动配置的哪些功能。

在学习上述 Spring Boot 核心功能的过程中,相信大家可能都会尝试启动自己新建的 Spring Boot 的项目,并 Debug 看看具体的执行过程。本篇开始就将从 Spring Boot 的启动类
SpringApplication
上入手,带领大家了解 Spring Boot 启动过程中所涉及到的源码和知识点。

主要内容

1. Spring Boot 应用程序的启动

在 《
【Spring Boot 源码学习】@SpringBootApplication 注解
》这篇博文中,我们新建了一个基于 Spring Boot 的测试项目。

image.png

如上图中的
DemoApplication
就是我们这里 Spring Boot 项目的入口类。

同时,我们可以看到
DemoApplication

main
方法中,直接调用了
SpringApplication
的静态方法
run
,用于启动整个 Spring Boot 项目。

先来看看
run
方法的源码:

public static ConfigurableApplicationContext run(Class<?>primarySource, String... args) {return run(new Class<?>[] { primarySource }, args);
}
public static ConfigurableApplicationContext run(Class<?>[] primarySources, String[] args) {return newSpringApplication(primarySources).run(args);
}

阅读上述
run
方法,我们可以看到实际上是
new
了一个
SpringApplication
对象【其构造参数
primarySources
为加载的主要资源类,通常就是
SpringBoot
的入口类】,并调用其
run
方法【其参数
args
为传递给应用程序的参数信息】启动,然后返回一个应用上下文对象
ConfigurableApplicationContext

通过观察这个内部的
run
方法实现,我们也可以在自己的 Spring Boot 启动入口类中,像如下这样去写 :

@SpringBootApplicationpublic classDemoApplication {public static voidmain(String[] args) {
SpringApplication springApplication
= new SpringApplication(DemoApplication.class);//这里可以调用 SpringApplication 提供的 setXX 或 addXX 方法来定制化设置 springApplication.run(args);
}

}

2. SpringApplication 的实例化

上面已经看到我们在实例化
SpringApplication
了,废话不多说,直接翻看其源码【Spring Boot 2.7.9】:

    public SpringApplication(Class<?>... primarySources) {this(null, primarySources);
}

@SuppressWarnings({
"unchecked", "rawtypes"})public SpringApplication(ResourceLoader resourceLoader, Class<?>... primarySources) {this.resourceLoader =resourceLoader;
Assert.notNull(primarySources,
"PrimarySources must not be null");this.primarySources = new LinkedHashSet<>(Arrays.asList(primarySources));//推断web应用类型 this.webApplicationType =WebApplicationType.deduceFromClasspath();//加载并初始化 BootstrapRegistryInitializer及其实现类 this.bootstrapRegistryInitializers = new ArrayList<>(
getSpringFactoriesInstances(BootstrapRegistryInitializer.
class));//加载并初始化 ApplicationContextInitializer及其实现类 setInitializers((Collection) getSpringFactoriesInstances(ApplicationContextInitializer.class));//加载并初始化ApplicationListener及其实现类 setListeners((Collection) getSpringFactoriesInstances(ApplicationListener.class));//推断入口类 this.mainApplicationClass =deduceMainApplicationClass();
}

由上可知,
SpringApplication
提供了两个构造方法,而其核心的逻辑都在第二个构造方法中实现。

2.1 构造方法参数

我们从上述源码可知,
SpringApplication
的第二个构造方法有两个参数,分别是:

ResourceLoader resourceLoader

ResourceLoader
为资源加载的接口,它用于在Spring Boot 启动时打印对应的 banner 信息,默认采用的就是
DefaultResourceLoader
。实操过程中,如果未按照 Spring Boot 的 “约定” 将 banner 的内容放置于
classpath
下,或者文件名不是
banner.*
格式,默认资源加载器是无法加载到对应的 banner 信息的,此时则可通过
ResourceLoader
来指定需要加载的文件路径【这个后面我们专门来实操一下,敬请期待】。

Class<?>... primarySources
:主要的 bean 来源,该参数为可变参数,默认我们会传入 Spring Boot 的入口类【即
main
方法所在的类】,如上面我们的
DemoApplication
。如果作为项目的引导类,该类需要满足一个条件,就是被注解
@EnableAutoConfiguration
或其组合注解标注。在前面的《
【Spring Boot 源码学习】@SpringBootApplication 注解
》博文中,我们已经知道
@SpringBootApplication
注解中包含了
@EnableAutoConfiguration
注解,因此被
@SpringBootApplication
注解标注的类也可作为参数传入。当然,
primarySources
也可传入其他普通类,但只有传入被
@EnableAutoConfiguration
标注的类才能够开启 Spring Boot 的自动配置。

有些朋友,可能对
primarySources
这个可变参数的描述有点疑惑,下面我们就用实例来演示以其他引导类为入口类进行 Spring Boot 项目启动:

首先,我们在入口类
DemoApplication
的同级目录创建一个
SecondApplication
类,使用
@SpringBootApplication
进行注解。

@SpringBootApplicationpublic classSecondApplication {
}

然后,将
DemoApplication
修改成如下:

public classDemoApplication {public static voidmain(String[] args) {
SpringApplication.run(SecondApplication.
class, args);
}
}

最后,我们来运行
DemoApplication

main
方法。

image.png

从上图可以看出,我们的应用依然能正常启动,并完成自动配置。因此,决定 Spring Boot 启动的入口类并不是一定是
main
方法所在类,而是直接或间接被
@EnableAutoConfiguration
标注的类。

翻看
SpringApplication
的源码,我们在其中还能看到它提供了追加
primarySources
的方法,如下所示:

public void addPrimarySources(Collection<Class<?>>additionalPrimarySources) {this.primarySources.addAll(additionalPrimarySources);
}

如果采用 1 中最后的方式启动 Spring Boot ,我们就可以调用
addPrimarySources
方法来追加额外的
primarySources

我们继续回到
SpringApplication
的构造方法里,可以看到如下的代码:

this.primarySources = new LinkedHashSet<>(Arrays.asList(primarySources));

上述这里将
primarySources
参数转换为
LinkedHashSet
集合,并赋值给
SpringApplication
的私有成员变量
Set<Class<?>> primarySources

知识点:
LinkedHashSet
是 Java 集合框架中的类,它继承自
HashSet
,因此具有哈希表的查找性能。这是一个同时使用链表和哈希表特性的数据结构,其中链表用于维护元素的插入顺序。也即是说,当你向
LinkedHashSet
添加元素时,元素将按照添加的顺序被存储,并且能够被遍历输出。

此外,
LinkedHashSet
还确保了 元素的唯一性,即重复的元素在集合中只会存在一份。

如果需要频繁遍历集合,那么
LinkedHashSet
可能会比
HashSet
效率更高,因为其通过维护一个双向链表来记录元素的添加顺序,从而支持按照插入顺序排序的迭代。但需要注意的是,
LinkedHashSet
是非线程安全的,如果有多个线程同时访问该集合容器,可能会引发并发问题。

2.2 Web 应用类型推断

我们继续往下翻看源码,这里调用了
WebApplicationType

deduceFromClasspath
方法来进行 Web 应用类型的推断。

this.webApplicationType = WebApplicationType.deduceFromClasspath();

我们继续翻看
WebApplicationType
的源码:

public enumWebApplicationType {//非Web应用类型
NONE,//基于Servlet的Web应用类型
SERVLET,//基于reactive的Web应用类型
REACTIVE;private static final String[] SERVLET_INDICATOR_CLASSES = { "javax.servlet.Servlet","org.springframework.web.context.ConfigurableWebApplicationContext"};private static final String WEBMVC_INDICATOR_CLASS = "org.springframework.web.servlet.DispatcherServlet";private static final String WEBFLUX_INDICATOR_CLASS = "org.springframework.web.reactive.DispatcherHandler";private static final String JERSEY_INDICATOR_CLASS = "org.glassfish.jersey.servlet.ServletContainer";staticWebApplicationType deduceFromClasspath() {if (ClassUtils.isPresent(WEBFLUX_INDICATOR_CLASS, null) && !ClassUtils.isPresent(WEBMVC_INDICATOR_CLASS, null)&& !ClassUtils.isPresent(JERSEY_INDICATOR_CLASS, null)) {returnWebApplicationType.REACTIVE;
}
for(String className : SERVLET_INDICATOR_CLASSES) {if (!ClassUtils.isPresent(className, null)) {returnWebApplicationType.NONE;
}
}
returnWebApplicationType.SERVLET;
}
}

WebApplicationType
是一个定义了可能的Web应用类型的枚举类,该枚举类中包含了三块逻辑:

枚举类型 :非 Web 应用、基于 Servlet 的 Web 应用和基于 reactive 的 Web 应用。

用于下面推断的常量

推断类型的方法 deduceFromClasspath :


DispatcherHandler
存在,并且
DispatcherServlet

ServletContainer
都不存在,则返回类型为
WebApplicationType.REACTIVE


Servlet

ConfigurableWebApplicationContext
任何一个不存在时,则说明当前应用为非 Web 应用,返回
WebApplicationType.NONE

当应用不为 reactive Web 应用,并且
Servlet

ConfigurableWebApplicationContext
都存在的情况下,则返回
WebApplicationType.SERVLET

在上述的
deduceFromClasspath
方法中,我们可以看到,在判断的过程中使用到了
ClassUtils

isPresent
方法。该工具类方法就是通过反射创建指定的类,根据在创建过程中是否抛出异常来判断该类是否存在。

image.png

2.3 加载 BootstrapRegistryInitializer

this.bootstrapRegistryInitializers = new ArrayList<>(
getSpringFactoriesInstances(BootstrapRegistryInitializer.
class));

上述逻辑用于加载并初始化
BootstrapRegistryInitializer
及其相关的类。

BootstrapRegistryInitializer
是 Spring Cloud Config 的组件之一,它的作用是在应用程序启动时初始化 Spring Cloud Config 客户端。

在 Spring Cloud Config 中,客户端通过向配置中心(Config Server)发送请求来获取应用程序的配置信息。而
BootstrapRegistryInitializer
就是负责将配置中心的相关信息注册到 Spring 容器中的。

由于篇幅有限,有关
BootstrapRegistryInitializer
更详细的内容,笔者后续专门讲解。

2.4 加载 ApplicationContextInitializer

setInitializers((Collection) getSpringFactoriesInstances(ApplicationContextInitializer.class));

上述代码用于加载并初始化
ApplicationContextInitializer
及其相关的类。

ApplicationContextInitializer
是 Spring 框架中的一个接口,它的主要作用是在Spring容器刷新之前初始化
ConfigurableApplicationContext
。这个接口的实现类可以被视为回调函数,它们的
onApplicationEvent
方法会在Spring 容器启动时被自动调用,从而允许开发人员在容器刷新之前执行一些自定义的操作。

例如,我们可能需要在这个时刻加载一些配置信息,或者对某些 bean 进行预处理等。通过实现
ApplicationContextInitializer
接口并重写其
onApplicationEvent
方法,就可以完成这些定制化的需求。

由于篇幅有限,有关
ApplicationContextInitializer
更详细的内容,笔者后续专门讲解。

2.5 加载 ApplicationListener

setListeners((Collection) getSpringFactoriesInstances(ApplicationListener.class));

上述代码用于加载并初始化
ApplicationListener
及其相关的类。

ApplicationListener
是 Spring 框架提供的一个事件监听机制,它是Spring 应用内部的事件驱动机制,通常被用于监控应用内部的运行状况。其实现的原理是 观察者设计模式,该设计模式的初衷是为了实现系统业务逻辑之间的解耦,从而提升系统的可扩展性和可维护性。

我们可以通过自定义一个类来实现
ApplicationListener
接口,然后在这个类中定义需要监听的事件处理方法。当被监听的事件发生时,Spring 会自动调用这个方法来处理事件。例如,在一个 Spring Boot 项目中,我们可能想要在容器启动时执行一些特定的操作,如加载配置等,就可以通过实现
ApplicationListener
接口来完成。

由于篇幅有限,有关
ApplicationListener
更详细的内容,笔者后续专门讲解。

2.6 推断应用入口类

最后一步,调用
SpringApplication

deduceMainApplicationClass
方法来进行入口类的推断:

private Class<?>deduceMainApplicationClass() {try{
StackTraceElement[] stackTrace
= newRuntimeException().getStackTrace();for(StackTraceElement stackTraceElement : stackTrace) {if ("main".equals(stackTraceElement.getMethodName())) {returnClass.forName(stackTraceElement.getClassName());
}
}
}
catch(ClassNotFoundException ex) {//这里捕获异常,并继续执行后续逻辑 }return null;
}

上述代码的思路就是:

  • 首先,创建一个运行时异常,并获得其堆栈数组。
  • 接着,遍历数组,判断类的方法中是否包含
    main
    方法。第一个被匹配的类会通过
    Class.forName
    方法创建对象,并将其被返回。
  • 最后,将上述创建的
    Class
    对象赋值给
    SpringApplication
    的成员变量
    mainApplicationClass

总结

本篇 Huazie 带大家初步了解了 SpringApplication 的实例化过程,当然由于篇幅受限,还有些内容暂时无法详解,Huazie 将在后续的博文中继续深入分析。

只有了解 Spring Boot 在启动时都做了些什么,我们才能在后续的实践的过程中更好地理解其运行机制,以便遇到问题能更快地定位和排查,使我们应用能够更容易、更方便地接入 Spring Boot 。

点击关注,第一时间了解华为云新鲜技术~

标签: none

添加新评论