javascript
今天,我们来详细的聊一聊SpringBoot自动配置原理,学了这么久,你学废了吗?
SpringBoot是我們經(jīng)常使用的框架,那么你能不能針對SpringBoot實(shí)現(xiàn)自動(dòng)配置做一個(gè)詳細(xì)的介紹。如果可以的話,能不能畫一下實(shí)現(xiàn)自動(dòng)配置的流程圖。牽扯到哪些關(guān)鍵類,以及哪些關(guān)鍵點(diǎn)。
下面我們一起來看看吧!!
前言:
閱讀完本文:
一步一步 debug 從淺到深。
注意:本文的 SpringBoot 版本為 2.5.2
一、啟動(dòng)類
前言什么的,就不說了,大家都會(huì)用的,我們直接從 SpringBoot 啟動(dòng)類說起。
@SpringBootApplication public class Hello {public static void main(String[] args) {SpringApplication.run(Hello.class);} }@SpringBootApplication 標(biāo)注在某個(gè)類上說明這個(gè)類是 SpringBoot 的主配置類, SpringBoot 就應(yīng)該運(yùn)行這個(gè)類的main方法來啟動(dòng) SpringBoot 應(yīng)用;是我們研究的重點(diǎn)!!!它的本質(zhì)是一個(gè)組合注解,我們點(diǎn)進(jìn)去,看看javadoc上是怎么寫的,分析從淺到深,從粗略到詳細(xì)。
我們點(diǎn)進(jìn)去看:
@Inherited @SpringBootConfiguration @EnableAutoConfiguration @ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) }) public @interface SpringBootApplication {}Javadoc上是這么寫的
表示聲明一個(gè)或多個(gè)@Bean方法并觸發(fā) auto-configuration 和 component scanning 的 configuration 類。 這是一個(gè)方便的注解,相當(dāng)于聲明了 @Configuration 、 @EnableAutoConfiguration 和@ComponentScan 。
—為什么它能集成這么多的注解的功能呢?
是在于它上面的 @Inherited 注解, @Inherited 表示自動(dòng)繼承注解類型。
這里的最重要的兩個(gè)注解是 @SpringBootConfiguration 和 @EnableAutoConfiguration。
1.1、@SpringBootConfiguration
我們先點(diǎn)進(jìn)去看看 @SpringBootConfiguration注解:
@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @Configuration @Indexed public @interface SpringBootConfiguration {}。1.2、@EnableAutoConfiguration
再看看 @EnableAutoConfiguration.
@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @Inherited @AutoConfigurationPackage @Import(AutoConfigurationImportSelector.class) public @interface EnableAutoConfiguration {}1.3、@ComponentScan
@ComponentScan:配置用于 Configuration 類的組件掃描指令。 提供與 Spring XML 的 <context:component-scan> 元素并行的支持。
可以 basePackageClasses 或basePackages( 或其別名value )來定義要掃描的特定包。 如果沒有定義特定的包,將從聲明該注解的類的包開始掃描。
作為了解,不是本文重點(diǎn)。
1.4、探究方向
主要探究圖中位于中間部分那條主線,其他只會(huì)稍做講解。
二、@SpringBootConfiguration
我們剛剛已經(jīng)簡單看了一下 @SpringBootConfiguration 啦。
@Configuration @Indexed public @interface SpringBootConfiguration {}它是 springboot 的配置類,標(biāo)注在某個(gè)類上,表示這是一個(gè) springboot的配置類。
我們在這看到 @Configuration ,這個(gè)注解我們在 Spring 中就已經(jīng)看到過了,它的意思就是將一個(gè)類標(biāo)注為 Spring 的配置類,相當(dāng)于之前 Spring 中的 xml 文件,可以向容器中注入組件。
不是探究重點(diǎn)。
三、@EnableAutoConfiguration
我們來看看這玩意,它的字面意思就是:自動(dòng)導(dǎo)入配置。
@Inherited @AutoConfigurationPackage 自動(dòng)導(dǎo)包 @Import(AutoConfigurationImportSelector.class) 自動(dòng)配置導(dǎo)入選擇 public @interface EnableAutoConfiguration {}從這里顧名思義就能猜到這里肯定是跟自動(dòng)配置有關(guān)系的。
我們接著來看看這上面的兩個(gè)注解 @AutoConfigurationPackage 和 @Import(AutoConfigurationImportSelector.class) ,這兩個(gè)才是我們研究的重點(diǎn)。
3.1、@AutoConfigurationPackage
點(diǎn)進(jìn)去一看:
@Inherited @Import(AutoConfigurationPackages.Registrar.class) public @interface AutoConfigurationPackage {}@Import 為 spring 的注解,導(dǎo)入一個(gè)配置文件,在 springboot 中為給容器導(dǎo)入一個(gè)組件,而導(dǎo)入的組件由 AutoConfigurationPackages.Registrar.class 執(zhí)行邏輯來決定的。
往下👇看:Registrar
static class Registrar implements ImportBeanDefinitionRegistrar, DeterminableImports {@Overridepublic void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {register(registry, new PackageImports(metadata).getPackageNames().toArray(new String[0]));}@Overridepublic Set<Object> determineImports(AnnotationMetadata metadata) {return Collections.singleton(new PackageImports(metadata));} }在這個(gè)地方我們可以打個(gè)斷點(diǎn),看看 new PackageImports(metadata).getPackageNames().toArray(new String[0]) 它是一個(gè)什么值。
我們用 Evaluate 計(jì)算 new PackageImports(metadata).getPackageNames().toArray(new String[0]) 出來可以看到就是 com.crush.hello ,當(dāng)前啟動(dòng)類所在的包。
繼續(xù)往下看的話就是和 Spring 注冊相關(guān)了,更深入 xdm 可以繼續(xù) debug。
在這里我們可以得到一個(gè)小小的結(jié)論:
@AutoConfigurationPackage 這個(gè)注解本身的含義就是將主配置類(@SpringBootApplication 標(biāo)注的類)所在的包下面所有的組件都掃描到 spring 容器中。
如果將一個(gè) Controller 放到 com.crush.hello 以外就不會(huì)被掃描到了,就會(huì)報(bào)錯(cuò)。
3.2、@Import(AutoConfigurationImportSelector.class)
AutoConfigurationImportSelector 開啟自動(dòng)配置類的導(dǎo)包的選擇器(導(dǎo)入哪些組件的選擇器)
我們點(diǎn)進(jìn) AutoConfigurationImportSelector 類來看看,有哪些重點(diǎn)知識(shí),這個(gè)類中存在方法可以幫我們獲取所有的配置
public class AutoConfigurationImportSelector implements DeferredImportSelector, BeanClassLoaderAware,ResourceLoaderAware, BeanFactoryAware, EnvironmentAware, Ordered {/**選擇需要導(dǎo)入的組件 ,*/@Overridepublic String[] selectImports(AnnotationMetadata annotationMetadata) {if (!isEnabled(annotationMetadata)) {return NO_IMPORTS;}AutoConfigurationEntry autoConfigurationEntry = getAutoConfigurationEntry(annotationMetadata);return StringUtils.toStringArray(autoConfigurationEntry.getConfigurations());}//根據(jù)導(dǎo)入的@Configuration類的AnnotationMetadata返回AutoConfigurationImportSelector.AutoConfigurationEntry 。protected AutoConfigurationEntry getAutoConfigurationEntry(AnnotationMetadata annotationMetadata) {if (!isEnabled(annotationMetadata)) {return EMPTY_ENTRY;}AnnotationAttributes attributes = getAttributes(annotationMetadata);// 可以在這打個(gè)斷點(diǎn),看看 返回的數(shù)據(jù)List<String> configurations = getCandidateConfigurations(annotationMetadata, attributes);//刪除重復(fù)項(xiàng)configurations = removeDuplicates(configurations);// 排除依賴Set<String> exclusions = getExclusions(annotationMetadata, attributes);//檢查checkExcludedClasses(configurations, exclusions);//刪除需要排除的依賴configurations.removeAll(exclusions);configurations = getConfigurationClassFilter().filter(configurations);fireAutoConfigurationImportEvents(configurations, exclusions);return new AutoConfigurationEntry(configurations, exclusions);} }我們看看這個(gè)斷點(diǎn),configurations 數(shù)組長度為131,并且文件后綴名都為 **AutoConfiguration
這里的意思是將所有需要導(dǎo)入的組件以全類名的方式返回,并添加到容器中,最終會(huì)給容器中導(dǎo)入非常多的自動(dòng)配置類(xxxAutoConfiguration),給容器中導(dǎo)入這個(gè)場景需要的所有組件,并配置好這些組件。有了自動(dòng)配置,就不需要我們自己手寫了。
3.2.1、getCandidateConfigurations()
我們還需要思考一下,這些配置都從 getCandidateConfigurations 方法中獲取,這個(gè)方法可以用來獲取所有候選的配置,那么這些候選的配置又是從哪來的呢?
一步一步點(diǎn)進(jìn)去:
protected List<String> getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes) {// 這里有個(gè) loadFactoryNames 方法 執(zhí)行的時(shí)候還傳了兩個(gè)參數(shù),一個(gè)是BeanClassLoader ,另一個(gè)是 getSpringFactoriesLoaderFactoryClass() 我們一起看看List<String> configurations = SpringFactoriesLoader.loadFactoryNames(getSpringFactoriesLoaderFactoryClass(),getBeanClassLoader());Assert.notEmpty(configurations, "No auto configuration classes found in META-INF/spring.factories. If you "+ "are using a custom packaging, make sure that file is correct.");return configurations; }看一下getSpringFactoriesLoaderFactoryClass()方法,這里傳過去的是
protected Class<?> getSpringFactoriesLoaderFactoryClass() {return EnableAutoConfiguration.class; }這個(gè) EnableAutoConfiguration 是不是特別眼熟,(我們探究的起點(diǎn) @EnableAutoConfiguration ,有沒有感覺自己離答案越來越近啦)
我們再看看 loadFactoryNames() 方法帶著它去做了什么處理:
先是將 EnableAutoConfiguration.class 傳給了 factoryType ,然后 .getName( ) ,所以factoryTypeName 值為 EnableAutoConfiguration。
3.2.2、loadSpringFactories()
接下里又開始調(diào)用 loadSpringFactories 方法
這里的 FACTORIES_RESOURCE_LOCATION 在上面有定義:
public static final String FACTORIES_RESOURCE_LOCATION = "META-INF/spring.factories";
我們再回到 getCandidateConfigurations 方法處。
這句斷言的意思是:“在 META-INF/spring.factories 中沒有找到自動(dòng)配置類。如果您使用自定義包裝,請確保該文件是正確的。“
這個(gè) META-INF/spring.factories 在哪里呢?
里面的內(nèi)容:
我們?nèi)粘S玫降?#xff0c;基本上都有一個(gè)配置類。
比如 webmvc,
我們點(diǎn)進(jìn) WebMvcProperties 類中去看一下:
那這里到底是要干什么呢?
這里的意思首先是把這個(gè)文件的 urls 拿到之后并把這些 urls 每一個(gè)遍歷,最終把這些文件整成一個(gè)properties 對象,loadProperties方法
然后再從 properties 對象里邊獲取一些我們需要的值,把這些獲取到的值來加載我們最終要返回的這個(gè)結(jié)果,結(jié)果 result 為 map 集合,然后返回到loadFactoryNames方法中。
然后我們再回到 loadSpringFactories(classLoaderToUse).getOrDefault(factoryTypeName, Collections.emptyList()); 的調(diào)用處。
這個(gè) factoryTypeName 值為 EnableAutoConfiguration
因?yàn)?loadFactoryNames 方法攜帶過來的第一個(gè)參數(shù)為 EnableAutoConfiguration.class,所以 factoryType 值也為 EnableAutoConfiguration.class,那么 factoryTypeName 值為 EnableAutoConfiguration。
那么map集合中 getOrDefault 方法為什么意思呢?意思就是當(dāng) Map 集合中有這個(gè) key 時(shí),就使用這個(gè) key值,如果沒有就使用默認(rèn)值 defaultValue (第二個(gè)參數(shù)),所以是判斷是否包含 EnableAutoConfiguration
看下圖,這不就是嘛?
所以就是把 spring-boot-autoconfigure-2.5.2.jar/META-INF/spring.factories 這個(gè)文件下的EnableAutoConfiguration 下面所有的組件,每一個(gè) xxxAutoConfiguration 類都是容器中的一個(gè)組件,都加入到容器中。加入到容器中之后的作用就是用它們來做自動(dòng)配置,這就是Springboot自動(dòng)配置開始的地方。
只有這些自動(dòng)配置類進(jìn)入到容器中以后,接下來這個(gè)自動(dòng)配置類才開始進(jìn)行啟動(dòng)
那 spring.factories 中存在那么多的配置,每次啟動(dòng)時(shí)都是把它們?nèi)考虞d嗎?
是全部加載嘛?不可能的哈,這誰都知道哈,全部加載啟動(dòng)一個(gè)項(xiàng)目不知道要多久去了。它是有選擇的。
我們隨便點(diǎn)開一個(gè)類,都有這個(gè) @ConditionalOnXXX 注解
@Conditional 其實(shí)是 spring 底層注解,意思就是根據(jù)不同的條件,來進(jìn)行自己不同的條件判斷,如果滿足指定的條件,那么整個(gè)配置類里邊的配置才會(huì)生效。
所以在加載自動(dòng)配置類的時(shí)候,并不是將 spring.factories 的配置全部加載進(jìn)來,而是通過這個(gè)注解的判斷,如果注解中的類都存在,才會(huì)進(jìn)行加載。
這就是SpringBoot的自動(dòng)配置啦.
四、小結(jié)
簡單總結(jié)起來就是:
啟動(dòng)類中有一個(gè) @SpringBootApplication 注解,包含了 @SpringBootConfiguration、 @EnableAutoConfiguration , @EnableAutoConfiguration 代表開啟自動(dòng)裝配,注解會(huì)去 spring-boot-autoconfigure 工程下尋找 META-INF/spring.factories 文件,此文件中列舉了所有能夠自動(dòng)裝配類的清單,然后自動(dòng)讀取里面的自動(dòng)裝配配置類清單。因?yàn)橛?@ConditionalOn 條件注解,滿足一定條件配置才會(huì)生效,否則不生效。 如: @ConditionalOnClass(某類.class) 工程中必須包含一些相關(guān)的類時(shí),配置才會(huì)生效。所以說當(dāng)我們的依賴中引入了一些對應(yīng)的類之后,滿足了自動(dòng)裝配的條件后,自動(dòng)裝配才會(huì)被觸發(fā)。
五、自言自語
紙上得來終覺淺,絕知此事要躬行。
如果可以,可以自己 debug 一遍,畫一畫流程圖。🛌 (躺平)
你好,我是博主寧在春:主頁
希望本篇文章能讓你感到有所收獲!!!
祝 我們:待別日相見時(shí),都已有所成。
如有疑惑,大家可以留言評論。
如有不足之處,請大家指出來,非常感謝 👨?💻。
總結(jié)
以上是生活随笔為你收集整理的今天,我们来详细的聊一聊SpringBoot自动配置原理,学了这么久,你学废了吗?的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 面试官问:Mybatis和Mybati
- 下一篇: SpringBoot 实现固定、动态定时