Spring条件装配注解：@Conditional及其衍生扩展注解
条件装配是Spring Boot一大特点，根据是否满足指定的条件来决定是否装配 Bean ，做到了动态灵活性，starter的自动配置类中就是使用@Conditional及其衍生扩展注解@ConditionalOnXXX做到了自动装配的，所以接着之前总结的 Spring Boot自动配置原理和自定义封装一个starter，今天分析一下starter中自动配置类的条件装配注解。
项目推荐：基于SpringBoot2.x、SpringCloud和SpringCloudAlibaba企业级系统架构底层框架封装，解决业务开发时常见的非功能性需求，防止重复造轮子，方便业务快速开发和企业技术栈框架统一管理。引入组件化的思想实现高内聚低耦合并且高度可配置化，做到可插拔。严格控制包依赖和统一版本管理，做到最少化依赖。注重代码规范和注释，非常适合个人学习和企业使用
Github地址：https://github.com/plasticene/plasticene-boot-starter-parent
Gitee地址：https://gitee.com/plasticene3/plasticene-boot-starter-parent
微信公众号：Shepherd进阶笔记
1 @Conditional
@Conditional：该注解是在spring4中新加的，其作用顾名思义就是按照一定的条件进行判断，满足条件才将bean注入到容器中，注解源码如下：
@Target({
ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Conditional {
/**
* All {@link Condition} classes that must {@linkplain Condition#matches match}
* in order for the component to be registered.
*/
Class<? extends Condition>[] value();
}
从代码中可知，该注解可作用在类，方法上，同时只有一个属性value，是一个Class数组，并且需要继承或者实现Condition接口：
@FunctionalInterface
public interface Condition {
boolean matches(ConditionContext var1, AnnotatedTypeMetadata var2);
}
@FunctionalInterface：表示该接口是一个函数式接口，即可以使用函数式编程，lambda表达式。
Condition是个接口，需要实现matches方法，返回true则注入bean，false则不注入。
总结：@Conditional注解通过传入一个或者多个实现了的Condition接口的实现类，重写Condition接口的matches方法，其条件逻辑在该方法之中，作用于创建bean的地方。
根据上面的描述，接下来我模拟多语言环境条件装配切换不同语言的场景：
语言类
@Data
@Builder
public class Language {
private Long id;
private String content;
}
条件：
public class ChineseCondition implements Condition {
@Override
public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
Environment environment = context.getEnvironment();
String property = environment.getProperty("lang");
if (Objects.equals(property, "zh_CN")) {
return true;
}
return false;
}
}
public class EnglishCondition implements Condition {
@Override
public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
Environment environment = context.getEnvironment();
String property = environment.getProperty("lang");
if (Objects.equals(property, "en_US")) {
return true;
}
return false;
}
}
配置类：
@Configuration
public class MyConfig {
@Bean
@Conditional(ChineseCondition.class)
public Language chinese() {
return Language.builder().id(1l).content("华流才是最屌的").build();
}
@Bean
@Conditional(EnglishCondition.class)
public Language english() {
return Language.builder().id(2l).content("english is good").build();
}
public static void main(String[] args) {
System.setProperty("lang", "zh_CN");
AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(MyConfig.class);
String[] beanDefinitionNames = applicationContext.getBeanDefinitionNames();
// 遍历Spring容器中的beanName
for (String beanDefinitionName : beanDefinitionNames) {
System.out.println(beanDefinitionName);
}
}
}
执行结果：chinese ，说明根据条件匹配到ChineseCondition返回true，成功注入bean。
2 @Condition衍生注解
2.1@ConditionalOnBean
@ConditionalOnBean ：当给定的在bean存在时,则实例化当前Bean，示例如下
@Bean
@ConditionalOnBean(name = "address")
public User (Address address) {
//这里如果address实体没有成功注入 这里就会报空指针
address.setCity("hangzhou");
address.setId(1l)
return new User("魅影", city);
}
这里加了ConditionalOnBean注解，表示只有address这个bean存在才会实例化user
2.2.@ConditionalOnMissingBean
@ConditionalOnMissingBean:当给定的在bean不存在时,则实例化当前Bean, 与@ConditionalOnBean相反
@Configuration
public class BeanConfig {
@Bean(name = "notebookPC")
public Computer computer1(){
return new Computer("笔记本电脑");
}
@ConditionalOnMissingBean(Computer.class)
@Bean("reservePC")
public Computer computer2(){
return new Computer("备用电脑");
}
ConditionalOnMissingBean无参的情况，通过源码可知，当这个注解没有参数时，仅当他注解到方法，且方法上也有@Bean，才有意义，否则无意义。那意义在于已被注解方法的返回值类型的名字作为ConditionalOnMissingBean的type属性的值。
2.3.@ConditionalOnClass
@ConditionalOnClass：当给定的类名在类路径上存在，则实例化当前Bean
2.4.@ConditionalOnMissingClass
@ConditionalOnMissingClass：当给定的类名在类路径上不存在，则实例化当前Bean
2.5.@ConditionalOnProperty
@ConditionalOnProperty：Spring Boot通过@ConditionalOnProperty来控制Configuration是否生效
@Retention(RetentionPolicy.RUNTIME)
@Target({
ElementType.TYPE, ElementType.METHOD })
@Documented
@Conditional(OnPropertyCondition.class)
public @interface ConditionalOnProperty {
// 数组，获取对应property名称的值，与name不可同时使用
String[] value() default {
};
// 配置属性名称的前缀，比如spring.http.encoding
String prefix() default "";
// 数组，配置属性完整名称或部分名称
// 可与prefix组合使用，组成完整的配置属性名称，与value不可同时使用
String[] name() default {
};
// 可与name组合使用，比较获取到的属性值与havingValue给定的值是否相同，相同才加载配置
String havingValue() default "";
// 缺少该配置属性时是否可以加载。如果为true，没有该配置属性时也会正常加载；反之则不会生效
boolean matchIfMissing() default false; // 是否可以松散匹配，至今不知道怎么使用的 boolean relaxedNames() default true;}
通过其两个属性name以及havingValue来实现的，其中name用来从application.properties中读取某个属性值。
如果该值为空，则返回false;
如果值不为空，则将该值与havingValue指定的值进行比较，如果一样则返回true;否则返回false。
如果返回值为false，则该configuration不生效；为true则生效。
当然havingValue也可以不设置，只要配置项的值不是false或“false”，都加载Bean
示例代码：
feign:
hystrix:
enabled: true
fegin开启断路器hystrix：
@Bean
@Scope("prototype")
@ConditionalOnMissingBean
@ConditionalOnProperty(name = "feign.hystrix.enabled")
public Feign.Builder feignHystrixBuilder() {
return HystrixFeign.builder();
}
结论：@Conditional及其衍生注解，是为了方便程序根据当前环境或者容器情况来动态注入bean，是Spring Boot条件装配实现的核心所在。
