Spring Boot 自動配置之條件註解

Spring Boot 神奇的自動配置，主要依靠大量的條件註解來使用配置自動化。

根據知足某一個特定條件建立一個特定的Bean。好比說，在某些系統變量下建立Bean，或者只有在某個Bean建立後纔去建立另一個Bean. 就是根據條件來控制Bean的建立行爲，能夠利用該特性來進行一些自動配置。

1、經常使用的條件註解

• @Conditional 依賴的條件
• @ConditionalOnBean 在某個Bean存在的條件下
• @ConditionalOnMissingBean 在某個Bean不存在的條件下
• @ConditionalOnClass 在某個Class存在的條件下
• @ConditionalOnMissingClass 在某個Class不存在的條件下

比較常見的是這些註解，還有其它的好比 @ConditionalOnWebApplication, @ConditionalOnProperty 等，可觸類旁通

2、特別說明 @Conditional 註解

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Conditional {

	/**
	 * All {@link Condition Conditions} that must {@linkplain Condition#matches match}
	 * in order for the component to be registered.
	 */
	Class<? extends Condition>[] value();

}

使用@Conditional註解，對象須要實現Condition接口，Condition 接口是一個函數式接口

@FunctionalInterface
public interface Condition {

	boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata);
}

3、條件註解示例

示例場景：項目中動態的配置Mysql或者Oracle數據源

1. 定義配置文件

db-type=oracle

2. 定義Condition類

MySqlCondition.java

public class MySqlCondition implements Condition {

    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        return "mysql".equals(context.getEnvironment().getProperty("db-type"));
    }
}

OracleCondition.java

public class OracleCondition implements Condition {

    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        return "oracle".equals(context.getEnvironment().getProperty("db-type"));
    }
}

獲取配置文件db-type的值

3. JdbcFactory接口

public interface JdbcFactory {

    void create();
}

4. 默認的Mysql和Oracle實現

Mysql

@ConditionalOnMissingBean(value = JdbcFactory.class, ignored = MySqlDefaultFactory.class)
@Conditional(MySqlCondition.class)
@Component
public class MySqlDefaultFactory implements JdbcFactory {

    @Override
    public void create() {
        System.out.println("Default MySql create ..");
    }

}

Oracle

@ConditionalOnMissingBean(value = JdbcFactory.class, ignored = OracleDefaultFactory.class)
@Conditional(OracleCondition.class)
@Component
public class OracleDefaultFactory implements JdbcFactory {

    @Override
    public void create() {
        System.out.println("Default oracle create..");
    }
}

5. 測試默認實現方式

@Resource
private JdbcFactory jdbcFactory;

@Test
public void conditionOnMissBean() {
    jdbcFactory.create();
}

結果：

Default MySql create ..

6. 自定義實現方式

@Component
public class MysqlFactory implements JdbcFactory {

    @Override
    public void create() {
        System.out.println("mysql 。。 create");
    }
}

7. 測試

@Resource
private JdbcFactory jdbcFactory;

@Test
public void conditionOnMissBean() {
    jdbcFactory.create();
}

結果：

mysql 。。 create

8.解析

當環境中不存在 JdbcFactory 的Bean時則使用默認的實現的方式，如例：沒有自定義實現時，則默認使用MySqlDefaultFactory。這在自動化配置中會常常用到。好比redisTemplate 的默認實現

4、GitHub源碼

源碼地址