面试：SpringBoot中的条件注解底层是如何实现的？

点击上方“Java基基”&＃xff0c;选择“设为星标”

做积极的人&＃xff0c;而不是积极废人&＃xff01;

源码精品专栏

• 原创 | Java 2020 超神之路&＃xff0c;很肝~
  

• 中文详细注释的开源项目
  

• RPC 框架 Dubbo 源码解析

• 网络应用框架 Netty 源码解析

• 消息中间件 RocketMQ 源码解析
  

• 数据库中间件 Sharding-JDBC 和 MyCAT 源码解析

• 作业调度中间件 Elastic-Job 源码解析

• 分布式事务中间件 TCC-Transaction 源码解析

• Eureka 和 Hystrix 源码解析

• Java 并发源码

来源&＃xff1a;吃饭睡觉撸代码

• 条件注解内部的一些基础

• 基于Class的条件注解

• 基于Bean的条件注解

• 各种条件注解的总结

• SpringBoot条件注解的激活机制

SpringBoot内部提供了特有的注解&＃xff1a;条件注解(Conditional Annotation)。比如&＃64;ConditionalOnBean、&＃64;ConditionalOnClass、&＃64;ConditionalOnExpression、&＃64;ConditionalOnMissingBean等。

条件注解存在的意义在于动态识别(也可以说是代码自动化执行)。比如&＃64;ConditionalOnClass会检查类加载器中是否存在对应的类&＃xff0c;如果有的话被注解修饰的类就有资格被Spring容器所注册&＃xff0c;否则会被skip。

比如FreemarkerAutoConfiguration这个自动化配置类的定义如下&＃xff1a;

&＃64;Configuration
&＃64;ConditionalOnClass({ freemarker.template.Configuration.class,FreeMarkerConfigurationFactory.class })
&＃64;AutoConfigureAfter(WebMvcAutoConfiguration.class)
&＃64;EnableConfigurationProperties(FreeMarkerProperties.class)
public class FreeMarkerAutoConfiguration


这个自动化配置类被&＃64;ConditionalOnClass条件注解修饰&＃xff0c;这个条件注解存在的意义在于判断类加载器中是否存在freemarker.template.Configuration和FreeMarkerConfigurationFactory这两个类&＃xff0c;如果都存在的话会在Spring容器中加载这个FreeMarkerAutoConfiguration配置类&＃xff1b;否则不会加载。

在分析条件注解的底层实现之前&＃xff0c;我们先来看一下这些条件注解的定义。以&＃64;ConditionalOnClass注解为例&＃xff0c;它的定义如下&＃xff1a;

&＃64;Target({ ElementType.TYPE, ElementType.METHOD })
&＃64;Retention(RetentionPolicy.RUNTIME)
&＃64;Documented
&＃64;Conditional(OnClassCondition.class)
public &＃64;interface ConditionalOnClass {Class[] value() default {}; // 需要匹配的类String[] name() default {}; // 需要匹配的类名
}


它有2个属性&＃xff0c;分别是类数组和字符串数组(作用一样&＃xff0c;类型不一样)&＃xff0c;而且被&＃64;Conditional注解所修饰&＃xff0c;这个&＃64;Conditional注解有个名为values的Class[]类型的属性。这个Condition是个接口&＃xff0c;用于匹配组件是否有资格被容器注册&＃xff0c;定义如下&＃xff1a;

public interface Condition {// ConditionContext内部会存储Spring容器、应用程序环境信息、资源加载器、类加载器boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata);
}


也就是说&＃64;Conditional注解属性中可以持有多个Condition接口的实现类&＃xff0c;所有的Condition接口需要全部匹配成功后这个&＃64;Conditional修饰的组件才有资格被注册。

Condition接口有个子接口ConfigurationCondition&＃xff1a;

public interface ConfigurationCondition extends Condition {ConfigurationPhase getConfigurationPhase();public static enum ConfigurationPhase {PARSE_CONFIGURATION,REGISTER_BEAN}}


这个子接口是一种特殊的条件接口&＃xff0c;多了一个getConfigurationPhase方法&＃xff0c;也就是条件注解的生效阶段。只有在ConfigurationPhase中定义的两种阶段下才会生效。

Condition接口有个实现抽象类SpringBootCondition&＃xff0c;SpringBoot中所有条件注解对应的条件类都继承这个抽象类。它实现了matches方法&＃xff1a;

&＃64;Override
public final boolean matches(ConditionContext context,AnnotatedTypeMetadata metadata) {String classOrMethodName &＃61; getClassOrMethodName(metadata); // 得到类名或者方法名(条件注解可以作用的类或者方法上)try {ConditionOutcome outcome &＃61; getMatchOutcome(context, metadata); // 抽象方法&＃xff0c;具体子类实现。ConditionOutcome记录了匹配结果boolean和log信息logOutcome(classOrMethodName, outcome); // log记录一下匹配信息recordEvaluation(context, classOrMethodName, outcome); // 报告记录一下匹配信息return outcome.isMatch(); // 返回是否匹配}catch (NoClassDefFoundError ex) {throw new IllegalStateException("Could not evaluate condition on " &＃43; classOrMethodName &＃43; " due to "&＃43; ex.getMessage() &＃43; " not "&＃43; "found. Make sure your own configuration does not rely on "&＃43; "that class. This can also happen if you are "&＃43; "&＃64;ComponentScanning a springframework package (e.g. if you "&＃43; "put a &＃64;ComponentScan in the default package by mistake)",ex);}catch (RuntimeException ex) {throw new IllegalStateException("Error processing condition on " &＃43; getName(metadata), ex);}
}
基于Class的条件注解

SpringBoot提供了两个基于Class的条件注解&＃xff1a;&＃64;ConditionalOnClass(类加载器中存在指明的类)或者&＃64;ConditionalOnMissingClass(类加载器中不存在指明的类)。

&＃64;ConditionalOnClass或者&＃64;ConditionalOnMissingClass注解对应的条件类是OnClassCondition&＃xff0c;定义如下&＃xff1a;

&＃64;Order(Ordered.HIGHEST_PRECEDENCE) // 优先级、最高级别
class OnClassCondition extends SpringBootCondition {&＃64;Overridepublic ConditionOutcome getMatchOutcome(ConditionContext context,AnnotatedTypeMetadata metadata) {StringBuffer matchMessage &＃61; new StringBuffer(); // 记录匹配信息MultiValueMap onClasses &＃61; getAttributes(metadata,ConditionalOnClass.class); // 得到&＃64;ConditionalOnClass注解的属性if (onClasses !&＃61; null) { // 如果属性存在List missing &＃61; getMatchingClasses(onClasses, MatchType.MISSING,context); // 得到在类加载器中不存在的类if (!missing.isEmpty()) { // 如果存在类加载器中不存在对应的类&＃xff0c;返回一个匹配失败的ConditionalOutcomereturn ConditionOutcome.noMatch("required &＃64;ConditionalOnClass classes not found: "&＃43; StringUtils.collectionToCommaDelimitedString(missing));}// 如果类加载器中存在对应的类的话&＃xff0c;匹配信息进行记录matchMessage.append("&＃64;ConditionalOnClass classes found: "&＃43; StringUtils.collectionToCommaDelimitedString(getMatchingClasses(onClasses, MatchType.PRESENT, context)));}// 对&＃64;ConditionalOnMissingClass注解做相同的逻辑处理(说明&＃64;ConditionalOnClass和&＃64;ConditionalOnMissingClass可以一起使用)MultiValueMap onMissingClasses &＃61; getAttributes(metadata,ConditionalOnMissingClass.class);if (onMissingClasses !&＃61; null) {List present &＃61; getMatchingClasses(onMissingClasses, MatchType.PRESENT,context);if (!present.isEmpty()) {return ConditionOutcome.noMatch("required &＃64;ConditionalOnMissing classes found: "&＃43; StringUtils.collectionToCommaDelimitedString(present));}matchMessage.append(matchMessage.length() &＃61;&＃61; 0 ? "" : " ");matchMessage.append("&＃64;ConditionalOnMissing classes not found: "&＃43; StringUtils.collectionToCommaDelimitedString(getMatchingClasses(onMissingClasses, MatchType.MISSING, context)));}// 返回全部匹配成功的ConditionalOutcomereturn ConditionOutcome.match(matchMessage.toString());}private enum MatchType { // 枚举&＃xff1a;匹配类型。用于查询类名在对应的类加载器中是否存在。PRESENT { // 匹配成功&＃64;Overridepublic boolean matches(String className, ConditionContext context) {return ClassUtils.isPresent(className, context.getClassLoader());}},MISSING { // 匹配不成功&＃64;Overridepublic boolean matches(String className, ConditionContext context) {return !ClassUtils.isPresent(className, context.getClassLoader());}};public abstract boolean matches(String className, ConditionContext context);}}


比如FreemarkerAutoConfiguration中的&＃64;ConditionalOnClass注解中有value属性是freemarker.template.Configuration.class和FreeMarkerConfigurationFactory.class。在OnClassCondition执行过程中得到的最终ConditionalOutcome中的log message如下&＃xff1a;

&＃64;ConditionalOnClass classes found: freemarker.template.Configuration,org.springframework.ui.freemarker.FreeMarkerConfigurationFactory
基于Bean的条件注解

&＃64;ConditionalOnBean(Spring容器中存在指明的bean)、&＃64;ConditionalOnMissingBean(Spring容器中不存在指明的bean)以及ConditionalOnSingleCandidate(Spring容器中存在且只存在一个指明的bean)都是基于Bean的条件注解&＃xff0c;它们对应的条件类是ConditionOnBean。

&＃64;ConditionOnBean注解定义如下&＃xff1a;

&＃64;Target({ ElementType.TYPE, ElementType.METHOD })
&＃64;Retention(RetentionPolicy.RUNTIME)
&＃64;Documented
&＃64;Conditional(OnBeanCondition.class)
public &＃64;interface ConditionalOnBean {Class[] value() default {}; // 匹配的bean类型String[] type() default {}; // 匹配的bean类型的类名Class[] annotation() default {}; // 匹配的bean注解String[] name() default {}; // 匹配的bean的名字SearchStrategy search() default SearchStrategy.ALL; // 搜索策略。提供CURRENT(只在当前容器中找)、PARENTS(只在所有的父容器中找&＃xff1b;但是不包括当前容器)和ALL(CURRENT和PARENTS的组合)
}


OnBeanCondition条件类的匹配代码如下&＃xff1a;

&＃64;Override
public ConditionOutcome getMatchOutcome(ConditionContext context,AnnotatedTypeMetadata metadata) {StringBuffer matchMessage &＃61; new StringBuffer(); // 记录匹配信息if (metadata.isAnnotated(ConditionalOnBean.class.getName())) {BeanSearchSpec spec &＃61; new BeanSearchSpec(context, metadata,ConditionalOnBean.class); // 构造一个BeanSearchSpec&＃xff0c;会从&＃64;ConditionalOnBean注解中获取属性&＃xff0c;然后设置到BeanSearchSpec中List matching &＃61; getMatchingBeans(context, spec); // 从BeanFactory中根据策略找出所有匹配的beanif (matching.isEmpty()) { // 如果没有匹配的bean&＃xff0c;返回一个没有匹配成功的ConditionalOutcomereturn ConditionOutcome.noMatch("&＃64;ConditionalOnBean " &＃43; spec &＃43; " found no beans");}// 如果找到匹配的bean&＃xff0c;匹配信息进行记录matchMessage.append("&＃64;ConditionalOnBean " &＃43; spec &＃43; " found the following " &＃43; matching);}if (metadata.isAnnotated(ConditionalOnSingleCandidate.class.getName())) { // 相同的逻辑&＃xff0c;针对&＃64;ConditionalOnSingleCandidate注解BeanSearchSpec spec &＃61; new SingleCandidateBeanSearchSpec(context, metadata,ConditionalOnSingleCandidate.class);List matching &＃61; getMatchingBeans(context, spec);if (matching.isEmpty()) {return ConditionOutcome.noMatch("&＃64;ConditionalOnSingleCandidate " &＃43; spec &＃43; " found no beans");}else if (!hasSingleAutowireCandidate(context.getBeanFactory(), matching)) { // 多了一层判断&＃xff0c;判断是否只有一个beanreturn ConditionOutcome.noMatch("&＃64;ConditionalOnSingleCandidate " &＃43; spec&＃43; " found no primary candidate amongst the" &＃43; " following "&＃43; matching);}matchMessage.append("&＃64;ConditionalOnSingleCandidate " &＃43; spec &＃43; " found "&＃43; "a primary candidate amongst the following " &＃43; matching);}if (metadata.isAnnotated(ConditionalOnMissingBean.class.getName())) { // 相同的逻辑&＃xff0c;针对&＃64;ConditionalOnMissingBean注解BeanSearchSpec spec &＃61; new BeanSearchSpec(context, metadata,ConditionalOnMissingBean.class);List matching &＃61; getMatchingBeans(context, spec);if (!matching.isEmpty()) {return ConditionOutcome.noMatch("&＃64;ConditionalOnMissingBean " &＃43; spec&＃43; " found the following " &＃43; matching);}matchMessage.append(matchMessage.length() &＃61;&＃61; 0 ? "" : " ");matchMessage.append("&＃64;ConditionalOnMissingBean " &＃43; spec &＃43; " found no beans");}return ConditionOutcome.match(matchMessage.toString()); //返回匹配成功的ConditonalOutcome
}


SpringBoot还提供了其他比如ConditionalOnJava、ConditionalOnNotWebApplication、ConditionalOnWebApplication、ConditionalOnResource、ConditionalOnProperty、ConditionalOnExpression等条件注解&＃xff0c;有兴趣的读者可以自行查看它们的底层处理逻辑。

分析完了条件注解的执行逻辑之后&＃xff0c;接下来的问题就是SpringBoot是如何让这些条件注解生效的&＃xff1f;

SpringBoot使用ConditionEvaluator这个内部类完成条件注解的解析和判断。

在Spring容器的refresh过程中&＃xff0c;只有跟解析或者注册bean有关系的类都会使用ConditionEvaluator完成条件注解的判断&＃xff0c;这个过程中一些类不满足条件的话就会被skip。这些类比如有AnnotatedBeanDefinitionReader、ConfigurationClassBeanDefinitionReader、ConfigurationClassParse、ClassPathScanningCandidateComponentProvider等。

比如ConfigurationClassParser的构造函数会初始化内部属性conditionEvaluator&＃xff1a;

public ConfigurationClassParser(MetadataReaderFactory metadataReaderFactory,ProblemReporter problemReporter, Environment environment, ResourceLoader resourceLoader,BeanNameGenerator componentScanBeanNameGenerator, BeanDefinitionRegistry registry) {this.metadataReaderFactory &＃61; metadataReaderFactory;this.problemReporter &＃61; problemReporter;this.environment &＃61; environment;this.resourceLoader &＃61; resourceLoader;this.registry &＃61; registry;this.componentScanParser &＃61; new ComponentScanAnnotationParser(resourceLoader, environment, componentScanBeanNameGenerator, registry);// 构造ConditionEvaluator用于处理条件注解this.conditionEvaluator &＃61; new ConditionEvaluator(registry, environment, resourceLoader);
}


ConfigurationClassParser对每个配置类进行解析的时候都会使用ConditionEvaluator&＃xff1a;

if (this.conditionEvaluator.shouldSkip(configClass.getMetadata(), ConfigurationPhase.PARSE_CONFIGURATION)) {return;
}


ConditionEvaluator的skip方法&＃xff1a;

public boolean shouldSkip(AnnotatedTypeMetadata metadata, ConfigurationPhase phase) {// 如果这个类没有被&＃64;Conditional注解所修饰&＃xff0c;不会skipif (metadata &＃61;&＃61; null || !metadata.isAnnotated(Conditional.class.getName())) {return false;}// 如果参数中沒有设置条件注解的生效阶段if (phase &＃61;&＃61; null) {// 是配置类的话直接使用PARSE_CONFIGURATION阶段if (metadata instanceof AnnotationMetadata &&ConfigurationClassUtils.isConfigurationCandidate((AnnotationMetadata) metadata)) {return shouldSkip(metadata, ConfigurationPhase.PARSE_CONFIGURATION);}// 否则使用REGISTER_BEAN阶段return shouldSkip(metadata, ConfigurationPhase.REGISTER_BEAN);}// 要解析的配置类的条件集合List conditions &＃61; new ArrayList();// 获取配置类的条件注解得到条件数据&＃xff0c;并添加到集合中for (String[] conditionClasses : getConditionClasses(metadata)) {for (String conditionClass : conditionClasses) {Condition condition &＃61; getCondition(conditionClass, this.context.getClassLoader());conditions.add(condition);}}// 对条件集合做个排序AnnotationAwareOrderComparator.sort(conditions);// 遍历条件集合for (Condition condition : conditions) {ConfigurationPhase requiredPhase &＃61; null;if (condition instanceof ConfigurationCondition) {requiredPhase &＃61; ((ConfigurationCondition) condition).getConfigurationPhase();}// 没有这个解析类不需要阶段的判断或者解析类和参数中的阶段一致才会继续进行if (requiredPhase &＃61;&＃61; null || requiredPhase &＃61;&＃61; phase) {// 阶段一致切不满足条件的话&＃xff0c;返回true并跳过这个bean的解析if (!condition.matches(this.context, metadata)) {return true;}}}return false;
}


SpringBoot在条件注解的解析log记录在了ConditionEvaluationReport类中&＃xff0c;可以通过BeanFactory获取(BeanFactory是有父子关系的&＃xff1b;每个BeanFactory都存有一份ConditionEvaluationReport&＃xff0c;互不相干)&＃xff1a;

ConditionEvaluationReport conditionEvaluationReport &＃61; beanFactory.getBean("autoConfigurationReport", ConditionEvaluationReport.class);
Map result &＃61; conditionEvaluationReport.getConditionAndOutcomesBySource();
for(String key : result.keySet()) {ConditionEvaluationReport.ConditionAndOutcomes conditionAndOutcomes &＃61; result.get(key);Iterator iterator &＃61; conditionAndOutcomes.iterator();while(iterator.hasNext()) {ConditionEvaluationReport.ConditionAndOutcome conditionAndOutcome &＃61; iterator.next();System.out.println(key &＃43; " -- " &＃43; conditionAndOutcome.getCondition().getClass().getSimpleName() &＃43; " -- " &＃43; conditionAndOutcome.getOutcome());}
}


打印出条件注解下的类加载信息&＃xff1a;

.......
org.springframework.boot.autoconfigure.freemarker.FreeMarkerAutoConfiguration -- OnClassCondition -- required &＃64;ConditionalOnClass classes not found: freemarker.template.Configuration,org.springframework.ui.freemarker.FreeMarkerConfigurationFactory
org.springframework.boot.autoconfigure.groovy.template.GroovyTemplateAutoConfiguration -- OnClassCondition -- required &＃64;ConditionalOnClass classes not found: groovy.text.markup.MarkupTemplateEngine
org.springframework.boot.autoconfigure.gson.GsonAutoConfiguration -- OnClassCondition -- required &＃64;ConditionalOnClass classes not found: com.google.gson.Gson
org.springframework.boot.autoconfigure.h2.H2ConsoleAutoConfiguration -- OnClassCondition -- required &＃64;ConditionalOnClass classes not found: org.h2.server.web.WebServlet
org.springframework.boot.autoconfigure.hateoas.HypermediaAutoConfiguration -- OnClassCondition -- required &＃64;ConditionalOnClass classes not found: org.springframework.hateoas.Resource,org.springframework.plugin.core.Plugin
org.springframework.boot.autoconfigure.hazelcast.HazelcastAutoConfiguration -- OnClassCondition -- required &＃64;ConditionalOnClass classes not found: com.hazelcast.core.HazelcastInstance
.......


一些测试的例子代码在 https://github.com/fangjian0423/springboot-analysis/tree/master/springboot-conditional 上

欢迎加入我的知识星球&＃xff0c;一起探讨架构&＃xff0c;交流源码。加入方式&＃xff0c;长按下方二维码噢&＃xff1a;

已在知识星球更新源码解析如下&＃xff1a;

最近更新《芋道 SpringBoot 2.X 入门》系列&＃xff0c;已经 20 余篇&＃xff0c;覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。

提供近 3W 行代码的 SpringBoot 示例&＃xff0c;以及超 4W 行代码的电商微服务项目。

获取方式&＃xff1a;点“在看”&＃xff0c;关注公众号并回复 666 领取&＃xff0c;更多内容陆续奉上。