SpringBoot 中 @SpringBootApplication註解背後的三體結構探祕

Profile

概 述

SpringBoot 約定大於配置 的功力讓我們如沐春風,在我之前寫的文章《從SpringBoot到SpringMVC》
也對比過 SpringBoot 和 SpringMVC 這兩個框架,不過最終 SpringBoot 以超高的代碼信噪比 和 易上手性 讓我們映像頗深。

但歸根結底,不論 SpringBoot 或者 SpringMVC 應用本質上依然是一個基於 Spring的應用,只不過在後者臉龐上蒙上了一層神祕的面紗而已!

回到 SpringBoot 的話題,我們在開發基於 SpringBoot 的應用時,用到了一些新的註解和類,正式由於其存在,才讓JavaEE的開發如魚得水。這其中我們用的最多的註解之一,當屬 SpringBoot 應用啓動類上的 @SpringBootApplication 註解了

本文就來看看它到底是個啥!

注: 本文原載於 My Personal Blog:CodeSheep · 程序羊



@SpringBootApplication 背後到底是什麼?

@SpringBootApplication註解實際上是SpringBoot提供的一個複合註解,我們來看一看其源碼:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = {
        @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
        @Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {
    ...
}

看得很清楚,其是一個合成體,但其中最重要的三個註解分別是:

  • @SpringBootConfiguration

  • @EnableAutoConfiguration

  • @ComponentScan

我們不妨稱其爲 “ 三體結構 ” 吧!

如果我們不怕麻煩,在 SpringBoot 應用的啓動類上用這個三個註解代替@SpringBootApplication 註解發現也是沒問題的:

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan
public class TestSpringBootApplication {
    ...
}

下面分別剖析一下這三個註解的功效!



@SpringBootConfiguration

看代碼吧,代碼裏是這樣寫的:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
public @interface SpringBootConfiguration {

}

這說明 @SpringBootConfiguration 也是來源於 @Configuration,二者功能都是將當前類標註爲配置類,並將當前類裏以 @Bean 註解標記的方法的實例注入到srping容器中,實例名即爲方法名。

至於@Configuration,我想在非SpringBoot時代大家應該不陌生吧,作用是配置Spring容器,也即 JavaConfig 形式的 Spring IoC 容器的配置類所使用。

到目前來看,好像還沒有什麼新東西!!!



@EnableAutoConfiguration

再繼續看代碼,代碼是這樣的:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
    ...
}

@EnableAutoConfiguration 註解啓用自動配置,其可以幫助 SpringBoot 應用將所有符合條件的 @Configuration 配置都加載到當前 IoC 容器之中,可以簡要用圖形示意如下:

@EnableAutoConfiguration 幕後的組件調用關係

接下來我們對照源碼,來解釋一下這個流程:

  • @EnableAutoConfiguration 藉助 AutoConfigurationImportSelector 的幫助,而後者通過實現 selectImports() 方法來導出 Configuration
selectImports()
  • AutoConfigurationImportSelector 類的 selectImports() 方法裏面通過調用Spring Core 包裏 SpringFactoriesLoader 類的 loadFactoryNames()方法
SpringFactoriesLoader.loadFactoryNames()
  • 最終通過 SpringFactoriesLoader.loadFactoryNames() 讀取了 ClassPath 下面的 META-INF/spring.factories 文件來獲取所有導出類。

而spring.factories 文件裏關於 EnableAutoConfiguration 的配置其實就是一個鍵值對結構,樣子大概長下面這樣:

spring.factories

說了這麼多,如果從稍微宏觀一點的角度 概括總結 上述這一過程那就是:

從 ClassPath下掃描所有的 META-INF/spring.factories 配置文件,並將spring.factories 文件中的 EnableAutoConfiguration 對應的配置項通過反射機制實例化爲對應標註了 @Configuration 的形式的IoC容器配置類,然後注入IoC容器。



@ComponentScan

@ComponentScan 對應於XML配置形式中的 <context:component-scan>,用於將一些標註了特定註解的bean定義批量採集註冊到Spring的IoC容器之中,這些特定的註解大致包括:

  • @Controller
  • @Entity
  • @Component
  • @Service
  • @Repository

等等

對於該註解,還可以通過 basePackages 屬性來更細粒度的控制該註解的自動掃描範圍,比如:

@ComponentScan(basePackages = {"cn.codesheep.controller","cn.codesheep.entity"})

可見 這個註解也並不是什麼新東西!



後 記

由於能力有限,若有錯誤或者不當之處,還請大家批評指正,一起學習交流!



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章