在分析和学习整个run方法之前,我们可以通过以下流程图来看下SpringApplication调用的run方法处理的核心操作包含哪些。
从上面的流程图中可以看出,SpringApplication在run方法中重点做了以下几步操作
/**
* Run the Spring application, creating and refreshing a new
* {@link ApplicationContext}.
* @param args the application arguments (usually passed from a Java main method)
* @return a running {@link ApplicationContext}
*/
public ConfigurableApplicationContext run(String... args) {
//创建stopWatch对象,用于统计run方法启动时长
StopWatch stopWatch = new StopWatch();
//启动统计
stopWatch.start();
ConfigurableApplicationContext context = null;
Collection<SpringBootExceptionReporter> exceptionReporters = new ArrayList<>();
//配置headless属性
configureHeadlessProperty();
//获得SpringApplicationListener数组
//该数组封装于SpringApplicationRunListeners对象的listeners中
SpringApplicationRunListeners listeners = getRunListeners(args);
//启动监听,遍历SpringApplicationRunListener数组每个元素,并执行
listeners.starting();
try {
//创建ApplicationArguments对象
ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
//加载属性配置,包括所有的配置属性(如application.properties中和外部的属性配置)
ConfigurableEnvironment environment = prepareEnvironment(listeners, applicationArguments);
configureIgnoreBeanInfo(environment);
//打印banner
Banner printedBanner = printBanner(environment);
//创建容器
context = createApplicationContext();
//获取异常报告
exceptionReporters = getSpringFactoriesInstances(SpringBootExceptionReporter.class,
new Class[] { ConfigurableApplicationContext.class }, context);
//准备容器,组件对象之间进行关联
prepareContext(context, environment, listeners, applicationArguments, printedBanner);
//初始化容器
refreshContext(context);
//初始化之后执行,默认实现为空
afterRefresh(context, applicationArguments);
//停止时长统计
stopWatch.stop();
//打印日东日志
if (this.logStartupInfo) {
new StartupInfoLogger(this.mainApplicationClass).logStarted(getApplicationLog(), stopWatch);
}
//通知监听器,容器启动完成
listeners.started(context);
//调用ApplicationRunner和CommandLineRunner的运行方法
callRunners(context, applicationArguments);
}
catch (Throwable ex) {
//异常处理
handleRunFailure(context, ex, exceptionReporters, listeners);
throw new IllegalStateException(ex);
}
try {
//通知监听器,容器正在运行
listeners.running(context);
}
catch (Throwable ex) {
//异常处理
handleRunFailure(context, ex, exceptionReporters, null);
throw new IllegalStateException(ex);
}
return context;
}
SpringApplicationRunListeners可以理解为一个SpringApplicationRunListener的容器,它将SpringApplicationRunListener的集合以构造方法传入,并赋值给其listeners成员变量,然后提供了针对listeners成员变量的各种遍历操作方法,比如,遍历集合并调用对应的starting,started,running等方法。
SpringApplicationRunListeners的构造方法很简单,其源码如下:
private SpringApplicationRunListeners getRunListeners(String[] args) {
//构造Class数组
Class<?>[] types = new Class<?>[] { SpringApplication.class, String[].class };
//调用SpringApplicationRunListeners构造方法
return new SpringApplicationRunListeners(logger,
getSpringFactoriesInstances(SpringApplicationRunListener.class, types, this, args));
}
SpringApplicationRunListeners 构造方法的第二个参数便是SpringApplicationRunListener的集合,SpringApplication中调用构造方法时该参数是通过getSpringFactoriesInstances方法1获取的,代码如下:
private <T> Collection<T> getSpringFactoriesInstances(Class<T> type, Class<?>[] parameterTypes, Object... args) {
//获得类加载器
ClassLoader classLoader = getClassLoader();
// Use names and ensure unique to protect against duplicates
//加载META-INF/spring.factories中对应监听器的配置,并将结果存于Set中(去重)
Set<String> names = new LinkedHashSet<>(SpringFactoriesLoader.loadFactoryNames(type, classLoader));
//实例化监听器
List<T> instances = createSpringFactoriesInstances(type, parameterTypes, classLoader, args, names);
//排序
AnnotationAwareOrderComparator.sort(instances);
return instances;
}
通过方法名可知,getSpringFactoriesInstances是用来获取factories配置文件中的注册类,并进行实例化操作。SpringApplicationRunListener的注册配置位于spring-boot项目中的spring.factories文件内,SringBoot默认仅有一个监听器进行了注册,至于为什么会仅有一个,后面来说哈。
# Run Listeners
org.springframework.boot.SpringApplicationRunListener=\
org.springframework.boot.context.event.EventPublishingRunListener
下面继续看createSpringFactoriesInstances方法的源码:
@SuppressWarnings("unchecked")
private <T> List<T> createSpringFactoriesInstances(Class<T> type, Class<?>[] parameterTypes,
ClassLoader classLoader, Object[] args, Set<String> names) {
List<T> instances = new ArrayList<>(names.size());
for (String name : names) {
try {
Class<?> instanceClass = ClassUtils.forName(name, classLoader);
Assert.isAssignable(type, instanceClass);
//获取有参构造器
Constructor<?> constructor = instanceClass.getDeclaredConstructor(parameterTypes);
T instance = (T) BeanUtils.instantiateClass(constructor, args);
instances.add(instance);
}
catch (Throwable ex) {
throw new IllegalArgumentException("Cannot instantiate " + type + " : " + name, ex);
}
}
return instances;
}
在上面的代码中,实例化监听器需要有一个默认的构造方法,且构造方法的参数为Class>[] parameterTypes。向上追踪该参数的来源,会发现该参数的1值为Class数组,数组的内容依次为SpringApplication.class和String[].class。也就是,SpringApplicationRunListener的实现类必须有默认的构造方法,且构造方法的参数必须依次为SpringApplication和String[]类型。
接口SpringApplicationRunListener是SpringApplication的run方法监听器。SpringApplicationRunListene提供了一系列的方法,用户可以通过回调这些方法,在启动各个流程时加入指定的逻辑处理。下面解释下该接口都定义了那些待实现的方法及功能。
/*
* Copyright 2012-2019 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.boot;
import org.springframework.context.ApplicationContext;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.io.support.SpringFactoriesLoader;
/**
* Listener for the {@link SpringApplication} {@code run} method.
* {@link SpringApplicationRunListener}s are loaded via the {@link SpringFactoriesLoader}
* and should declare a public constructor that accepts a {@link SpringApplication}
* instance and a {@code String[]} of arguments. A new
* {@link SpringApplicationRunListener} instance will be created for each run.
*
* @author Phillip Webb
* @author Dave Syer
* @author Andy Wilkinson
* @since 1.0.0
*/
public interface SpringApplicationRunListener {
//当run方法第一次被执行时,会被立即调用,可用于非常时期的初始化工作
default void starting() {}
//当environment准备完成,在ApplicationContext创建之前,该方法被调用
default void environmentPrepared(ConfigurableEnvironment environment) {}
//当ApplicationContext构建完成,资源还未被加载时,该方法被调用
default void contextPrepared(ConfigurableApplicationContext context) {}
//当ApplicationContext加载完成,未被刷新之前,该方法被调用
default void contextLoaded(ConfigurableApplicationContext context) {}
//当ApplicationContext刷新并启动之后,CommandLineRunner和ApplicationRunner未被调用之前,该方法被调用
default void started(ConfigurableApplicationContext context) {}
//当所有准备工作就绪,run方法执行完成之前,该方法被调用
default void running(ConfigurableApplicationContext context) {}
//当应用程序出现错误时,该方法被调用
default void failed(ConfigurableApplicationContext context, Throwable exception) {}
}
通过以上源码可以看出,SpringApplicationRunListener为run方法提供了各个运行阶段的监听事件处理功能。下图展示了在整个run方法的生命周期中SpringApplicationRunListener的所有方法所处的位置,此图可以帮助我们更好的学习run方法的运行流程。在前面run方法的代码中已经看到相关监听方法被调用。后续的源代码中也将涉及对应方法的调用,我们可以参考此图加深记忆。
EventPublishingRunListener是SpringBoot中针对SpringApplicationRunListener接口的唯一内建实现。EventPublishingRunListener使用内置的SimpleApplicationEventMulticaster来广播在上下文刷新之前触发的时间。
默认情况下,SpringBoot在初始化过程中触发的事件也是交由EventPublishingRunListener来代理实现的。EventPublishingRunListener的构造方法如下:
public EventPublishingRunListener(SpringApplication application, String[] args) {
this.application = application;
this.args = args;
//创建SimpleApplicationEventMulticaster广播器
this.initialMulticaster = new SimpleApplicationEventMulticaster();
//遍历ApplicationListener并关联SimpleApplicationEventMulticaster
for (ApplicationListener<?> listener : application.getListeners()) {
this.initialMulticaster.addApplicationListener(listener);
}
}
通过源码可以看出,该类的构造方法符合SpringApplicationRunListener所需的构造方法要求,该方法传递了SpringApplication和String[]类型。在构造方法中初始化了该类的3个成员变量。
@Override
public void starting() {
this.initialMulticaster.multicastEvent(new ApplicationStartingEvent(this.application, this.args));
}
在上述代码中你是否发现了一个问题,某些方法是通过initialMulticaster的multicastEvent进行事件的广播,某些方法是通过context参数的publishEvent方法进行发布的。这是为什么呢?在解决这个疑问之前,我们先看一个比较特殊的方法contextLoaded的源代码。
@Override
public void contextLoaded(ConfigurableApplicationContext context) {
//遍历application中的所有监听器实现类
for (ApplicationListener<?> listener : this.application.getListeners()) {
//如果为ApplicationContextAware,则将上下文信息设置到该监听器内
if (listener instanceof ApplicationContextAware) {
((ApplicationContextAware) listener).setApplicationContext(context);
}
//将application中的监听器实现类全部添加到上下文中。
context.addApplicationListener(listener);
}
//广播事件applicationPreparedEvent
this.initialMulticaster.multicastEvent(new ApplicationPreparedEvent(this.application, this.args, context));
}
contextLoaded方法在发布事件之前做了两件事:第一,遍历application的所有监听器实现类,如果该实现类还实现了ApplicationContextAware接口,则将上下文信息设置到该监听器内;第二,将application中的监听器实现类全部添加到上下文中。最后一步才是调用事件广播。
也正是这个方法形成了不同事件广播形式的分水岭,再此方法之前执行的事件广播都是通过muliticasEvent来进行的,而该方法之后的方法则均采用publishEvent来执行。这是因为只有到了contextLoaded方法之后,上下文才算初始化完成,才可通过它的publishEvent方法来进行时间的发布。
监听器启动后,紧接着便是执行ApplicationArgumnetsd对象的初始化,ApplicationArguments是用于提供访问运行SpringApplication时的参数。
ApplicationArguments的初始化过程非常简单,只是调用了它的实现类DefaultApplicationArguments并传入main方法中的args参数。
ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
在DefaultApplicationArguments中将参数args封装为Source对象,Source对象是基于Spring框架的SimpleCommandLinePropertySource来实现的。
完成ApplicationArguments参数的准备之后,便开始通过prepareEnvironment方法对ConfigurableEnvironment对象进行初始化操作。
ConfigurableEnvironment接口继承自Environment接口和ConfigurablePropertyResolver,最终都继承自接口PropertyResolver。ConfigurableEnvironment接口的主要作用是提供当前运行环境的公开接口,比如配置文件profiles各类系统属性和变量的设置,添加,读取,合并等。
通过ConfigurableEnvironment接口中方法定义,可以更清楚地了解它的功能,代码如下:
public interface ConfigurableEnvironment extends Environment, ConfigurablePropertyResolver {
//设置激活的组集合
void setActiveProfiles(String... var1);
//向当前激活的集合中添加一个profile组
void addActiveProfile(String var1);
//设置默认激活的组集合。激活的组集合为空时会使用默认的组集合
void setDefaultProfiles(String... var1);
//设置当前环境对象中的属性源集合,也就是应用环境
//属性源集合其实就是一个容纳PropertySource的容器
//该方法提供了直接配置属性源的入口。
MutablePropertySources getPropertySources();
//获取虚拟机环境变量,该方法提供了直接配置虚拟机环境变量的入口
Map<String, Object> getSystemProperties();
//获取操作系统环境变量
//该方法提供了直接配置系统环境变量的入口
Map<String, Object> getSystemEnvironment();
//合并制定环境中的配置到当前环境中
void merge(ConfigurableEnvironment var1);
}
通过接口提供的接口,我们可以看出ConfigurableEnvironment就是围绕这个“环境”来提供相应的功能,这也是为什么我们也将它称作“环境”。
了解了ConfigurableEnvironment的功能及方法,我们回归到SpringApplication的流程中看相关代码。run方法中调用了prepareEnvironment方法相关代码如下:
public ConfigurableApplicationContext run(String... args) {
......
ConfigurableEnvironment environment = prepareEnvironment(listeners, applicationArguments);
......
}
prepareEnvironment方法的源代码实现如下:
private ConfigurableEnvironment prepareEnvironment(SpringApplicationRunListeners listeners,
ApplicationArguments applicationArguments) {
// Create and configure the environment
//获取或创建环境
ConfigurableEnvironment environment = getOrCreateEnvironment();
//配置环境,主要包括PropertySources和activeProfiles
configureEnvironment(environment, applicationArguments.getSourceArgs());
//将ConfigurationPropertySources附加到制定环境中的第一位,并动态跟踪环境的添加或删除
ConfigurationPropertySources.attach(environment);
//listener环境准备
listeners.environmentPrepared(environment);
//将环境绑定到SpringApplication
bindToSpringApplication(environment);
//判断是否定制的环境,如果不是定制的则将环境转换为StandardEnvironment
if (!this.isCustomEnvironment) {
environment = new EnvironmentConverter(getClassLoader()).convertEnvironmentIfNecessary(environment,
deduceEnvironmentClass());
}
//将ConfigurationPropertySources附加到制定环境中的第一位,并动态跟踪环境的添加或删除
ConfigurationPropertySources.attach(environment);
return environment;
}
通过上述代码及注解可知,prepareEnvironment进行了以下的操作:
SpringApplication类中通过getOrCreateEnvironment方法来获取或创建环境。在该方法中首先判断环境是否为null,如果不为null则直接返回;如果为null,则根据当前推断出来的WebApplicationType类型来创建指定的环境,代码如下:
private ConfigurableEnvironment getOrCreateEnvironment() {
if (this.environment != null) {
return this.environment;
}
//根据不同的应用类型,,创建不同的环境实现
switch (this.webApplicationType) {
case SERVLET:
return new StandardServletEnvironment();
case REACTIVE:
return new StandardReactiveWebEnvironment();
default:
return new StandardEnvironment();
}
}
正如方法中如果environment存在,则直接返回;如果environment不存在,则根据当前步骤中推断获得的WebApplicationType来进行区分创建环境。如果是Servlet项目则创建标准的Servlet环境StandardServletEnvironment;如果是Reactive项目则创建StandardReactiveEnvironment;其他情况则创建标准的非Web的StandardEnvironment。
在获得环境变量之后,开始对环境变量和参数进行相应的设置,主要包括转换服务器的设置,PropertySorces的设置和activeProfiles的设置。SpringApplication类中相关configurationEnvironment方法代码如下:
protected void configureEnvironment(ConfigurableEnvironment environment, String[] args) {
//如果为true获取并设置转换服务
if (this.addConversionService) {
ConversionService conversionService = ApplicationConversionService.getSharedInstance();
environment.setConversionService((ConfigurableConversionService) conversionService);
}
//配置propertySources
configurePropertySources(environment, args);
//配置profiles
configureProfiles(environment, args);
}
在上述代码中,首先判断addConversionService变量是否为true,也就是判断是否需要添加转换服务,如果需要,则获取转换服务实例,并对环境设置转换服务。随后进行propertySources和profiles的配置。
其中configurationPropertySources方法对PropertySources进行配置,代码如下:
protected void configurePropertySources(ConfigurableEnvironment environment, String[] args) {
//获得环境变量中的属性资源信息
MutablePropertySources sources = environment.getPropertySources();
//如果默认属性配置存在则将其放置于属性资源的最后位置
if (this.defaultProperties != null && !this.defaultProperties.isEmpty()) {
sources.addLast(new MapPropertySource("defaultProperties", this.defaultProperties));
}
//如果命令行属性存在
if (this.addCommandLineProperties && args.length > 0) {
String name = CommandLinePropertySource.COMMAND_LINE_PROPERTY_SOURCE_NAME;
//如果默认属性资源中不包含该命令,则将命令行属性放置在第一位,如果包含,则通过compositePropertySource进行处理
if (sources.contains(name)) {
PropertySource<?> source = sources.get(name);
CompositePropertySource composite = new CompositePropertySource(name);
composite.addPropertySource(
new SimpleCommandLinePropertySource("springApplicationCommandLineArgs", args));
composite.addPropertySource(source);
sources.replace(name, composite);
}
else {
//放置在第一位
sources.addFirst(new SimpleCommandLinePropertySource(args));
}
}
}
这段代码需要重点看一下参数的优先级处理和默认参数与命令参数之间的关系。首先,如果存在默认属性配置,则将默认属性配置放置在最后,也就是说优先级最低。然后,如果命令参数存在则会出现两种情况:如果命令的参数已经存在于属性配置中,则使用CompositePropertySource类进行相同name的参数处理;如果命令的参数并不存在于属性配置中,则直接将其设置为优先级最高。
ComfigurePropertySources方法的官方注释也很好地解释了它的功能:增加,移除或重新排序应用环境中的任何PropertySources。
完成了PropertySources配置,随后通过configureProfiles方法来完成Profiles的配置,代码如下:
protected void configureProfiles(ConfigurableEnvironment environment, String[] args) {
Set<String> profiles = new LinkedHashSet<>(this.additionalProfiles);
profiles.addAll(Arrays.asList(environment.getActiveProfiles()));
environment.setActiveProfiles(StringUtils.toStringArray(profiles));
}
上面的代码主要用来处理应用环境中那些配置文件处于激活状态或默认激活状态。对应的配置正是我们经常使用的用来区分不同环境的spring.profiles.active参数的指定的值。
经过上述步骤,ConfigurableEnvironment的初始化和准备工作已经完成。之后程序又对环境中的忽略信息配置“spring.beaninfo.ignore”的值进行获取判断,进而配置为系统参数中的忽略项。
private void configureIgnoreBeanInfo(ConfigurableEnvironment environment) {
//如果系统参数中spring.beaninfo.ignore为null
if (System.getProperty(CachedIntrospectionResults.IGNORE_BEANINFO_PROPERTY_NAME) == null) {
//获取环境中spring.beaninfo.ignore的配置
Boolean ignore = environment.getProperty("spring.beaninfo.ignore", Boolean.class, Boolean.TRUE);
//设置对应的系统参数
System.setProperty(CachedIntrospectionResults.IGNORE_BEANINFO_PROPERTY_NAME, ignore.toString());
}
}
spring.beaninfo.ignore的配置用来决定是否效果BeanInfo类的扫描,如果设置为true则跳过。
完成了环境的基本处理后,接下来就是Banner的打印了。SpringBoot的Banner打印是一个比较炫酷的功能,但又显得有些华而不实,特别是打印图片是启动速度回变慢,以下简单了解一下它的底层代码实现。
private Banner printBanner(ConfigurableEnvironment environment) {
//如果处于关闭状态,则返回null
if (this.bannerMode == Banner.Mode.OFF) {
return null;
}
//如果resourceLoader不存在则创建一个默认的ResourceLoader
ResourceLoader resourceLoader = (this.resourceLoader != null) ? this.resourceLoader
: new DefaultResourceLoader(getClassLoader());
//创建springApplicationBannerPrinter
SpringApplicationBannerPrinter bannerPrinter = new SpringApplicationBannerPrinter(resourceLoader, this.banner);
//打印到日志里
if (this.bannerMode == Mode.LOG) {
return bannerPrinter.print(environment, this.mainApplicationClass, logger);
}
//打印到控制台
return bannerPrinter.print(environment, this.mainApplicationClass, System.out);
}
上面的代码中展示了Banner的开启及打印位置的设置。程序通过Banner.Mode枚举值来判断是否开启Banner打印,此项参数可以在SpringBoot入口main方法通过setBannerMode方法来设置,也可以通过application.properties中的spring.main-mode进行设置。
SpringApplicationBannerPrinter类继承了Banner初始化及打印的核心功能,比如默认如何获取Banner信息,如何根据约定优于配置来默认获得Banner的内容,Banner支持的文件格式等。
而具体打印的信息是由Banner接口的实现类来完成的,比如默认情况下使用SpringBootBanner来打印SpringBoot的版本信息及简单的图形。当然还有通过资源文件打印的ResourceBanner,通过图片打印的ImageBanner等方法。
在上面的章节中已多次涉及WebApplicationType枚举类,无论是推断Web应用类型,还是创建不同的配置环境都与枚举类有关。SpringBoot创建spring的应用上下文时,如果未指定要创建的类,则会根据之前推断的类型来进行默认上下文类的创建。在SpringBoot中通过SpringApplication类中的createApplicationContext来进行应用上下文的创建,代码如下:
public static final String DEFAULT_CONTEXT_CLASS = "org.springframework.context."
+ "annotation.AnnotationConfigApplicationContext";
public static final String DEFAULT_SERVLET_WEB_CONTEXT_CLASS = "org.springframework.boot."
+ "web.servlet.context.AnnotationConfigServletWebServerApplicationContext";
public static final String DEFAULT_REACTIVE_WEB_CONTEXT_CLASS = "org.springframework."
+ "boot.web.reactive.context.AnnotationConfigReactiveWebServerApplicationContext";
protected ConfigurableApplicationContext createApplicationContext() {
// 获取容器的类变量
Class<?> contextClass = this.applicationContextClass;
// 如果为null,则根据web应用类型按照默认类进行创建
if (contextClass == null) {
try {
switch (this.webApplicationType) {
case SERVLET:
contextClass = Class.forName(DEFAULT_SERVLET_WEB_CONTEXT_CLASS);
break;
case REACTIVE:
contextClass = Class.forName(DEFAULT_REACTIVE_WEB_CONTEXT_CLASS);
break;
default:
contextClass = Class.forName(DEFAULT_CONTEXT_CLASS);
}
}
catch (ClassNotFoundException ex) {
throw new IllegalStateException(
"Unable create a default ApplicationContext, please specify an ApplicationContextClass", ex);
}
}
// 如果存在对应的class配置,则通过spring提供的BeanUtils来进行实例化
return (ConfigurableApplicationContext) BeanUtils.instantiateClass(contextClass);
}
SpringApplication通过prepareContext方法来进行应用上下文的准备工作。下面来了解下prepareContext的核心功能及流程。
配合流程图,看下SpringApplication中的prepareContext方法及源码及功能注解。
private void prepareContext(ConfigurableApplicationContext context, ConfigurableEnvironment environment,
SpringApplicationRunListeners listeners, ApplicationArguments applicationArguments, Banner printedBanner) {
//设置上下文的配置环境
context.setEnvironment(environment);
//应用上下文后置处理
postProcessApplicationContext(context);
//在context刷新之前,ApplicationContextInitializer初始化context
applyInitializers(context);
//通知监听器context准备工作完成,该方法以上为上下文准备阶段,以下为上下文加载阶段
listeners.contextPrepared(context);
//打印日志,启动profile
if (this.logStartupInfo) {
logStartupInfo(context.getParent() == null);
logStartupProfileInfo(context);
}
// Add boot specific singleton beans
// 获得ConfigurableListableBeanFactory并注册单例对象
ConfigurableListableBeanFactory beanFactory = context.getBeanFactory();
beanFactory.registerSingleton("springApplicationArguments", applicationArguments);
if (printedBanner != null) {
//注册打印日志对象
beanFactory.registerSingleton("springBootBanner", printedBanner);
}
if (beanFactory instanceof DefaultListableBeanFactory) {
//设置是否允许覆盖注册
((DefaultListableBeanFactory) beanFactory)
.setAllowBeanDefinitionOverriding(this.allowBeanDefinitionOverriding);
}
if (this.lazyInitialization) {
//将惰性初始化添加到context中
context.addBeanFactoryPostProcessor(new LazyInitializationBeanFactoryPostProcessor());
}
// Load the sources
//获取全部资源配置,其中包括primarySource和sources
Set<Object> sources = getAllSources();
Assert.notEmpty(sources, "Sources must not be empty");
//将sources中的Bean加载到context中
load(context, sources.toArray(new Object[0]));
//通知监听器context加载完成
listeners.contextLoaded(context);
}
通过上述流程图和代码可以看出,在该方法内完成了两步操作:应用上下文的准备和加载。下面针对具体的源代码进行分析。
在上下文准备阶段,主要完成了三步操作:对context设置environment,应用上下文后置处理和ApplicationContextInitializer初始化context操作。
首先对context设置environment,代码如下:
public void setEnvironment(ConfigurableEnvironment environment) {
//设置context的environment
super.setEnvironment(environment);
//设置context的reader属性的conditionEvaluator属性
this.reader.setEnvironment(environment);
//设置context的scanner属性的environment属性
this.scanner.setEnvironment(environment);
}
随后就是对spring应用上下文的后置处理,主要通过postProcessApplicationContext方法来完成的。
protected void postProcessApplicationContext(ConfigurableApplicationContext context) {
if (this.beanNameGenerator != null) {
//如果beanNameGenerator为null,则将当前的beanNameGenerator按照默认名字进行注册
context.getBeanFactory().registerSingleton(AnnotationConfigUtils.CONFIGURATION_BEAN_NAME_GENERATOR,
this.beanNameGenerator);
}
//当resourceLoader为null时,则根据context的类型分别进行ResourceLoader和ClassLoader的设置
if (this.resourceLoader != null) {
if (context instanceof GenericApplicationContext) {
((GenericApplicationContext) context).setResourceLoader(this.resourceLoader);
}
if (context instanceof DefaultResourceLoader) {
((DefaultResourceLoader) context).setClassLoader(this.resourceLoader.getClassLoader());
}
}
//如果true则获得并设置转换服务
if (this.addConversionService) {
context.getBeanFactory().setConversionService(ApplicationConversionService.getSharedInstance());
}
}
postProcessApplicationContext方法主要完成上下文的后置操作,默认包含beanNameGenerator,ResourceLoader,ClassLoader和ConversionService的设置。该方法可由子类覆盖实现,以添加更多的操作。而在此阶段,beanNameGenerator和resourceLoader都为null,因此只操作了最后一步的设置转换服务。
最后,在通知监听器context准备完成之前,通过applyInitializers方法对上下文进行初始化。所使用的ApplicationContextInitializer正是我们在SpringApplication初始化阶段设置在initializers变量中的值,只不过在通过getInitializers方法获取时进行了去重和排序。
protected void applyInitializers(ConfigurableApplicationContext context) {
//获取ApplicationContextInitializer集合并遍历
for (ApplicationContextInitializer initializer : getInitializers()) {
//解析当前initializer实现的ApplicationContextInitializer的泛型参数
Class<?> requiredType = GenericTypeResolver.resolveTypeArgument(initializer.getClass(),
ApplicationContextInitializer.class);
//断言判断所需类似是否与context类型匹配
Assert.isInstanceOf(requiredType, context, "Unable to call initializer.");
//初始化context
initializer.initialize(context);
}
}
完成上述操作之后,程序便调用SpringApplicationRunListeners的contextPrepared方法通知监听器,到此第一阶段的准备操作完成。
应用上下文加载阶段包含以下步骤:打印日志和profile的设置,设置是否允许覆盖注册,获取全部配置源,将配置源加载入上下文,通知监控器context加载完成。
首先进入应用上下文加载阶段的操作为打印日志和profile的设置,上面已经介绍过啦,就不展开讲了。随后,便是获得ConfigurableListableBeanFactory并注册单例对象,注册的单例对象包含:ApplicationArguments和banner。当BeanFactory为DefaultListableBeanFactory时,进入设置是否允许覆盖注册的处理逻辑。
测出需要的是,当进行了ApplicationArguments类单例对象的注册之后,也意味着我们在此使用Spring应用上下文的过程中可以通过依赖注入来使用该对象。
@Resource
private ApplicationArguments applicationArguments
完成上述操作之后,便进入配置源信息的处理阶段,这一步通过getAllSources方法来对配置源信息进行合并操作。
public Set<Object> getAllSources() {
Set<Object> allSources = new LinkedHashSet<>();
if (!CollectionUtils.isEmpty(this.primarySources)) {
allSources.addAll(this.primarySources);
}
if (!CollectionUtils.isEmpty(this.sources)) {
allSources.addAll(this.sources);
}
return Collections.unmodifiableSet(allSources);
}
上述代码大致为如果Set集合中不存在primarySources配置源或sources配置源,将其添加入Set中,同事将Set设置为不可修改,并返回。
上面讲过primarySources的值来自SpringApplication的构造参数,变量sources的值来自于setResources方法。
当获得所有的配置源信息后,通过load方法将配置源信息加载到上下文中,代码如下:
protected void load(ApplicationContext context, Object[] sources) {
if (logger.isDebugEnabled()) {
logger.debug("Loading source " + StringUtils.arrayToCommaDelimitedString(sources));
}
BeanDefinitionLoader loader = createBeanDefinitionLoader(getBeanDefinitionRegistry(context), sources);
if (this.beanNameGenerator != null) {
loader.setBeanNameGenerator(this.beanNameGenerator);
}
if (this.resourceLoader != null) {
loader.setResourceLoader(this.resourceLoader);
}
if (this.environment != null) {
loader.setEnvironment(this.environment);
}
loader.load();
}
该方法主要通过BeanDefinitionLoader来完成配置资源的加载操作。进入createBeanDefinitionLoader方法中:
protected BeanDefinitionLoader createBeanDefinitionLoader(BeanDefinitionRegistry registry, Object[] sources) {
return new BeanDefinitionLoader(registry, sources);
}
//
BeanDefinitionLoader(BeanDefinitionRegistry registry, Object... sources) {
Assert.notNull(registry, "Registry must not be null");
Assert.notEmpty(sources, "Sources must not be empty");
this.sources = sources;
this.annotatedReader = new AnnotatedBeanDefinitionReader(registry);
this.xmlReader = new XmlBeanDefinitionReader(registry);
if (isGroovyPresent()) {
this.groovyReader = new GroovyBeanDefinitionReader(registry);
}
this.scanner = new ClassPathBeanDefinitionScanner(registry);
this.scanner.addExcludeFilter(new ClassExcludeFilter(sources));
}
通过BeanDefinitionLoader的构造方法我们可以看到BeanDefinitionLoader支持基于AnnotatedBeanDefinitionReader,XmlBeanDefinitionReader,GroovyBeanDefinitionReader等多种类型的加载操作。
在执行BeanDefinitionLoader的创建及基本设置之后,调用其load方法,该方法最终执行以下代码:
private int load(Object source) {
Assert.notNull(source, "Source must not be null");
if (source instanceof Class<?>) {
return load((Class<?>) source);
}
if (source instanceof Resource) {
return load((Resource) source);
}
if (source instanceof Package) {
return load((Package) source);
}
if (source instanceof CharSequence) {
return load((CharSequence) source);
}
throw new IllegalArgumentException("Invalid source type " + source.getClass());
}
从上述代码中可以看出,BeanDefinitionLoader加载支持的范围包括:Class,Resource,Package和CharSequence四种。前面已经提到过变量sources的来源有primarySources配置源和sources配置源。变量primarySources在初始化时接受的类型为Class,而变量sources通过set(Set<'String>)方法接收的参数为String集合。因此,在实际使用的过程中,Resource和package的判断分支始终无法进入执行阶段。
完成上述操作后,接下来执行SpringAllicationRunListeners的contextLoaded方法通知监听器上下文加载完成,至此整个Spring应用上下文的准备阶段完成。
Spring应用上下文的刷新,是通过调用SpringApplication中的refreshContext方法来完成的。SpringApplication中refreshContext方法相关代码如下:
private void refreshContext(ConfigurableApplicationContext context) {
//调用refresh方法
refresh(context);
if (this.registerShutdownHook) {
try {
//注册shutdownHook线程,实现销毁时的回调
context.registerShutdownHook();
}
catch (AccessControlException ex) {
//在某些环境中不允许使用,会报出次异常,但此处并无处理操作
// Not allowed in some environments.
}
}
}
protected void refresh(ApplicationContext applicationContext) {
Assert.isInstanceOf(AbstractApplicationContext.class, applicationContext);
((AbstractApplicationContext) applicationContext).refresh();
}
其中refresh方法调用的是AbstractApplicationContext中的refresh方法,该方法属于spring-context包。AbstractApplicationContext的refresh方法更多的是spring相关的内容。在这里我们可以通过refresh方法的底层代码了解该方法都做了些什么。
public void refresh() throws BeansException, IllegalStateException {
//同步处理整个过程
synchronized(this.startupShutdownMonitor) {
//准备刷新工作
this.prepareRefresh();
//通知子类刷新内部bean工厂
ConfigurableListableBeanFactory beanFactory = this.obtainFreshBeanFactory();
//为当前context准备内部bean工厂
this.prepareBeanFactory(beanFactory);
try {
//允许context的子类对bean工厂进行后置处理
this.postProcessBeanFactory(beanFactory);
//调用context中注册为bean的工厂处理器
this.invokeBeanFactoryPostProcessors(beanFactory);
//注册bean处理器
this.registerBeanPostProcessors(beanFactory);
//初始化context的信息源,和国际化有关
this.initMessageSource();
//初始化context的事件传播器
this.initApplicationEventMulticaster();
//初始化其他子类特殊的bean
this.onRefresh();
//检查并注册时间监听器
this.registerListeners();
//实例化所有非懒加载单例
this.finishBeanFactoryInitialization(beanFactory);
//发布对应事件
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();
}
}
}
在上面的代码中调用refresh方法初始化容器的生命周期处理器并发布容器的生命周期之后,spring应用上下文正式开启,Spring Boot核心特性也随之启动。
完成refreshContext方法操作之后,调用afterRefresh方法。完成以上操作之后,调用SpringApplicationRunListeners的started方法,通知监听器容器启动完成,并调用ApplicationRunner的CommandLineRunner的运行方法。
ApplicationRunner和CommandLineRunner是通过SpringApplication类的callRunners方法来完成的,具体代码如下:
private void callRunners(ApplicationContext context, ApplicationArguments args) {
List<Object> runners = new ArrayList<>();
runners.addAll(context.getBeansOfType(ApplicationRunner.class).values());
runners.addAll(context.getBeansOfType(CommandLineRunner.class).values());
AnnotationAwareOrderComparator.sort(runners);
for (Object runner : new LinkedHashSet<>(runners)) {
if (runner instanceof ApplicationRunner) {
callRunner((ApplicationRunner) runner, args);
}
if (runner instanceof CommandLineRunner) {
callRunner((CommandLineRunner) runner, args);
}
}
}
private void callRunner(CommandLineRunner runner, ApplicationArguments args) {
try {
(runner).run(args.getSourceArgs());
}
catch (Exception ex) {
throw new IllegalStateException("Failed to execute CommandLineRunner", ex);
}
}
以上代码,首先从context中获得类型为ApplicationRunner和CommandLineRunner的Bean,将他们放入list列表中并进行排序。然后再遍历调用其run方法,并将ApplicationArguments参数传入。
Spring Boot提供这两个接口的目的,是为了我们在开发的过程中,通过他们来实现在容器启动时执行一些操作,如果有多个实现类,可通过@Order注解或实现Ordered接口来控制执行顺序。
这两个接口都提供了run方法,但不同之处在于:ApplicationRunner中run方法的参数为ApplicationArguments,而CommandLineRunner接口中run方法的参数为String数组。
以上方法执行完成之后,会通过SpringApplicationRunListeners的running方法通知监听器:容器此刻处于运行状态。至此,SpringApplication的run方法执行完毕。