目录
- 背景
- 自动装配/自动配置
- springboot是如何实现自动配置的
- 核心注解
- AutoConfigurationImportSelector 类的继承体系
- Spring Boot 提供的条件注解
- 示例
- 注意版本
背景
-
没有 Spring Boot 的情况下,我们引入第三方依赖之后,需要手动配置。
-
比如需要手动将引入的第三方依赖通过 xml 配置或注解的方式注入到 Ioc 容器中,并可能需要对注入到Ioc容器中的bean进行一些配置,非常麻烦。
-
但是,在Spring Boot 中,我们直接引入一个 starter 即可。例如:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency>
自动装配/自动配置
- SpringBoot2.7以前定义了一套接口规范,这套规范规定:
- SpringBoot 在启动时会扫描外部引用 jar 包中的 META-INF/spring.factories 文件,将文件中配置的类型信息加载到 Spring 容器(此处涉及到 JVM 类加载机制与 Spring 的容器知识),并执行类中定义的各种操作。
- 对于外部 jar 来说,只需要按照 SpringBoot 定义的标准,就能将自己的功能装置进 SpringBoot
- 引入 starter 之后,我们通过少量注解和一些简单的配置就能使用第三方组件提供的功能了
- 所以说,其实自动装配可以简单的理解为:通过注解或者一些简单的配置就能在spring boot的帮助下实现某款功能
springboot是如何实现自动配置的
核心注解
首先我们先来看一些 SpringBoot 项目的核心注解 @SpringBootApplication:
-
点击 @SpringBootConfiguration 注解,发现这个注解其实就是一个配置注解,SpringBoot 把 @Configuration 注解做一个包装。
-
所以说 @SpringBootApplication 是一个复合注解,大概就可以把 @SpringBootApplication 看作是这三个注解的集合:
- @EnableAutoConfiguration:启用 SpringBoot 的自动配置机制。
- @Configuration:允许在上下文中注册额外的 bean 或导入其他配置类,作用与applicationContext.xml 的功能相同。
- @ComponentScan: 扫描包下的类中添加了@Component (@Service,@Controller,@Repostory,@RestController)注解的类 ,并添加的到spring的容器中,可以自定义不扫描某些 bean。如下图所示,容器中将排除TypeExcludeFilter和AutoConfigurationExcludeFilter。
-
也就是说,@EnableAutoConfiguration 是实现自动装配的核心注解,@EnableAutoConfiguratio的内部如下所示。
-
思考:AutoConfigurationImportSelector 类到底做了什么?
AutoConfigurationImportSelector 类的继承体系
-
可以看出:AutoConfigurationImportSelector 类实现了 ImportSelector 接口,也就实现了这个接口中的 selectImports 方法
-
该方法主要用于获取所有符合条件的类的全限定类名,需要为这些类创建对象并加载到 IoC 容器中
-
这里我们需要重点关注一下 getAutoConfigurationEntry方法,这个方法主要负责加载自动配置类的。该方法调用链如下:
protected AutoConfigurationEntry getAutoConfigurationEntry(AnnotationMetadata annotationMetadata) { //第1步:判断自动装配开关是否打开 if (!isEnabled(annotationMetadata)) { return EMPTY_ENTRY; } //第2步:用于获取注解中的exclude和excludeName。 //获取注解属性 AnnotationAttributes attributes = getAttributes(annotationMetadata); //第3步:获取需要自动装配的所有配置类,读取META-INF/spring.factories //读取所有预配置类 List<String> configurations = getCandidateConfigurations(annotationMetadata, attributes); //第4步:符合条件加载 //去掉重复的配置类 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); }
- 第1步:判断自动装配开关是否打开。默认 spring.boot.enableautoconfiguration = true,可在 application.properties 或 application.yml 中设置。
- 第2步:用于获取 EnableAutoConfiguration 注解中的 exclude 和 excludeName。
- 第3步:从 META-INF/spring.factories 读取需要自动装配的所有配置类。所有 Spring Boot Starter 下的 META-INF/spring.factories 都会被读取到。
- 第4步:spring.factories 中这么多配置,每次启动都要全部加载么?很明显,这是不现实的。我们 debug 到后面你会发现,configurations 的值变小了。。因为,这一步有经历了一遍筛选过滤,@ConditionOnXXX 中的所有条件都满足,该类才会生效。
Spring Boot 提供的条件注解
- @ConditionalOnBean:当容器里有指定 Bean 的条件下
- @ConditionalOnMissingBean:当容器里没有指定 Bean 的情况下
- @ConditionalOnSingleCandidate:当指定 Bean 在容器中只有一个,或者虽然有多个但是指定首选 Bean
- @ConditionalOnClass:当类路径下有指定类的条件下
- @ConditionalOnMissingClass:当类路径下没有指定类的条件下
- @ConditionalOnProperty:指定的属性是否有指定的值
- @ConditionalOnResource:类路径是否有指定的值
- @ConditionalOnExpression:基于 SpEL 表达式作为判断条件
- @ConditionalOnJava:基于 Java 版本作为判断条件
- @ConditionalOnJndi:在 JNDI 存在的条件下差在指定的位置
- @ConditionalOnNotWebApplication:当前项目不是 Web 项目的条件下
- @ConditionalOnWebApplication:当前项目是 Web 项 目的条件下
示例
以redis为例,然后在当前springboot项目中双击Shift,在弹出的页面中搜索找到RedisAutoConfiguration类。
- 由RedisAutoConfiguration类上面的注解可知,RedisAutoConfiguration类有一个bean加载控制的注解。也就是说,当前类要想加载成bean,必须在当前项目中导入RedisOperations这个类,也就是当前类加载成bean的触发条件,而RedisOperations这个类在我们导入的redis的依赖包中。
- 在RedisAutoConfiguration类上方有一个 @EableConfigurationProperties 注解。进入@EableConfigurationProperties 注解里的RedisProperties类中,如下图所示, RedisProperties 类上方有一个 @ConfigurationProperties 注解,此注解用来将配置文件中前缀为 spring.redis 的配置值绑定到类中属性上。
- 但是可以发现,RedisProperties类里很多属性已经配置了默认值。也就是说,如果 springboot 配置文件中没有配置值,则 springboot 会采用 RedisProperties 类中属性的默认值来作为redis这项技术的默认配置值。
注意版本
spring.factories 功能在 SpringBoot 2.7 已经废弃,并且在 SpringBoot 3.0 移除。但机制还是类似的