Springboot 系列（三）Spring Boot 自動配置原理解析

文章已經收錄在 Github.com/niumoo/JavaNotes ，更有 Java 程序員所須要掌握的核心知識，歡迎Star和指教。
歡迎關注個人 公衆號，文章每週更新。

注意：本 Spring Boot 系列文章基於 Spring Boot 版本 v2.1.1.RELEASE 進行學習分析，版本不一樣可能會有細微差異。

前言

關於配置文件能夠配置的內容，在 Spring Boot 官方網站已經提供了完整了配置示例和解釋。

能夠這麼說，Spring Boot 的一大精髓就是自動配置，爲開發省去了大量的配置時間，能夠更快的融入業務邏輯的開發，那麼自動配置是怎麼實現的呢？
<!-- more -->

1. @SpringBootApplication

跟着 Spring Boot 的啓動類的註解 @SpringBootApplication 進行源碼跟蹤，尋找自動配置的原理。

@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 {

@EnableAutoConfiguration 開啓自動配置。

@ComponentScan 開啓註解掃描

從 SpringBootApplication 咱們能夠發現，這是一個簡便的註解配置，它包含了自動配置，配置類，包掃描等一系列功能。

2. @EnableAutoConfiguration

繼續跟蹤，查看@EnableAutoConfiguration 源碼，裏面比較重要的是 @Import ，導入了一個翻譯名爲自動配置的選擇器的類。這個類其實就是自動配置的加載選擇器。

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
    String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";

    Class<?>[] exclude() default {};

    String[] excludeName() default {};
}

繼續跟蹤 AutoConfigurationImportSelector.class .在這個類有一個重要的方法 getCandidateConfigurations.用於加載 Spring Boot 配置的自動配置類。

getAutoConfigurationEntry 會篩選出有效的自動配置類。

protected AutoConfigurationEntry getAutoConfigurationEntry(
            AutoConfigurationMetadata autoConfigurationMetadata,
            AnnotationMetadata annotationMetadata) {
        if (!isEnabled(annotationMetadata)) {
            return EMPTY_ENTRY;
        }
        AnnotationAttributes attributes = getAttributes(annotationMetadata);
        List<String> configurations = getCandidateConfigurations(annotationMetadata,
                attributes);
        configurations = removeDuplicates(configurations);
        Set<String> exclusions = getExclusions(annotationMetadata, attributes);
        checkExcludedClasses(configurations, exclusions);
        configurations.removeAll(exclusions);
        configurations = filter(configurations, autoConfigurationMetadata);
        fireAutoConfigurationImportEvents(configurations, exclusions);
        return new AutoConfigurationEntry(configurations, exclusions);
    }    

protected List<String> getCandidateConfigurations(AnnotationMetadata metadata,
            AnnotationAttributes attributes) {
        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;
    }

下圖是 DEBUG 模式下篩選以後的結果，由於我只添加了 web 模塊，因此只有 web 相關的自動配置。

3. xxxAutoConfiguration 與 xxxProperties

在上面的 debug 裏，咱們看到了成功加載的自動配置，目前只看到了配置類，卻尚未發現自動配置值，隨便選擇一個 AutoConfiguration 查看源碼。

這裏選擇了 ServletWebServerFactoryAutoConfiguration.

@Configuration
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE)
//判斷當前項目有沒有這個類
//CharacterEncodingFilter；SpringMVC中進行亂碼解決的過濾器；
@ConditionalOnClass(ServletRequest.class)
//Spring底層@Conditional註解（Spring註解版），根據不一樣的條件，若是
//知足指定的條件，整個配置類裏面的配置就會生效； 判斷當前應用是不是web應用，若是是，當前配置類生效
@ConditionalOnWebApplication(type = Type.SERVLET)
@EnableConfigurationProperties(ServerProperties.class)
@Import({ ServletWebServerFactoryAutoConfiguration.BeanPostProcessorsRegistrar.class,
        ServletWebServerFactoryConfiguration.EmbeddedTomcat.class,
        ServletWebServerFactoryConfiguration.EmbeddedJetty.class,
        ServletWebServerFactoryConfiguration.EmbeddedUndertow.class })
public class ServletWebServerFactoryAutoConfiguration {

須要注意的是 @EnableConfigurationProperties(ServerProperties.class).他的意思是啓動指定類的
ConfigurationProperties功能；將配置文件中對應的值和 ServerProperties 綁定起來；並把
ServerProperties 加入到 IOC 容器中。

再來看一下 ServerProperties .

@ConfigurationProperties(prefix = "server", ignoreUnknownFields = true)
public class ServerProperties {

    /**
     * Server HTTP port.
     */
    private Integer port;

顯而易見了，這裏使用 ConfigurationProperties 綁定屬性映射文件中的 server 開頭的屬性。結合默認配置

# 路徑spring-boot-autoconfigure-2.1.1.RELEASE.jar
# /META-INF/spring-configuration-metadata.json

    {
      "name": "server.port",
      "type": "java.lang.Integer",
      "description": "Server HTTP port.",
      "sourceType": "org.springframework.boot.autoconfigure.web.ServerProperties",
      "defaultValue": 8080
    }

達到了自動配置的目的。

4. 自動配置總結

1. SpringBoot 啓動的時候加載主配置類，開啓了自動配置功能 @EnableAutoConfiguration 。
2. @EnableAutoConfiguration 給容器導入META-INF/spring.factories 裏定義的自動配置類。
3. 篩選有效的自動配置類。
4. 每個自動配置類結合對應的 xxxProperties.java 讀取配置文件進行自動配置功能 。

5. 配置類

經過自動配置，咱們發現已經幫咱們省去了大量的配置文件的編寫，那麼在自定義配置的時候，咱們是否是須要編寫XML呢？Spring boot 儘管可使用 SpringApplicationXML 文件進行配置，可是咱們一般會使用 @Configuration 類進行代替，這也是官方推薦的方式。

5.1 XML配置

定義 helloService Bean.

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="helloService" class="net.codingme.boot.service.HelloService"></bean>

</beans>

引入配置。

@ImportResource(value = "classpath:spring-service.xml")
@SpringBootApplication
public class BootApplication {

    public static void main(String[] args) {
        SpringApplication.run(BootApplication.class, args);
    }
}

5.2 註解配置

此種方式和上面的XML配置是等效的，也是官方推薦的方式。@Configuration 註解的類（要在掃描的包路徑中）會被掃描到。

/**
 * <p>
 * 配置類，至關於傳統Spring 開發中的 xml-> bean的配置
 *
 * @Author niujinpeng
 * @Date 2018/12/7 0:04
 */
@Configuration
public class ServiceConfig {

    /**
     * 默認添加到容器中的 ID 爲方法名（helloService）
     *
     * @return
     */
    @Bean
    public HelloService helloService() {
        return new HelloService();
    }
}

6. 附錄

@Conditional擴展註解	做用（判斷是否知足當前指定條件）
@ConditionalOnJava	系統的java版本是否符合要求
@ConditionalOnBean	容器中存在指定Bean；
@ConditionalOnMissingBean	容器中不存在指定Bean；
@ConditionalOnExpression	知足SpEL表達式指定
@ConditionalOnClass	系統中有指定的類
@ConditionalOnMissingClass	系統中沒有指定的類
@ConditionalOnSingleCandidate	容器中只有一個指定的Bean，或者這個Bean是首選Bean
@ConditionalOnProperty	系統中指定的屬性是否有指定的值
@ConditionalOnResource	類路徑下是否存在指定資源文件
@ConditionalOnWebApplication	當前是web環境
@ConditionalOnNotWebApplication	當前不是web環境
@ConditionalOnJndi	JNDI存在指定項

文章代碼已經上傳到 GitHub Spring Boot 自動配置。

最後的話

文章已經收錄在 Github.com/niumoo/JavaNotes ，歡迎Star和指教。更有一線大廠面試點，Java程序員須要掌握的核心知識等文章，也整理了不少個人文字，歡迎 Star 和完善，但願咱們一塊兒變得優秀。

文章有幫助能夠點個「贊」或「分享」，都是支持，我都喜歡！
文章每週持續更新，要實時關注我更新的文章以及分享的乾貨，能夠關注「 未讀代碼 」公衆號或者個人博客。