SpringBoot的启动很简单,代码如下:
1 |
|
从代码上可以看出,调用了SpringApplication的静态方法run。这个run方法会构造一个SpringApplication的实例,然后再调用这里实例的run方法就表示启动SpringBoot。
因此,想要分析SpringBoot的启动过程,我们需要熟悉SpringApplication的构造过程以及SpringApplication的run方法执行过程即可。
我们以上述这段代码为例,分析SpringBoot的启动过程。
SpringApplication的构造过程
SpringApplication构造的时候内部会调用一个private方法initialize:
1 | public SpringApplication(Object... sources) { |
ApplicationContextInitializer,应用程序初始化器,做一些初始化的工作:
1 | public interface ApplicationContextInitializer<C extends ConfigurableApplicationContext> { |
ApplicationListener,应用程序事件(ApplicationEvent)监听器:
1 | public interface ApplicationListener<E extends ApplicationEvent> extends EventListener { |
这里的应用程序事件(ApplicationEvent)有应用程序启动事件(ApplicationStartedEvent),失败事件(ApplicationFailedEvent),准备事件(ApplicationPreparedEvent)等。
应用程序事件监听器跟监听事件是绑定的。比如ConfigServerBootstrapApplicationListener只跟ApplicationEnvironmentPreparedEvent事件绑定,LiquibaseServiceLocatorApplicationListener只跟ApplicationStartedEvent事件绑定,LoggingApplicationListener跟所有事件绑定等。
默认情况下,initialize方法从spring.factories文件中找出的key为ApplicationContextInitializer的类有:
- org.springframework.boot.context.config.DelegatingApplicationContextInitializer
- org.springframework.boot.context.ContextIdApplicationContextInitializer
- org.springframework.boot.context.ConfigurationWarningsApplicationContextInitializer
- org.springframework.boot.context.web.ServerPortInfoApplicationContextInitializer
- org.springframework.boot.autoconfigure.logging.AutoConfigurationReportLoggingInitializer
key为ApplicationListener的有:
- org.springframework.boot.context.config.ConfigFileApplicationListener
- org.springframework.boot.context.config.AnsiOutputApplicationListener
- org.springframework.boot.logging.LoggingApplicationListener
- org.springframework.boot.logging.ClasspathLoggingApplicationListener
- org.springframework.boot.autoconfigure.BackgroundPreinitializer
- org.springframework.boot.context.config.DelegatingApplicationListener
- org.springframework.boot.builder.ParentContextCloserApplicationListener
- org.springframework.boot.context.FileEncodingApplicationListener
- org.springframework.boot.liquibase.LiquibaseServiceLocatorApplicationListener
SpringApplication的执行
分析run方法之前,先看一下SpringApplication中的一些事件和监听器概念。
首先是SpringApplicationRunListeners类和SpringApplicationRunListener类的介绍。
SpringApplicationRunListeners内部持有SpringApplicationRunListener集合和1个Log日志类。用于SpringApplicationRunListener监听器的批量执行。
SpringApplicationRunListener看名字也知道用于监听SpringApplication的run方法的执行。
它定义了5个步骤:
- started(run方法执行的时候立马执行;对应事件的类型是ApplicationStartedEvent)
- environmentPrepared(ApplicationContext创建之前并且环境信息准备好的时候调用;对应事件的类型是ApplicationEnvironmentPreparedEvent)
- contextPrepared(ApplicationContext创建好并且在source加载之前调用一次;没有具体的对应事件)
- contextLoaded(ApplicationContext创建并加载之后并在refresh之前调用;对应事件的类型是ApplicationPreparedEvent)
- finished(run方法结束之前调用;对应事件的类型是ApplicationReadyEvent或ApplicationFailedEvent)
SpringApplicationRunListener目前只有一个实现类EventPublishingRunListener,它把监听的过程封装成了SpringApplicationEvent事件并让内部属性(属性名为multicaster)ApplicationEventMulticaster接口的实现类SimpleApplicationEventMulticaster广播出去,广播出去的事件对象会被SpringApplication中的listeners属性进行处理。
所以说SpringApplicationRunListener和ApplicationListener之间的关系是通过ApplicationEventMulticaster广播出去的SpringApplicationEvent所联系起来的。
SpringApplication的run方法代码如下:
1 | public ConfigurableApplicationContext run(String... args) { |
创建容器的方法createAndRefreshContext如下:
1 | private ConfigurableApplicationContext createAndRefreshContext( |
Spring容器的创建createApplicationContext方法如下:
1 | protected ConfigurableApplicationContext createApplicationContext() { |
Spring容器创建之后有个回调方法postProcessApplicationContext:
1 | protected void postProcessApplicationContext(ConfigurableApplicationContext context) { |
初始化器做的工作,比如ContextIdApplicationContextInitializer会设置应用程序的id;AutoConfigurationReportLoggingInitializer会给应用程序添加一个条件注解解析器报告等:
1 | protected void applyInitializers(ConfigurableApplicationContext context) { |
Spring容器的刷新refresh方法内部会做很多很多的事情:比如BeanFactory的设置,BeanFactoryPostProcessor接口的执行、BeanPostProcessor接口的执行、自动化配置类的解析、条件注解的解析、国际化的初始化等等。这部分内容会在之后的文章中进行讲解。
run方法中的Spring容器创建完成之后会调用afterRefresh方法,代码如下:
1 | protected void afterRefresh(ConfigurableApplicationContext context, |
这样run方法执行完成之后。Spring容器也已经初始化完成,各种监听器和初始化器也做了相应的工作。
总结
SpringBoot启动的时候,不论调用什么方法,都会构造一个SpringApplication的实例,然后调用这个实例的run方法,这样就表示启动SpringBoot。
在run方法调用之前,也就是构造SpringApplication的时候会进行初始化的工作,初始化的时候会做以下几件事:
- 把参数sources设置到SpringApplication属性中,这个sources可以是任何类型的参数。本文的例子中这个sources就是MyApplication的class对象
- 判断是否是web程序,并设置到webEnvironment这个boolean属性中
- 找出所有的初始化器,默认有5个,设置到initializers属性中
- 找出所有的应用程序监听器,默认有9个,设置到listeners属性中
- 找出运行的主类(main class)
SpringApplication构造完成之后调用run方法,启动SpringApplication,run方法执行的时候会做以下几件事:
- 构造一个StopWatch,观察SpringApplication的执行
- 找出所有的SpringApplicationRunListener并封装到SpringApplicationRunListeners中,用于监听run方法的执行。监听的过程中会封装成事件并广播出去让初始化过程中产生的应用程序监听器进行监听
- 构造Spring容器(ApplicationContext),并返回
3.1 创建Spring容器的判断是否是web环境,是的话构造AnnotationConfigEmbeddedWebApplicationContext,否则构造AnnotationConfigApplicationContext
3.2 初始化过程中产生的初始化器在这个时候开始工作
3.3 Spring容器的刷新(完成bean的解析、各种processor接口的执行、条件注解的解析等等) - 从Spring容器中找出ApplicationRunner和CommandLineRunner接口的实现类并排序后依次执行
例子
写了一个例子用来验证分析的启动逻辑,包括自定义的初始化器、监听器、ApplicationRunner和CommandLineRunner。
地址在:https://github.com/fangjian0423/springboot-analysis/tree/master/springboot-startup
</div>