Spring Boot 中的条件注解

Spring Boot条件注解的汇总：

@ConditionalOnBean

意义：表示当容器中存在指定类型或满足特定条件的 Bean 时，才会使被注解的配置生效或创建对应的 Bean。

使用示例：

@Configuration
@ConditionalOnBean(name = "userService") 
public class SpecialConfig {
    // 当容器中存在名为userService的Bean时，该配置类才生效
}

@ConditionalOnClass

意义：当类路径下存在指定的类时，被注解的配置或 Bean 定义才会生效。用于确保依赖类存在时才进行相关配置。

使用示例：

@Configuration
@ConditionalOnClass(name = "org.example.SomeService") 
public class FeatureConfig {
    // 当类路径下存在org.example.SomeService类时，该配置类生效
}

@ConditionalOnExpression

意义：基于 SpEL（Spring 表达式语言）表达式的结果来判断条件是否满足。可以灵活地根据表达式逻辑决定配置是否生效。

使用示例

@Configuration
@ConditionalOnExpression("${app.debug:false} == true") 
public class DebugConfig {
    // 当配置文件中app.debug为true时，该配置类生效
}

@ConditionalOnJava

意义：根据当前运行的 Java 版本来判断条件是否满足，用于兼容不同 Java 版本的配置。

使用示例：

@Configuration
@ConditionalOnJava(range = ConditionalOnJava.Range.EQUAL_OR_NEWER, value = JavaVersion.EIGHT) 
public class Java8PlusConfig {
    // 当运行环境为Java 8或更高版本时，该配置类生效
}

@ConditionalOnJndi

意义：当 JNDI（Java 命名和目录接口）中存在指定的名称时，被注解的配置或 Bean 定义才会生效。

使用示例：

@Configuration
@ConditionalOnJndi(name = "java:comp/env/jdbc/myDS") 
public class JndiDataSourceConfig {
    // 当JNDI中存在指定名称的数据源时，该配置类生效
}

@ConditionalOnMissingBean

意义：当容器中不存在指定类型或满足特定条件的 Bean 时，才会使被注解的配置生效或创建对应的 Bean。和@ConditionalOnBean 相反。

使用示例：

@Configuration
@ConditionalOnMissingBean(UserService.class) 
public class DefaultUserServiceConfig {
    // 当容器中不存在UserService类型的Bean时，创建默认的UserService Bean
}

@ConditionalOnMissingClass

意义：当类路径下不存在指定的类时，被注解的配置或 Bean 定义才会生效。和@ConditionalOnClass 相反。

使用示例：

@Configuration
@ConditionalOnMissingClass(name = "org.example.ExpensiveLibrary") 
public class FallbackConfig {
    // 当类路径下不存在org.example.ExpensiveLibrary类时，该配置类生效
}

@ConditionalOnNotWarDeployment

意义：当应用不是以 WAR 包形式部署时，被注解的配置或 Bean 定义才会生效。

使用示例：

@Configuration
@ConditionalOnNotWarDeployment
public class NonWarDeploymentConfig {
    // 非WAR包部署时，该配置类生效
}

@ConditionalOnNotWebApplication

意义：当应用不是 Web 应用程序时，被注解的配置或 Bean 定义才会生效。

使用示例：

@Configuration
@ConditionalOnNotWebApplication
public class NonWebAppConfig {
    // 非Web应用场景下，该配置类生效
}

@ConditionalOnProperty

意义：根据配置文件中的属性值来判断条件是否满足。可用于根据配置灵活启用或禁用配置。

使用示例：

@Configuration
@ConditionalOnProperty(name = "app.feature.enable", havingValue = "true") 
public class FeatureEnableConfig {
    // 当配置文件中app.feature.enable属性值为true时，该配置类生效
}

@ConditionalOnResource

意义：当类路径下存在指定的资源（如文件、目录等）时，被注解的配置或 Bean 定义才会生效。

使用示例：

@Configuration
@ConditionalOnResource(resources = "classpath:config/custom.properties") 
public class CustomResourceConfig {
    // 当类路径下存在config/custom.properties文件时，该配置类生效
}

@ConditionalOnSingleCandidate

意义：当容器中指定类型的 Bean 只有一个候选（即单例）时，被注解的配置或 Bean 定义才会生效。

使用示例：

@Configuration
@ConditionalOnSingleCandidate(UserService.class) 
public class SingleUserServiceConfig {
    // 当容器中UserService类型的Bean只有一个时，该配置类生效
}

@ConditionalOnThreading

意义：基于线程相关条件判断，Spring Boot 内部特定场景使用，应用开发中较少直接用。

使用示例：

@Configuration
@ConditionalOnThreading
public class ThreadingRelatedConfig {
    // 满足线程相关条件时，配置生效
}

@ConditionalOnWarDeployment

意义：当应用是以 WAR 包形式部署时，被注解的配置或 Bean 定义才会生效。

使用示例：

@Configuration
@ConditionalOnWarDeployment
public class WarDeploymentConfig {
    // WAR包部署时，该配置类生效
}

@ConditionalOnWebApplication

意义：当应用是 Web 应用程序时，被注解的配置或 Bean 定义才会生效。

使用示例：

@Configuration
@ConditionalOnWebApplication
public class WebAppConfig {
    // 作为Web应用时，该配置类生效
}

@ConditionalOnCloudPlatform

意义：根据运行的云平台来判断条件是否满足，比如判断是否在特定云厂商（如 AWS、Azure 等）环境中运行，以决定配置是否生效。

使用示例：

@Configuration
@ConditionalOnCloudPlatform(value = CloudPlatform.AWS) 
public class AwsSpecificConfig {
    // 运行在AWS云平台时，该配置类生效
}

@ConditionalOnCheckpointRestore

意义：Spring Boot 特定场景下，基于检查点恢复相关条件判断，一般用于 Spring Boot 内部或特定恢复机制场景 ，应用开发中较少直接使用。

使用示例：

@Configuration
@ConditionalOnCheckpointRestore
public class RestoreRelatedConfig {
    // 满足检查点恢复条件时，配置生效
}