我以为只是运行了个main方法,可却启动了服务 —— 知码学院
引言
前一章我们讲解了启动原理的@SpringBootApplication
部分,仔细跟着看代码还是很好理解,若需观看@SpringBootApplication注解部分请点击,接下来这章主要讲解run方法运行部分,run方法运行这里很枯燥乏味,所以请带好你的精气神,准备好水,因为实在是太干了。
运行启动
工具
- SpringBoot版本:2.0.4
- 开发工具:IDEA 2018
- Maven:3.3 9
- JDK:1.8
我们继续看这段启动代码
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
SpringApplication.run分析
分析该方法主要分两部分,一是SpringApplication
实例化,二是run方法的执行。
#该方法返回一个ConfigurableApplicationContext对象
SpringApplication.run(MySpringConfigurationApp.class, args);//参数1-应用入口的类,参数2-命令行参数
分析点一、SpringApplication实例化
在SpringApplication实例初始化的时候,它会做 4 件有意义的事情:
-
推断应用类型是Standard还是Web
可能会出现三种结果REACTIVE
、NONE
、SERVLET
:this.webApplicationType = this.deduceWebApplicationType();//该行代码位于构造器中
-
查找并加载所有可用初始化器,设置到
initializers
属性中this.setInitializers(this.getSpringFactoriesInstances(ApplicationContextInitializer.class));//spring.factories处读取
-
找出所有的应用程序监听器,设置到
listeners
属性中。this.setListeners(this.getSpringFactoriesInstances(ApplicationListener.class));//该行代码位于构造器中
-
推断并设置main方法的定义类,意思就是找出运行的主类。
this.mainApplicationClass = this.deduceMainApplicationClass();//该行代码位于构造器中
至此,对于SpringApplication
实例的初始化过程就结束了,接下来进入方法调用环节。
分析点二、SpringApplication.run方法调用
接下来的过程比较枯燥无味,如果您跟着仔细看完,你一定有所收获。
执行流程图源文件:https://www.processon.com/view/link/5b825917e4b0d4d65be7066a PS 画图好累
流程图对应的代码如下
public ConfigurableApplicationContext run(String... args) {
//计时工具
StopWatch stopWatch = new StopWatch();
stopWatch.start();
ConfigurableApplicationContext context = null;
Collection<SpringBootExceptionReporter> exceptionReporters = new ArrayList();
// step1 设置java.awt.headless系统属性为true - 没有图形化界面
this.configureHeadlessProperty();
//step2 初始化监听器
SpringApplicationRunListeners listeners = this.getRunListeners(args);
//step3 启动已准备好的监听器,发布应用启动事件
listeners.starting();
Collection exceptionReporters;
try {
//step4 根据SpringApplicationRunListeners以及参数来装配环境,如java -jar xx.jar --server.port=8000
ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
ConfigurableEnvironment environment = this.prepareEnvironment(listeners, applicationArguments);
this.configureIgnoreBeanInfo(environment);
//step5 打印Banner 就是启动Spring Boot的时候打印在console上的ASCII艺术字体
Banner printedBanner = this.printBanner(environment);
//step6 创建Spring ApplicationContext()上下文
context = this.createApplicationContext();
//step7 准备异常报告器
exceptionReporters = this.getSpringFactoriesInstances(SpringBootExceptionReporter.class,
new Class[]{ConfigurableApplicationContext.class}, context);
//step8 装配Context,上下文前置处理
this.prepareContext(context, environment, listeners, applicationArguments, printedBanner);
//step9 Spring上下文刷新处理
this.refreshContext(context);
//step10 Spring上下文后置结束处理
this.afterRefresh(context, applicationArguments);
// 停止计时器监控
stopWatch.stop();
//输出日志记录执行主类名、时间信息
if (this.logStartupInfo) {
(new StartupInfoLogger(this.mainApplicationClass)).logStarted(this.getApplicationLog(), stopWatch);
}
//step11 发布应用上下文启动完成事件
listeners.started(context);
//step12 执行所有 Runner 运行器
this.callRunners(context, applicationArguments);
} catch (Throwable var10) {
this.handleRunFailure(context, var10, exceptionReporters, listeners);
throw new IllegalStateException(var10);
}
try {
//step13 发布应用上下文就绪事件
listeners.running(context);
//step14 返回应用上下文
return context;
} catch (Throwable var9) {
this.handleRunFailure(context, var9, exceptionReporters, (SpringApplicationRunListeners)null);
throw new IllegalStateException(var9);
}
}
代码解析
step1 java.awt.headless系统属性设置
this.configureHeadlessProperty();
Headless模式是系统的一种配置模式。设置该默认值为:true,Java.awt.headless = true
有什么作用?
对于一个 Java 服务器来说经常要处理一些图形元素,例如地图的创建或者图形和图表等。这些API基本上总是需要运行一个X-server以便能使用AWT(
Abstract Window Toolkit
,抽象窗口工具集)。然而运行一个不必要的 X-server 并不是一种好的管理方式。有时你甚至不能运行 X-server,因此最好的方案是运行 headless 服务器,来进行简单的图像处理。
方法声明如下:
private void configureHeadlessProperty() {
System.setProperty("java.awt.headless", System.getProperty("java.awt.headless", Boolean.toString(this.headless)));
}
step2 初始化监听器
SpringApplicationRunListeners listeners = this.getRunListeners(args);
该方法最终落到了loadSpringFactories
方法上,加载了META-INF/spring.factories
这个配置文件下的所有资源,并放入缓存,然后再获取了org.springframework.context.ApplicationListener
定义的资源列表。这些也就是SpringBoot的自动装配资源,然后获取到后存放到list中,并调用createSpringFactoriesInstances
函数创建了SpringFactories的实例。
方法声明如下:
private SpringApplicationRunListeners getRunListeners(String[] args) {
Class<?>[] types = new Class[]{SpringApplication.class, String[].class};
return new SpringApplicationRunListeners(logger,
this.getSpringFactoriesInstances(SpringApplicationRunListener.class, types, this, args));
}
META-INF/spring.factories文件部分:
# Run Listeners
org.springframework.boot.SpringApplicationRunListener=\
org.springframework.boot.context.event.EventPublishingRunListener
step3 启动已准备好的监听器
listeners.starting();
通过step2操作拿到监听器集合了之后,再统一遍历出来后,为每个Listener都分配了一个任务线程去启动它们
方法声明如下:
public void starting() {
this.initialMulticaster.multicastEvent(new ApplicationStartingEvent(this.application, this.args));
}
public void multicastEvent(ApplicationEvent event, @Nullable ResolvableType eventType) {
ResolvableType type = eventType != null ? eventType : this.resolveDefaultEventType(event);
Iterator var4 = this.getApplicationListeners(event, type).iterator();
while(var4.hasNext()) {
ApplicationListener<?> listener = (ApplicationListener)var4.next();
Executor executor = this.getTaskExecutor();
if (executor != null) {
executor.execute(() -> {
this.invokeListener(listener, event);
});
} else {
this.invokeListener(listener, event);
}
}
}
step4 装配环境参数
ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
我们来看一下new DefaultApplicationArguments(args)
这个构造函数,跟踪进去发现调用的SimpleCommandLineArgsParser.parse
函数,从下面代码中,可以看到该方法读取了命令行参数:
方法声明如下:
public CommandLineArgs parse(String... args) {
CommandLineArgs commandLineArgs = new CommandLineArgs();
String[] var3 = args;
int var4 = args.length;
//省略读取命令行代码...
return commandLineArgs;
}
tip:那到这里你是否会联想到:java -jar xx.jar --server.port=8000
后面的参数呢
接着我们看下一行:
ConfigurableEnvironment environment = this.prepareEnvironment(listeners, applicationArguments);
通过这行代码我们可以看到spring boot把前面创建出来的listeners和命令行参数,传递到prepareEnvironment
函数中来准备运行环境。来看一下prepareEnvironment
函数的真面目:
private ConfigurableEnvironment prepareEnvironment(SpringApplicationRunListeners listeners,
ApplicationArguments applicationArguments) {
// Create and configure the environment
ConfigurableEnvironment environment = this.getOrCreateEnvironment();
this.configureEnvironment((ConfigurableEnvironment)environment, applicationArguments.getSourceArgs());
listeners.environmentPrepared((ConfigurableEnvironment)environment);
this.bindToSpringApplication((ConfigurableEnvironment)environment);
if (this.webApplicationType == WebApplicationType.NONE) {
environment = (new EnvironmentConverter(this.getClassLoader())).convertToStandardEnvironmentIfNecessary(
(ConfigurableEnvironment)environment);
}
ConfigurationPropertySources.attach((Environment)environment);
return (ConfigurableEnvironment)environment;
}
在这里我们看到了环境是通过getOrCreateEnvironment
创建出来的,再深挖一下getOrCreateEnvironment
的源码:
private ConfigurableEnvironment getOrCreateEnvironment() {
//如果environment 已经存在,则直接返回当前的环境。思考:究竟什么情况下回存在呢?
if (this.environment != null) {
return this.environment;
} else {
//判断webApplicationType是不是SERVLET,如果是,则创建Servlet的环境,否则创建基本环境
return (ConfigurableEnvironment)(this.webApplicationType == WebApplicationType.SERVLET
? new StandardServletEnvironment() : new StandardEnvironment());
}
}
接着我们看下一行:
this.configureIgnoreBeanInfo(environment);
private void configureIgnoreBeanInfo(ConfigurableEnvironment environment) {
//如果System中的spring.beaninfo.ignore属性为空,就把当前环境中的属性覆盖上去
//spring.beaninfo.ignore= true 跳过搜索BeanInfo类
if (System.getProperty("spring.beaninfo.ignore") == null) {
Boolean ignore = (Boolean)environment.getProperty("spring.beaninfo.ignore", Boolean.class, Boolean.TRUE);
System.setProperty("spring.beaninfo.ignore", ignore.toString());
}
}
step5 打印Banner
Banner printedBanner = this.printBanner(environment);
spring boot启动的时候,控制台显示的那个艺术字体图案
step6 创建Spring上下文
context = this.createApplicationContext();
spring boot是根据不同的webApplicationType
的类型,来创建不同的ApplicationContext
代码声明如下:
protected ConfigurableApplicationContext createApplicationContext() {
Class<?> contextClass = this.applicationContextClass;
if (contextClass == null) {
try {
switch(this.webApplicationType) {
case SERVLET:
contextClass = Class.forName("org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext");
break;
case REACTIVE:
contextClass = Class.forName("org.springframework.boot.web.reactive.context.AnnotationConfigReactiveWebServerApplicationContext");
break;
default:
contextClass = Class.forName("org.springframework.context.annotation.AnnotationConfigApplicationContext");
}
} catch (ClassNotFoundException var3) {
throw new IllegalStateException("Unable create a default ApplicationContext, please specify an ApplicationContextClass", var3);
}
}
return (ConfigurableApplicationContext)BeanUtils.instantiateClass(contextClass);
}
step7 准备异常报告器
继续来看下一步,准备异常报告,又特么是这个getSpringFactoriesInstances
exceptionReporters = getSpringFactoriesInstances(
SpringBootExceptionReporter.class,
new Class[] { ConfigurableApplicationContext.class }, context);
大家可以再仔细看看META-INF/spring.factories文件
# Error Reporters
org.springframework.boot.SpringBootExceptionReporter=\
org.springframework.boot.diagnostics.FailureAnalyzers
step8 装配Context,上下文前置处理
this.prepareContext(context, environment, listeners, applicationArguments, printedBanner);
这行代码是把上面已经创建好的对象,传递给prepareContext来准备上下文
prepareContext()声明如下:
private void prepareContext(ConfigurableApplicationContext context, ConfigurableEnvironment environment,
SpringApplicationRunListeners listeners, ApplicationArguments applicationArguments, Banner printedBanner) {
//这里传入的是 StandardServletEnvironment
context.setEnvironment(environment);
//设置上下文的beanNameGenerator(bean生成器)和resourceLoader(资源加载器)
this.postProcessApplicationContext(context);
//拿到之前实例化SpringApplication对象的时候设置的ApplicationContextInitializer,调用它们的initialize方法,对上下文做初始化
this.applyInitializers(context);
//调用listeners#contextPrepared,该方法是一个空实现,以后我们可以扩展的地方
listeners.contextPrepared(context);
//打印启动日志
if (this.logStartupInfo) {
this.logStartupInfo(context.getParent() == null);
this.logStartupProfileInfo(context);
}
//往上下文的beanFactory中注册一个singleton的bean,bean的名字是springApplicationArguments,bean的实例是之前实例化的ApplicationArguments对象
context.getBeanFactory().registerSingleton("springApplicationArguments", applicationArguments);
//如果之前获取的printedBanner不为空
if (printedBanner != null) {
//往上下文的beanFactory中注册一个singleton的bean,bean的名字是springBootBanner,bean的实例就是这个printedBanner.这里默认是SpringBootBanner.
context.getBeanFactory().registerSingleton("springBootBanner", printedBanner);
}
//获取所有资源
Set<Object> sources = this.getAllSources();
Assert.notEmpty(sources, "Sources must not be empty");
//调用load方法注册启动类的bean定义,也就是调用SpringApplication.run(Application.class, args);的类
//SpringApplication的load方法内会创建BeanDefinitionLoader的对象,并调用它的load()方法
this.load(context, sources.toArray(new Object[0]));
//上下文已经加载,该方法先找到所有的ApplicationListener,遍历这些listener
//如果该listener继承了ApplicationContextAware类,这一步会调用它的setApplicationContext方法,设置context
listeners.contextLoaded(context);
}
step9 Spring上下文刷新 refreshContext
this.refreshContext(context);
在refreshContext
函数中,第一行调用了refresh(context);
跳转了一下,下面的代码是注册了一个应用关闭的函数钩子,如下
private void refreshContext(ConfigurableApplicationContext context) {
this.refresh(context);
if (this.registerShutdownHook) {
try {
context.registerShutdownHook();
} catch (AccessControlException var3) {
;
}
}
}
通过代码跟踪分析发现,其实是调用了AbstractApplicationContext
中的refresh方法。
在ServletWebServerApplicationContext和ReactiveWebServerApplicationContext
的refresh函数中都是调用了super.refresh();
代码如下:
public void refresh() throws BeansException, IllegalStateException {
Object var1 = this.startupShutdownMonitor;
//同步快执行刷新操作
synchronized(this.startupShutdownMonitor) {
//准备刷新上下文
this.prepareRefresh();
//获取了bean工厂以后,设置bean工厂的环境
ConfigurableListableBeanFactory beanFactory = this.obtainFreshBeanFactory();
this.prepareBeanFactory(beanFactory);
try {
//发送了一个bean工厂的处理信号,紧接着回调处理器,注册到bean工厂
this.postProcessBeanFactory(beanFactory);
this.invokeBeanFactoryPostProcessors(beanFactory);
this.registerBeanPostProcessors(beanFactory);
//初始化监听器
this.initMessageSource();
//初始化监听管理器
this.initApplicationEventMulticaster();
this.onRefresh();
//把spring容器内的listener和beanfactory的listener都添加到广播器中:
this.registerListeners();
//实例化BeanFactory 中已经被注册但是没被实例化的所有实例。初始化的过程中各种BeanPostProcessor已经开始生效
this.finishBeanFactoryInitialization(beanFactory);
//收尾,刷新产生的缓存、初始化生命周期处理器LifecycleProcessor,并调用其onRefresh()方法、发布事件、调用LiveBeansView的registerApplicationContext注册context。
this.finishRefresh();
} catch (BeansException var9) {
if (this.logger.isWarnEnabled()) {
this.logger.warn("Exception encountered during context initialization - cancelling refresh attempt: " + var9);
}
this.destroyBeans();
this.cancelRefresh(var9);
throw var9;
} finally {
this.resetCommonCaches();
}
}
}
step10 Spring上下文后置结束处理 afterRefresh
在刷新完context后,调用了一个afterRefresh
函数,这个函数前面已经说过了,是为了给ApplicationContext
的子类留下的一个扩展点
this.afterRefresh(context, applicationArguments);
然后调用了listeners.started(context);
,把监听器设置成了已经启动的状态。
最后调用了callRunners
函数,获取所有的ApplicationRunner
和CommandLineRunner
然后调用他们的run方法:
step11 发布应用上下文启动完成事件
把监听器设置成了已经启动的状态
listeners.started(context);
step12 执行所有Runner运行器
调用了callRunners
函数,获取所有的ApplicationRunner
和CommandLineRunner
然后调用他们的run方法
step13 发布应用上下文就绪事件
listeners.running(context);
触发所有 SpringApplicationRunListener
监听器的 running 事件方法。
step14 返回上下文
总结
本文分析了Spring Boot启动run方法,看得真的是让人头痛,但又不得不看,主要分为以下2步进行分析
SpringApplication实例的构建过程
其中主要涉及到了初始化器(Initializer)以及监听器(Listener)这两大概念,它们都通过META-INF/spring.factories
完成定义。SpringApplication实例run方法的执行过程
其中主要有一个SpringApplicationRunListeners
的概念,它作为Spring Boot容器初始化时各阶段事件的中转器,将事件派发给感兴趣的Listeners(在SpringApplication实例的构建过程中得到的)。这些阶段性事件将容器的初始化过程给构造起来,提供了比较强大的可扩展性。
如果从可扩展性的角度出发,应用开发者可以在Spring Boot容器的启动阶段,扩展哪些内容呢:
- 初始化器(Initializer)
- 监听器(Listener)
- 容器刷新后置Runners(
ApplicationRunner
或者CommandLineRunner
接口的实现类) - 启动期间在Console打印Banner的具体实现类
作者有话说:喜欢的话就请移步知码学院,请自备水,更多干、干、干货等着你