神祕又強大的@SpringBootApplication註解

時間  2021-04-15
標籤 java spring 數組 springboot 框架 ide 函數 spring-boot 學習 this 欄目 Java 简体版
原文   原文鏈接

1、前言

大部分的配置均可以用Java類+註解來代替，而在SpringBoot項目中見的最多的莫過於@SpringBootApplication註解了，它在每一個SpringBoot的啓動類上都有標註。java

這個註解對SpringBoot的啓動和自動配置到底有什麼樣的影響呢？本文將爲各位大佬解析它的源碼，揭開@SpringBootApplication註解神祕的面紗。spring

2、正文

對SpringBoot工程的自動配置很感興趣，因而學習其源碼並整理了其中一些內容，若是有錯誤請你們指正~話很少說，直接上源碼；數組

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

能夠看到這是一個複合註解，一共包括7個不一樣的註解，下面對這7個不一樣的註解進行分析。框架

2.1 註解

2.1.1 註解1：@Target({ElementType.TYPE})ide

用來表示註解做用範圍，TYPE表示做用範圍爲類或接口。函數

2.1.2 註解2：@Retention(RetentionPolicy.RUNTIME)spring-boot

2.1.3 註解3：@Documented學習

代表這個註釋是由 javadoc記錄的。this

2.1.4 註解4：@Inherited

放在註解上，當父類加了@SpringBootApplication註解時，子類也會繼承這個註解（對接口的實現類無效）。

2.1.5 註解5：@SpringBootConfiguration

底層還是@Configuration註解, 源碼以下：

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

2.1.6 註解6：@ComponetScan

@ComponentScan這個註解在Spring中很重要，它對應XML配置中的元素@ComponentScan的功能其實就是自動掃描並加載符合條件的組件（好比@Component和@Repository等）或者bean定義，最終將這些bean定義加載到IoC容器中。

能夠經過basePackages等屬性來細粒度的定製@ComponentScan自動掃描的範圍，若是不指定，則默認Spring框架實現會從聲明@ComponentScan所在類的package進行掃描。因此SpringBoot的啓動類最好是放在root package下，由於默認不指定basePackages。

2.2 註解：@EnableAutoConfiguration

我的感受@EnableAutoConfiguration這個Annotation最爲重要它的做用能夠歸納爲：藉助@Import的幫助，將全部符合自動配置條件的bean定義加載到IoC容器。

其源碼以下：

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

這裏須要關注@AutoConfigurationPackage和@Import(AutoConfigurationImportSelector.class)兩個註解。

2.2.1 註釋：@AutoConfigurationPackage

源碼以下：

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

能夠發現這個註解的核心其實也是Import註解，表示對於標註該註解的類的包，應當使用AutoConfigurationPackages註冊。接着看Registrar這個類：

static class Registrar implements ImportBeanDefinitionRegistrar, DeterminableImports {
​
    @Override
      //metadata是咱們註解所在的元信息
    public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
            //將咱們註解所在包下全部的組件進行註冊
      register(registry, new PackageImport(metadata).getPackageName());
    }
​
    @Override
    public Set<Object> determineImports(AnnotationMetadata metadata) {
      return Collections.singleton(new PackageImport(metadata));
    }
}

這個類中的核心方法是register方法：

private static final String BEAN = AutoConfigurationPackages.class.getName();
  
  public static void register(BeanDefinitionRegistry registry, String... packageNames) {
    if (registry.containsBeanDefinition(BEAN)) {
      BeanDefinition beanDefinition = registry.getBeanDefinition(BEAN);
      ConstructorArgumentValues constructorArguments = beanDefinition.getConstructorArgumentValues();
      constructorArguments.addIndexedArgumentValue(0, addBasePackages(constructorArguments, packageNames));
​    }
    else {
      GenericBeanDefinition beanDefinition = new GenericBeanDefinition();
      beanDefinition.setBeanClass(BasePackages.class);
      beanDefinition.getConstructorArgumentValues().addIndexedArgumentValue(0, packageNames);
      beanDefinition.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);
      registry.registerBeanDefinition(BEAN, beanDefinition);
    }
}

register方法的邏輯很是清晰：若是這個bean已經被註冊，就獲取它的構造函數參數值，並將包名添加進去；不然就建立一個新的bean定義並進行註冊。經過@AutoConfigurationPackage這個註解，能夠將註解所在包下全部的組件進行註冊。

2.2.2 註解：@Import(AutoConfigurationImportSelector.class)

這個註解導入了AutoConfigurationImportSelector這個類這個類的核心方法是selectImports方法，實現ImportSelector接口。方法基於咱們在pom.xml文件中配置的jar包和組件進行導入。因此方法返回的是一個Class全路徑的String數組，返回的Class會被Spring容器管理。方法源碼以下：

@Override
public String[] selectImports(AnnotationMetadata annotationMetadata) {
  if (!isEnabled(annotationMetadata)) {
    return NO_IMPORTS;
  }
  AutoConfigurationMetadata autoConfigurationMetadata = AutoConfigurationMetadataLoader
      .loadMetadata(this.beanClassLoader);
  AutoConfigurationEntry autoConfigurationEntry = getAutoConfigurationEntry(autoConfigurationMetadata,
      annotationMetadata);
  return StringUtils.toStringArray(autoConfigurationEntry.getConfigurations());
}

這個方法的結構也很清晰，首先經過isEnabled方法判斷是否須要進行導入，若是須要導入的話，經過loadMetadata方法獲取配置信息，並經過getAutoConfigurationEntry進行自動裝配。isEnabled方法源碼以下：

protected boolean isEnabled(AnnotationMetadata metadata) {
  if (getClass() == AutoConfigurationImportSelector.class) {
    return getEnvironment().getProperty(EnableAutoConfiguration.ENABLED_OVERRIDE_PROPERTY, Boolean.class, true);
  }
  return true;
}

這個方法經過EnableAutoConfiguration.ENABLED\_OVERRIDE\_PROPERTY這個配置項進行判斷是否須要自動配置，默認爲true。loadMetadata方法源碼以下：

protected static final String PATH = "META-INF/" + "spring-autoconfigure-metadata.properties";
​
  public static AutoConfigurationMetadata loadMetadata(ClassLoader classLoader) {
    return loadMetadata(classLoader, PATH);
  }
​
  static AutoConfigurationMetadata loadMetadata(ClassLoader classLoader, String path) {
    try {
      Enumeration<URL> urls = (classLoader != null) ? classLoader.getResources(path)
          : ClassLoader.getSystemResources(path);
      Properties properties = new Properties();
      while (urls.hasMoreElements()) {
        properties.putAll(PropertiesLoaderUtils.loadProperties(new UrlResource(urls.nextElement())));
      }
      return loadMetadata(properties);
    }
    catch (IOException ex) {
      throw new IllegalArgumentException("Unable to load @ConditionalOnClass location [" + path + "]", ex);
    }
  }
  static AutoConfigurationMetadata loadMetadata(Properties properties) {
    return new PropertiesAutoConfigurationMetadata(properties);
  }

能夠看到這個方法會加載META-INF/spring-autoconfigure-metadata.properties下的全部配置信息幷包裝成AutoConfigurationMetadata對象返回。

注：spring-autoconfigure-metadata.properties文件在spring-boot-autoconfigure-2.1.9.RELEASE.jar/META-INF下。

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);
}

這個方法是AutoConfiguration的主流程方法，能夠將這個方法的每一行看作一個步驟，那麼處理步驟以下：

1. 加載配置了@EnableAutoConfiguration註解的屬性值getAttribute方法：

protected AnnotationAttributes getAttributes(AnnotationMetadata metadata) {
    String name = getAnnotationClass().getName();
    AnnotationAttributes attributes = AnnotationAttributes.fromMap(metadata.getAnnotationAttributes(name, true));
    Assert.notNull(attributes, () -> "No auto-configuration attributes found. Is " + metadata.getClassName()
        + " annotated with " + ClassUtils.getShortName(name) + "?");
    return attributes;
}

2.獲得META-INF/spring.factories文件中以@EnableAutoConfiguration徹底限定類名作key的value，getCandidateConfigurations方法：

​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;
}
protected Class<?> getSpringFactoriesLoaderFactoryClass() {
    return EnableAutoConfiguration.class;
}

其中，SpringFactoriesLoader.loadFactoryNames()這個方法的做用是使用給定的類加載器從META-INF/spring.factories加載給定類型的工廠實現的徹底限定類名；

3.去重；

4.獲得須要排除的類的類名，這些類能夠在@EnableAutoConfiguration註解中配置；

5.檢查這兩個集合；

6.把須要排除的類移除；

7.根據OnBeanCondition、OnClassCondition等條件進行過濾（有興趣能夠深刻了解）；

8.廣播事件，獲得AutoConfigurationImportListener全部實現類，而後生成事件進行廣播；

9.把須要裝配和排除的類徹底限定名封裝成了AutoConfigurationEntry對象返回。

所以，@EnableAutoConfiguration能夠簡單總結爲：從classpath中搜尋全部的META-INF/spring.factories配置文件，並將其中EnableAutoConfiguration對應的配置項經過反射實例化爲對應的標註了@Configuration的IoC容器配置類，並加載到IoC容器。

3、小結

經過以上分析可知@SpringBootApplication註解的運做是經過@SpringApplicationConfiguration聲明被標註類爲配置類，從而被AnnotationConfigApplicationContext掃描並初始化Spring容器。

經過@EnableAutoConfiguration來掃描，過濾並加載所須要的組件；經過@ComponentScan掃描並註冊全部標註了@Component及其子註解的類；這些註解的共同運做實現了springboot工程強大的自動配置能力。

以上就是本次總結的所有內容，但願能對你們有所幫助。若是有疏漏錯誤之處，還請你們不吝指正。

做者：vivo 互聯網開發團隊-Peng peng
相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程