SpringBoot系列：SpringBoot中的条件注解是如何实现的

📖摘要

鼓励有时比压力要重要！

在学习的过程中，很多时候我们听到的都是，你要怎样，怎样，你瞧瞧谁谁谁，哪怕今天听不到这样的声音了，但因为曾经反复听到过而导致内心抗拒。虽然也知道自己要去学，但是很难坚持，学着学着就没有了方向，看到还有那么多不会的就更慌了，以至于最后心态崩了，更不愿意学。其实程序员的压力并不小，想成长几乎是需要一直的学习，就像似乎再也不敢说精通java了一样，知识量实在是随着学习的深入，越来越深，越来越广。所以需要，开心学习，快乐成长！

今天分享下 —— SpringBoot系列：SpringBoot中的条件注解是如何实现的 的一些基本知识，欢迎关注！

---

🌂分享

SpringBoot 内部提供了特有的注解：条件注解(Conditional Annotation)。比如：

• @ConditionalOnBean、
• @ConditionalOnClass、
• @ConditionalOnExpression、
• @ConditionalOnMissingBean等。

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

比如FreemarkerAutoConfiguration这个自动化配置类的定义如下：

@Configuration
@ConditionalOnClass({ freemarker.template.Configuration.class,
    FreeMarkerConfigurationFactory.class })
@AutoConfigureAfter(WebMvcAutoConfiguration.class)
@EnableConfigurationProperties(FreeMarkerProperties.class)
public class FreeMarkerAutoConfiguration

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

---

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

在分析条件注解的底层实现之前，我们先来看一下这些条件注解的定义。以 @ConditionalOnClass 注解为例，它的定义如下：

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

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

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

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

Condition接口有个子接口ConfigurationCondition：

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

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

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

@Override
public final bo