@ConditionalOnProperty注解

一 源码解析

查看ConditionalOnProperty的源码

 package org.springframework.boot.autoconfigure.condition;

 import java.lang.annotation.Documented;
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 import org.springframework.context.annotation.Conditional;

 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.TYPE, ElementType.METHOD})
 @Documented
 @Conditional({OnPropertyCondition.class})
 public @interface ConditionalOnProperty {
     String[] value() default {};

     String prefix() default "";

     String[] name() default {};

     String havingValue() default "";

     boolean matchIfMissing() default false;
 }

二 说明

    String[] value() default {}; //数组，获取对应property名称的值，与name不可同时使用  

    String prefix() default "";//property名称的前缀，可有可无  

    String[] name() default {};//数组，property完整名称或部分名称（可与prefix组合使用，组成完整的property名称），与value不可同时使用  

    String havingValue() default "";//可与name组合使用，比较获取到的属性值与havingValue给定的值是否相同，相同才加载配置  

    boolean matchIfMissing() default false;//缺少该property时是否可以加载。如果为true，没有该property也会正常加载；反之报错  

三 用法

通过其两个属性name以及havingValue来实现的，其中name用来从application.properties中读取某个属性值。

如果该值为空，则返回false; 如果值不为空，则将该值与havingValue指定的值进行比较，

如果一样则返回true;否则返回false。 如果返回值为false，则该configuration不生效；为true则生效。

四 举例

 public class WebMvcAutoConfiguration {
     public static final String DEFAULT_PREFIX = "";
     public static final String DEFAULT_SUFFIX = "";
     private static final String[] SERVLET_LOCATIONS = new String[]{"/"};

     public WebMvcAutoConfiguration() {
     }

     @Bean
     @ConditionalOnMissingBean({HiddenHttpMethodFilter.class})
     @ConditionalOnProperty(
         prefix = "spring.mvc.hiddenmethod.filter",
         name = {"enabled"},
         matchIfMissing = true
     )
     public OrderedHiddenHttpMethodFilter hiddenHttpMethodFilter() {
         return new OrderedHiddenHttpMethodFilter();
     }

     @Bean
     @ConditionalOnMissingBean({FormContentFilter.class})
     @ConditionalOnProperty(
         prefix = "spring.mvc.formcontent.filter",
         name = {"enabled"},
         matchIfMissing = true
     )
   。。。。。

五 总结

其实Spring底层有很多ConditionalXXXX的注解，用来判断类的注入，ConditionalOnProperty这个注解，常常用来判断配置文件中是否有相应的配置，有则注入容器，无则不注入。