Spring常用注解@ConditionalOnProperty

Spring框架以其灵活性和易用性在Java开发中占据重要地位。其中，条件注解（Conditional Annotation）是Spring Boot中一个非常有用的特性，它允许开发者根据特定的条件来决定某个Bean是否需要被创建和注册。@ConditionalOnProperty就是其中之一，它允许我们根据Spring环境中的属性值来决定Bean的创建。

基础用法

@ConditionalOnProperty注解通常用于Spring Boot的配置类上，以控制配置类的生效条件。其基本语法如下：

@Configuration
@ConditionalOnProperty(name = "feature.enabled", havingValue = "true")
public class FeatureConfiguration {
    // ...
}

在这个例子中，FeatureConfiguration类仅在feature.enabled属性为true时才会被激活。

属性匹配

@ConditionalOnProperty支持多种匹配方式：

• name：要匹配的属性名。
• havingValue：期望匹配的属性值。
• prefix：属性名的前缀。
• value：与name相同，用于简化写法。
• matchIfMissing：当属性缺失时是否匹配。

例如：

@ConditionalOnProperty(prefix = "feature", name = "enabled", havingValue = "true")
public class FeatureConfiguration {
    // ...
}

这里，只要feature.enabled属性为true，FeatureConfiguration就会被激活。

复合条件

@ConditionalOnProperty还支持复合条件，通过or和and来组合多个条件：

@ConditionalOnProperty(prefix = "feature", name = "enabled", havingValue = "true", matchIfMissing = true)
public class FeatureConfiguration {
    // ...
}

在这个例子中，如果feature.enabled属性不存在，FeatureConfiguration也会被激活。

使用示例

下面是一个简单的Spring Boot应用示例，展示了如何使用@ConditionalOnProperty：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Conditional;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @Configuration
    @ConditionalOnProperty(prefix = "feature", name = "enabled", havingValue = "true")
    public static class FeatureConfiguration {

        @Bean
        public Feature feature() {
            return new Feature();
        }
    }

    public static class Feature {
        public void doSomething() {
            System.out.println("Feature is enabled");
        }
    }
}

在这个例子中，如果feature.enabled属性为true，Feature类会被创建并注册为Spring Bean。