Spring Boot 2.x 启动全过程源码分析(上)入口类剖
Spring Boot 的应用教程我们已经分享过很多了,今天来通过源码来分析下它的启动过程,探究下 Spring Boot 为什么这么简便的奥秘。
本篇基于 Spring Boot 2.0.3 版本进行分析,阅读本文需要有一些 Java 和 Spring 框架基础,如果还不知道 Spring Boot 是什么,建议先看下我们的 Spring Boot 教程。
Spring Boot 的入口类
@SpringBootApplicationpublicclassSpringBootBestPracticeApplication{publicstaticvoidmain(String[] args) { SpringApplication.run(SpringBootBestPracticeApplication.class, args); }}
做过 Spring Boot 项目的都知道,上面是 Spring Boot 最简单通用的入口类。入口类的要求是最顶层包下面第一个含有 main 方法的类,使用注解 @SpringBootApplication 来启用 Spring Boot 特性,使用 SpringApplication.run 方法来启动 Spring Boot 项目。
来看一下这个类的 run 方法调用关系源码:
publicstaticConfigurableApplicationContextrun(Class primarySource,String... args) {returnrun(newClass[] { primarySource }, args);}publicstaticConfigurableApplicationContextrun(Class[] primarySources,String[] args) {returnnewSpringApplication(primarySources).run(args);}
第一个参数 primarySource:加载的主要资源类
第二个参数 args:传递给应用的应用参数
先用主要资源类来实例化一个 SpringApplication 对象,再调用这个对象的 run 方法,所以我们分两步来分析这个启动源码。
SpringApplication 的实例化过程
接着上面的 SpringApplication 构造方法进入以下源码:
publicSpringApplication(Class... primarySources) {this(null, primarySources);}publicSpringApplication(ResourceLoader resourceLoader, Class... primarySources) {// 1、资源初始化资源加载器为 nullthis.resourceLoader = resourceLoader;// 2、断言主要加载资源类不能为 null,否则报错Assert.notNull(primarySources,"PrimarySources must not be null");// 3、初始化主要加载资源类集合并去重this.primarySources = new LinkedHashSet<>(Arrays.asList(primarySources));// 4、推断当前 WEB 应用类型this.webApplicationType = deduceWebApplicationType();// 5、设置应用上线文初始化器setInitializers((Collection) getSpringFactoriesInstances( ApplicationContextInitializer.class));// 6、设置监听器 setListeners((Collection) getSpringFactoriesInstances(ApplicationListener.class));// 7、推断主入口应用类this.mainApplicationClass = deduceMainApplicationClass();}
可知这个构造器类的初始化包括以下 7 个过程。
1、资源初始化资源加载器为 null
this.resourceLoader = resourceLoader;
2、断言主要加载资源类不能为 null,否则报错
Assert.notNull(primarySources,"PrimarySources must not be null");
3、初始化主要加载资源类集合并去重
this.primarySources =newLinkedHashSet<>(Arrays.asList(primarySources));
4、推断当前 WEB 应用类型
this.webApplicationType = deduceWebApplicationType();
来看下 deduceWebApplicationType 方法和相关的源码:
privateWebApplicationType deduceWebApplicationType() {if(ClassUtils.isPresent(REACTIVE_WEB_ENVIRONMENT_CLASS,null) && !ClassUtils.isPresent(MVC_WEB_ENVIRONMENT_CLASS,null)) {returnWebApplicationType.REACTIVE; }for(StringclassName : WEB_ENVIRONMENT_CLASSES) {if(!ClassUtils.isPresent(className,null)) {returnWebApplicationType.NONE; } }returnWebApplicationType.SERVLET;}privatestaticfinalStringREACTIVE_WEB_ENVIRONMENT_CLASS ="org.springframework."+"web.reactive.DispatcherHandler";privatestaticfinalStringMVC_WEB_ENVIRONMENT_CLASS ="org.springframework."+"web.servlet.DispatcherServlet";privatestaticfinalString[] WEB_ENVIRONMENT_CLASSES = {"javax.servlet.Servlet","org.springframework.web.context.ConfigurableWebApplicationContext"};publicenumWebApplicationType {/**
* 非 WEB 项目
*/NONE,/**
* SERVLET WEB 项目
*/SERVLET,/**
* 响应式 WEB 项目
*/REACTIVE}
这个就是根据类路径下是否有对应项目类型的类推断出不同的应用类型。
5、设置应用上线文初始化器
setInitializers((Collection) getSpringFactoriesInstances(ApplicationContextInitializer.class));
ApplicationContextInitializer 的作用是什么?源码如下。
publicinterfaceApplicationContextInitializer{/** * Initialize the given application context. *@paramapplicationContext the application to configure */voidinitialize(C applicationContext);}
用来初始化指定的 Spring 应用上下文,如注册属性资源、激活 Profiles 等。
来看下 setInitializers 方法源码,其实就是初始化一个 ApplicationContextInitializer 应用上下文初始化器实例的集合。
publicvoidsetInitializers( Collection> initializers){this.initializers =newArrayList<>();this.initializers.addAll(initializers);}
再来看下这个初始化 getSpringFactoriesInstances 方法和相关的源码:
private Collection getSpringFactoriesInstances(Classtype) {returngetSpringFactoriesInstances(type,newClass[] {});}private Collection getSpringFactoriesInstances(Classtype,Class[] parameterTypes, Object... args) { ClassLoader classLoader = Thread.currentThread().getContextClassLoader();// Use names and ensure unique to protect against duplicatesSet names =newLinkedHashSet<>( SpringFactoriesLoader.loadFactoryNames(type,classLoader));List instances = createSpringFactoriesInstances(type,parameterTypes,classLoader, args, names); AnnotationAwareOrderComparator.sort(instances);returninstances;}
设置应用上下文初始化器可分为以下 5 个步骤。
5.1)获取当前线程上下文类加载器
ClassLoader classLoader= Thread.currentThread().getContextClassLoader();
5.2)获取 ApplicationContextInitializer 的实例名称集合并去重
Setnames=newLinkedHashSet<>( SpringFactoriesLoader.loadFactoryNames(type, classLoader));
loadFactoryNames 方法相关的源码如下:
publicstaticList loadFactoryNames(Class factoryClass,@NullableClassLoader classLoader) {StringfactoryClassName = factoryClass.getName();returnloadSpringFactories(classLoader).getOrDefault(factoryClassName, Collections.emptyList());}publicstaticfinalStringFACTORIES_RESOURCE_LOCATION ="META-INF/spring.factories";privatestaticMap> loadSpringFactories(@NullableClassLoader classLoader) { MultiValueMap result = cache.get(classLoader);if(result !=null) {returnresult; }try{ Enumeration urls = (classLoader !=null? classLoader.getResources(FACTORIES_RESOURCE_LOCATION) : ClassLoader.getSystemResources(FACTORIES_RESOURCE_LOCATION)); result =newLinkedMultiValueMap<>();while(urls.hasMoreElements()) { URL url = urls.nextElement(); UrlResource resource =newUrlResource(url); Properties properties = PropertiesLoaderUtils.loadProperties(resource);for(Map.Entry entry : properties.entrySet()) {List factoryClassNames = Arrays.asList( StringUtils.commaDelimitedListToStringArray((String) entry.getValue())); result.addAll((String) entry.getKey(), factoryClassNames); } } cache.put(classLoader, result);returnresult; }catch(IOException ex) {thrownewIllegalArgumentException("Unable to load factories from location ["+ FACTORIES_RESOURCE_LOCATION +"]", ex); }}
根据类路径下的 META-INF/spring.factories 文件解析并获取 ApplicationContextInitializer接口的所有配置的类路径名称。
spring-boot-autoconfigure-2.0.3.RELEASE.jar!/META-INF/spring.factories 的初始化器相关配置内容如下:
# Initializersorg.springframework.context.ApplicationContextInitializer=\org.springframework.boot.autoconfigure.SharedMetadataReaderFactoryContextInitializer,\org.springframework.boot.autoconfigure.logging.ConditionEvaluationReportLoggingListener
5.3)根据以上类路径创建初始化器实例列表
List instances = createSpringFactoriesInstances(type, parameterTypes, classLoader, args, names);private List createSpringFactoriesInstances(Class type, Class[] parameterTypes, ClassLoader classLoader, Object[] args, Set names) { List 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;}
5.4)初始化器实例列表排序
AnnotationAwareOrderComparator.sort(instances);
5.5)返回初始化器实例列表
returninstances;
6、设置监听器
setListeners((Collection) getSpringFactoriesInstances(ApplicationListener.class));
ApplicationListener 的作用是什么?源码如下。
@FunctionalInterfacepublicinterfaceApplicationListenerextendsEventListener{/** * Handle an application event. *@paramevent the event to respond to */voidonApplicationEvent(E event);}
看源码,这个接口继承了 JDK 的 java.util.EventListener 接口,实现了观察者模式,它一般用来定义感兴趣的事件类型,事件类型限定于 ApplicationEvent 的子类,这同样继承了 JDK 的 java.util.EventObject 接口。
设置监听器和设置初始化器调用的方法是一样的,只是传入的类型不一样,设置监听器的接口类型为:getSpringFactoriesInstances,对应的 spring-boot-autoconfigure-2.0.3.RELEASE.jar!/META-INF/spring.factories 文件配置内容请见下方。
# Application Listenersorg.springframework.context.ApplicationListener=\org.springframework.boot.autoconfigure.BackgroundPreinitializer
可以看出目前只有一个 BackgroundPreinitializer 监听器。
7、推断主入口应用类
this.mainApplicationClass = deduceMainApplicationClass();privateClassdeduceMainApplicationClass() {try{ StackTraceElement[] stackTrace =newRuntimeException().getStackTrace();for(StackTraceElement stackTraceElement : stackTrace) {if("main".equals(stackTraceElement.getMethodName())) {returnClass.forName(stackTraceElement.getClassName());} } }catch(ClassNotFoundException ex) { // Swallowandcontinue}returnnull;}
这个推断入口应用类的方式有点特别,通过构造一个运行时异常,再遍历异常栈中的方法名,获取方法名为 main 的栈帧,从来得到入口类的名字再返回该类。
免费分享Java技术资料,需要的可以私信我
原文:https://zhuanlan.zhihu.com/p/76207600/edit
作者:白天不懂夜的黑
来源:知乎
声明:本文为二次转载,原文不可查