编辑“︁Spring条件装配”︁（章节）

= Spring条件装配 =

== 概述 ==
'''Spring条件装配'''（Conditional Bean Registration）是Spring Framework 4.0引入的核心特性，允许开发者根据特定条件动态控制Bean的注册行为。通过条件装配，可以实现：
* 环境适配（如开发/生产环境配置切换）
* 类路径依赖检测
* 系统属性判断
* 自定义条件逻辑

条件装配通过<code>@Conditional</code>注解实现，其核心接口为<code>Condition</code>，Spring Boot进一步扩展了此机制，提供了<code>@ConditionalOnClass</code>、<code>@ConditionalOnProperty</code>等便捷注解。

== 核心机制 ==

=== 基础接口 ===
Spring条件装配的核心接口位于<code>org.springframework.context.annotation</code>包中：

<syntaxhighlight lang="java">
public interface Condition {
    boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata);
}
</syntaxhighlight>

当<code>matches()</code>返回<code>true</code>时，关联的Bean才会被注册。

=== 工作流程 ===
<mermaid>
graph TD
    A[解析@Conditional注解] --> B[获取Condition实现类]
    B --> C[调用matches方法]
    C -->|true| D[注册Bean]
    C -->|false| E[跳过注册]
</mermaid>

== 使用方式 ==

=== 1. 基本条件装配 ===
示例：仅当系统属性"mode=prod"时注册Bean

<syntaxhighlight lang="java">
public class ProductionCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        return "prod".equals(context.getEnvironment().getProperty("mode"));
    }
}

@Configuration
public class AppConfig {
    @Bean
    @Conditional(ProductionCondition.class)
    public DataSource productionDataSource() {
        return new HikariDataSource();
    }
}
</syntaxhighlight>

=== 2. Spring Boot条件注解 ===
Spring Boot提供了更便捷的条件注解：

<syntaxhighlight lang="java">
@Configuration
public class CacheConfig {
    
    @Bean
    @ConditionalOnClass(RedisClient.class)
    public RedisCacheService redisCache() {
        return new RedisCacheService();
    }
    
    @Bean
    @ConditionalOnMissingClass("com.redis.RedisClient")
    public LocalCacheService localCache() {
        return new LocalCacheService();
    }
}
</syntaxhighlight>

常用Spring Boot条件注解：
* <code>@ConditionalOnProperty</code> - 根据配置属性判断
* <code>@ConditionalOnBean</code> - 根据已存在Bean判断
* <code>@ConditionalOnWebApplication</code> - Web环境判断
* <code>@ConditionalOnExpression</code> - SpEL表达式判断

== 进阶应用 ==

=== 组合条件 ===
通过<code>@Conditional</code>实现AND逻辑：

<syntaxhighlight lang="java">
public class AllConditions implements Condition {
    private final Condition[] conditions;
    
    public AllConditions(Condition... conditions) {
        this.conditions = conditions;
    }
    
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        return Arrays.stream(conditions)
                   .allMatch(condition -> condition.matches(context, metadata));
    }
}
</syntaxhighlight>

=== 条件元数据 ===
通过<code>AnnotatedTypeMetadata</code>访问注解属性：

<syntaxhighlight lang="java">
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Conditional(OnServiceCondition.class)
public @interface ConditionalOnService {
    String value();
}

public class OnServiceCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        Map<String, Object> attributes = metadata.getAnnotationAttributes(
            ConditionalOnService.class.getName());
        String serviceName = (String) attributes.get("value");
        // 检查服务是否可用...
    }
}
</syntaxhighlight>

== 实际案例 ==

=== 多环境配置 ===
根据不同环境加载不同的数据源配置：

<syntaxhighlight lang="java">
@Configuration
public class DataSourceConfig {
    
    @Bean
    @ConditionalOnProperty(name = "env", havingValue = "dev")
    public DataSource devDataSource() {
        return new EmbeddedDatabaseBuilder()
            .setType(EmbeddedDatabaseType.H2)
            .build();
    }
    
    @Bean
    @ConditionalOnProperty(name = "env", havingValue = "prod")
    public DataSource prodDataSource() {
        return DataSourceBuilder.create()
            .url("jdbc:mysql://prod-db:3306/app")
            .username("prod_user")
            .password("securePass123")
            .build();
    }
}
</syntaxhighlight>

=== 功能开关 ===
实现基于配置的功能开关：

<syntaxhighlight lang="java">
@Configuration
public class FeatureConfig {
    
    @Bean
    @ConditionalOnProperty(
        value = "features.analytics.enabled", 
        havingValue = "true", 
        matchIfMissing = false)
    public AnalyticsService analyticsService() {
        return new GoogleAnalyticsService();
    }
}
</syntaxhighlight>

== 数学表达 ==
条件概率在配置决策中的应用：

<math>
P(Bean_{reg}|Condition_{true}) = 1
</math>
<math>
P(Bean_{reg}|Condition_{false}) = 0
</math>

== 最佳实践 ==
1. 优先使用Spring Boot提供的条件注解
2. 复杂条件逻辑应封装为独立<code>Condition</code>实现
3. 避免条件冲突（多个条件匹配同一Bean）
4. 在<code>@Configuration</code>类上使用条件注解可控制整个配置类的加载
5. 使用<code>spring-boot-autoconfigure</code>作为条件注解设计参考

== 常见问题 ==
'''Q: 条件注解与@Profile有什么区别？'''
A: <code>@Profile</code>是特殊的条件实现，仅基于spring.profiles.active判断，而条件注解更灵活，可以处理任意条件逻辑。

'''Q: 如何调试条件装配失败？'''
A: 启动时添加<code>-Ddebug</code>参数，Spring Boot会输出详细的条件评估报告。

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring Ioc容器]]