Spring Boot @Conditional注解

🕗 发布于 2024-12-29 01:44 spring boot java spring

在Spring Boot中，@Conditional 注解用于条件性地注册bean。这意味着它可以根据某些条件来决定是否应该创建一个特定的bean。这个注解可以放在配置类或方法上，并且它会根据提供的一组条件来判断是否应该实例化对应的组件。

要使用 @Conditional注解时，需要实现 Condition 接口并重写 matches 方法。此方法将返回一个布尔值以指示条件是否匹配。如果条件为真，则创建bean；否则跳过该bean的创建。

以下是一个简单的例子，展示了如何使用自定义条件：

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class MyCustomCondition implements Condition {

    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        // 在这里添加你的条件逻辑
        // 例如，检查系统属性、环境变量、已经存在的beans等
        return false; // 根据条件逻辑返回true或false
    }
}

ConditionContext：提供了对当前解析上下文的访问，包括：
- Environment：可以用来获取环境变量、系统属性等。
- BeanFactory：如果可用的话，可以通过它访问已经注册的bean。
- ClassLoader：可以用来检查类路径上的类是否存在。
- EvaluationContext：可以用来评估SpEL表达式。
AnnotatedTypeMetadata 提供了对带有注解的方法或类元数据的访问，例如注解属性值。

自定义条件类

假设我们有一个应用程序，它应该根据操作系统的不同来决定是否加载特定的bean。我们可以创建一个名为 OnWindowsCondition 的条件类：

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

public class OnWindowsCondition implements Condition {

    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        return "win".equals(context.getEnvironment().getProperty("os.name").toLowerCase().substring(0, 3));
    }
}

然后在配置类中使用：

@Configuration
public class MyConfig {

    @Bean
    @Conditional(OnWindowsCondition.class)
    public WindowsSpecificService windowsSpecificService() {
        return new WindowsSpecificServiceImpl();
    }
}

Spring Boot提供内置条件注解

@ConditionalOnProperty

当你希望基于配置文件中的属性是否存在或者具有特定值来创建bean时，可以使用 @ConditionalOnProperty 注解。例如：

@Configuration
public class MyConfig {

    @Bean
    @ConditionalOnProperty(name = "my.feature.enabled", havingValue = "true")
    public MyFeature myFeature() {
        return new MyFeature();
    }
}

在这个例子中，只有当配置文件中存在名为 my.feature.enabled 的属性且其值为 true 时，才会创建 MyFeature bean。

@ConditionalOnClass 和 @ConditionalOnMissingClass

这两个注解用于检查类路径下是否存在或不存在某些类。这在集成第三方库时非常有用，因为你可以有条件地注册与这些库相关的bean。例如：

@Configuration
@ConditionalOnClass(name = "com.example.ExternalLibraryClass")
public class ExternalLibraryConfig {
    // ...
}

如果类路径中存在 ExternalLibraryClass 类，则会应用此配置。

@ConditionalOnBean 和 @ConditionalOnMissingBean

这些注解用于根据上下文中是否存在指定类型的bean来决定是否创建新的bean。这对于确保不会重复注册相同功能的bean非常有用。

@Bean
@ConditionalOnMissingBean(MyService.class)
public MyService myService() {
    return new MyServiceImpl();
}

这里的意思是：如果上下文中还没有类型为 MyService 的bean，则创建一个新的 MyServiceImpl 实例并注册为bean。

使用 SpEL 表达式的 @ConditionalOnExpression

可以通过 @ConditionalOnExpression 来编写复杂的条件表达式。例如，基于多个属性组合或者环境变量来决定是否创建bean。

@Bean
@ConditionalOnExpression("${spring.application.name:'default'} == 'myapp' && ${env:dev} == 'prod'")
public ProdSpecificBean prodSpecificBean() {
    return new ProdSpecificBean();
}

这段代码意味着只有当应用程序名称为 'myapp' 并且环境变量 env 设置为 'prod' 时，才会创建 ProdSpecificBean。

使用场景

动态条件评估

有时你可能需要在应用启动后根据某些变化（如用户输入或外部服务的状态）来动态调整bean的行为。虽然 @Conditional 主要用于启动时的静态条件判断，但你可以通过结合其他机制（如事件监听器、定时任务等）来实现类似的效果。

@Configuration
public class DynamicConditionConfig {

    private final AtomicBoolean shouldCreateBean = new AtomicBoolean(false);

    @Bean
    @ConditionalOnProperty(name = "dynamic.bean.enabled", havingValue = "true")
    public MyDynamicBean myDynamicBean() {
        return () -> shouldCreateBean.get();
    }

    // 模拟外部触发更新条件状态的方法
    public void updateCondition(boolean value) {
        shouldCreateBean.set(value);
    }
}

在这个例子中，MyDynamicBean 的行为依赖于一个原子布尔变量 shouldCreateBean，该变量可以在运行时被更改，从而影响bean的行为。

条件化的AOP切面

你还可以将条件应用于AOP切面，以实现更加灵活的横切关注点管理。例如：

@Aspect
@ConditionalOnProperty(name = "app.logging.enabled", havingValue = "true")
public class LoggingAspect {
    @Around("execution(* com.example.service.*.*(..))")
    public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable {
        long start = System.currentTimeMillis();
        Object proceed = joinPoint.proceed();
        long executionTime = System.currentTimeMillis() - start;
        System.out.println(joinPoint.getTarget().getClass().getName() + "." + joinPoint.getSignature().getName() + " executed in " + executionTime + "ms");
        return proceed;
    }
}

这段代码表示只有当 app.logging.enabled=true 时才会激活日志记录切面。

使用 `@Profile` 和 `@Conditional` 结合

有时候，你可能想要结合 @Profile 和 @Conditional 来创建更精细的条件逻辑。例如：

@Configuration
@Profile("dev")
public class DevConfig {

    @Bean
    @ConditionalOnProperty(name = "feature.x.enabled", havingValue = "true")
    public FeatureX featureX() {
        return new FeatureXImpl();
    }
}

这里的意思是：仅在开发环境（dev profile）并且 feature.x.enabled=true 时才创建 FeatureX bean。

条件化代理

对于那些需要延迟初始化或者懒加载的bean，可以考虑使用 @Scope("proxy") 和 @Lazy 注解，结合 @Conditional 来实现条件化代理。

@Bean
@Scope(proxyMode = ScopedProxyMode.TARGET_CLASS)
@Lazy
@ConditionalOnProperty(name = "lazy.init.feature", havingValue = "true")
public LazyInitFeature lazyInitFeature() {
    return new LazyInitFeatureImpl();
}

这确保了只有在满足条件且首次访问 lazyInitFeature bean时才会实例化它。

调试技巧

使用 `@PostConstruct` 和 `@PreDestroy` 监控bean生命周期

为了更好地理解哪些bean被创建或销毁，可以在bean类中添加 @PostConstruct 和 @PreDestroy 方法，并输出日志信息。

@Component
@ConditionalOnProperty(name = "feature.y.enabled", havingValue = "true")
public class FeatureY {

    @PostConstruct
    public void init() {
        System.out.println("FeatureY initialized.");
    }

    @PreDestroy
    public void destroy() {
        System.out.println("FeatureY destroyed.");
    }
}

这种方法有助于跟踪bean的生命周期，并确认条件是否按预期工作。

使用 `spring.main.banner-mode=off` 减少干扰

当你专注于调试条件逻辑时，关闭Spring Boot启动横幅可以帮助减少不必要的输出，使日志更加清晰。

spring.main.banner-mode=off

常见问题

环境属性未正确加载

如果发现条件注解没有按照预期工作，请检查是否正确加载了环境属性文件（如 application.properties 或 application.yml）。确保这些文件位于正确的路径下，并且包含所需的属性定义。

类路径冲突

当遇到条件注解不起作用的问题时，类路径冲突是一个常见的原因。特别是当你使用 @ConditionalOnClass 或 @ConditionalOnMissingClass 时，确保项目中不存在重复的依赖项。你可以使用Maven或Gradle命令来分析依赖树：

Maven:
```
mvn dependency:tree
```
Gradle:
```
gradle dependencies
```

条件逻辑错误

仔细审查你的条件逻辑，确保它们符合预期。可以通过单元测试验证每个条件的行为。例如：

@Test
void testFeatureYEnabled() {
    ApplicationContextRunner runner = new ApplicationContextRunner()
        .withPropertyValues("feature.y.enabled=true");

    runner.run(context -> assertThat(context).hasSingleBean(FeatureY.class));
}

@Test
void testFeatureYDisabled() {
    ApplicationContextRunner runner = new ApplicationContextRunner()
        .withPropertyValues("feature.y.enabled=false");

    runner.run(context -> assertThat(context).doesNotHaveBean(FeatureY.class));
}

注意事项

条件注解只适用于Spring的配置阶段，因此它们不能用于运行时决策。
当使用 @Conditional 或其他条件注解时，请确保你的条件逻辑不会导致循环依赖或意外的行为。
在编写条件逻辑时，考虑到性能影响，尽量使条件判断轻量级。

原文地址：https://blog.csdn.net/m0_50742275/article/details/144673379

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：阿里云技术公开课：基于阿里云 Elasticsearch 构建 AI 搜索和可观测 Chatbot
下一篇：简单讲解关于微信小程序调整 miniprogram 后， tabbar 找不到图片的原因之一

使用PHP函数 “setcookie“ 设置cookie
通过使用PHP的 "setcookie" 函数，我们可以轻松设置和管理cookie。通过指定不同的参数，我们可以定制cookie的值、过期时间、作用域等属性，以便满足实际项目的需求
阅读更多2024-12-29
力扣1358. 包含所有三种字符的子字符串数目
给你一个字符串s，它只包含三种字符 a, b 和 c 。请你返回 a，b 和 c 都至少出现过一次的子字符串数目。
阅读更多2024-12-29
智能流程管理：CRM系统助力订单与回款自动化
在现代企业管理中，客户关系管理（CRM）系统不仅仅是客户信息的存储库，更是企业运营效率提升的关键工具。通过实现订单到回款的自动化管理，CRM系统能够帮助企业减少人为错误，提高响应速度，优化现金流管理。
阅读更多2024-12-29
YunSDR通信小课堂-27
因此，为了保证OFDM性能，必须进行载波频率同步。EEE802．1la系统中，短训练序列符号取样时问为50ns，延时N=16，则可以估计的最大频率误差fmax=1/(2*N*Ts)=1/(2*16*5
阅读更多2024-12-29
房间模式网络游戏的架构与设计
这样云服务器的配置就确定了，在代码不变的情况下每台云服务器能做的事情，部署的任务也就确定了。如果云服务器的硬件配置一般,我们可以把一部分的逻辑服(游戏分区，如新手场，高手场)部署到一台云服务器上，把另
阅读更多2024-12-29
unity3d 重要框架，如 ugui、ngui、timeline、behavior designer、urp 等
这些框架各有特点，适用于不同的场景。以下是对常见的 Unity 框架（UGUI、NGUI、Timeline、Behavior Designer、URP）的详细分析，包括涉及的知识点和代码示例。UGUI
阅读更多2024-12-29
oracle基础：理解 Oracle SQL 中的 WHERE 后的 (+) 用法
(+)在现代 SQL 开发中，建议逐步替换WHERE (+)为LEFT JOIN或RIGHT JOIN。不过，如果你正在处理遗留系统，了解这种语法的用法将帮助你更好地维护旧代码。
阅读更多2024-12-29
频域滤波器的采样点数——采样点数不是非得与图像尺寸相同
冈萨雷斯的选频滤波器认为滤波器的尺寸就得和图像尺寸相同，这个想法狭隘了。这里谈谈滤波器采样点数对滤波器的影响。滤波器的采样点数，即滤波器长度或阶数（对于二维滤波器而言是$M \times N$），对滤
阅读更多2024-12-29
Linux系统编程——线程
之前的文章中我们已经对进程相关的概念做了认识，从创建进程、子进程，进程回收、进程替换等，由于我们之前对于知识框架的不熟悉，为了方便我们的理解学习，我们在之前的学习中没有做到深挖细节和深入理解，对之前的
阅读更多2024-12-29
C++常用特性
让构造函数之间可以相互调用，避免重复的初始化逻辑。
阅读更多2024-12-29