扒一扒 @SpringBootApplication 注解背后的奥秘!_java
概 述

Spring Boot的约定大于配置的功力让我们如沐春风,自动配置、开箱即用,繁杂的XML配置也省了,简直不要太爽。而且前一段时间JetBrains公司发布的Java 2020调查也显示Spring Boot的使用占61%。

扒一扒 @SpringBootApplication 注解背后的奥秘!_java_02

我们在开发基于 Spring Boot的应用时,用到了一些新的注解和类,其中我们见得最多的注解之一,当属 Spring Boot 应用启动类上所加的 @SpringBootApplication 注解:

扒一扒 @SpringBootApplication 注解背后的奥秘!_java_03

本文就来看看它到底是个啥!


@SpringBootApplication 注解背后是什么?

@SpringBootApplication注解实际上是Spring Boot提供的一个复合注解,我们来看一看其源码:

@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

我们不妨称其为 “ 三兄弟复合结构 ”,下面分别剖析一下这三个注解各自的功效。


@SpringBootConfiguration

看代码吧,代码里是这样写的:

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

}

这说明 @SpringBootConfiguration 也是来源于 @Configuration,二者功能都是将当前类标注为配置类,并将当前类里以 @Bean 注解标记的方法的实例注入到Spring容器中,实例名即为方法名。

至于@Configuration,我想在非Spring Boot时代大家应该就不陌生,作用是配置Spring容器,也即 JavaConfig 形式的 Spring IoC 容器的配置类所使用。

到目前来看,好像还没有什么新东西。


@EnableAutoConfiguration

再继续看代码,代码是这样的:

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

@EnableAutoConfiguration 注解启用自动配置,其可以帮助 Spring Boot 应用将所有符合条件的 @Configuration 配置都加载到当前 IoC 容器之中,可以简要用图形示意如下:

扒一扒 @SpringBootApplication 注解背后的奥秘!_java_04

接下来我们对照源码,来解释一下这个流程:

  • @EnableAutoConfiguration 借助 AutoConfigurationImportSelector 的帮助,而后者通过实现 selectImports() 方法来导出 Configuration
扒一扒 @SpringBootApplication 注解背后的奥秘!_java_05
  • AutoConfigurationImportSelector类的 selectImports() 方法里面通过调用Spring Core 包里 SpringFactoriesLoader类的loadFactoryNames()方法
扒一扒 @SpringBootApplication 注解背后的奥秘!_java_06
  • 最终通过 SpringFactoriesLoader.loadFactoryNames(),在内部的函数调用里读取了 ClassPath 下面的 META-INF/spring.factories 文件来获取所有导出类。

spring.factories文件里关于 EnableAutoConfiguration的配置其实就是一个 “键值对” 结构,样子大概长下面这样:

扒一扒 @SpringBootApplication 注解背后的奥秘!_java_07

说了这么多,如果从稍微宏观一点的角度 概括总结 上述这一过程那就是:

从 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"})

可见这个注解也并不是什么新东西。

往期资源  需要请自取

Java基础核心知识大总结.pdf 下载

68道C语言/C++常见面试题(含答案)下载

Java后端开发学习路线+知识点总结

前端开发学习路线+知识点总结

C/C++开发(后台)学习路线+知识点总结

嵌入式开发学习路线+知识点总结

每天进步一点点

慢一点才能更快