SpringBoot中的@Conditional?注解的使用

更新時間：2024年01月29日 09:05:32 作者：roseduan

@Conditional是Spring4新提供的注解，它的作用是按照一定的條件進行判斷，滿足條件的才給容器注冊Bean，本文主要介紹了SpringBoot中的@Conditional?注解的使用

概述

Spring boot 中的 @Conditional 注解是一個不太常用到的注解，但確實非常的有用，我們知道 Spring Boot 是根據(jù)配置文件中的內(nèi)容，決定是否創(chuàng)建 bean，以及如何創(chuàng)建 bean 到 Spring 容器中，而 Spring boot 自動化配置的核心控制，就是 @Conditional 注解。

@Conditional 注解是 Spring 4.0 之后出的一個注解，與其搭配的一個接口是 Condition，@Conditional 注解會根據(jù)具體的條件決定是否創(chuàng)建 bean 到容器中，接下來看看 @Conditional 注解的簡單使用。

1. @Conditional 和 Condition 接口搭配使用

這里需要實現(xiàn)的功能是，我們根據(jù)配置文件中的具體內(nèi)容，來決定是否創(chuàng)建 bean，首先我們在 application.yml 中加上一個自定義配置：

在這里插入圖片描述

這里我們決定，這個配置中包含了 product 這個字符串的時候，才創(chuàng)建 bean。Product 是我自己隨便創(chuàng)建的一個實體類，你可以自行創(chuàng)建。

新建一個類 ProductCondition，內(nèi)容如下：

public class ProductCondition implements Condition {
    @Override
    public boolean matches(ConditionContext conditionContext, AnnotatedTypeMetadata annotatedTypeMetadata) {
        //從配置文件中獲取屬性
        String property = conditionContext.getEnvironment().getProperty("create.bean");
        if (property != null){
            return property.contains("product");
        }
        else {
            return false;
        }
    }
}

這個類實現(xiàn)了 Condition 接口，這個接口只有一個方法，我們從配置文件中獲取剛才創(chuàng)建的自定義配置，如果配置中包含了 product 這個字符串，就會返回 true。

接下來創(chuàng)建一個配置類 ProductConfig，內(nèi)容如下：

@Configuration
public class ProductConfig {

    @Conditional(ProductCondition.class)
    @Bean(name = "product")
    public Product createProd(){
        return Product.builder().id(12312).categoryId(12).
                productName("Mac Book Pro").productImg("prod.png")
                .productPrice(18000).build();
    }
}

我們在創(chuàng)建的 bean 方法前面加上了 @Conditional 注解，判斷的標準是剛才的 ProductCondition，如果是 true，則創(chuàng)建 bean，否則不創(chuàng)建。我們寫一個測試類，來測試一下 bean 是否被創(chuàng)建了。測試代碼如下：

@Slf4j
@SpringBootTest
@RunWith(SpringRunner.class)
public class ProductConfigTest {

    @Test
    public void createProd() {
        try {
            Product product = SpringContextUtil.getBean("product", Product.class);
            if (product != null){
                System.out.println("創(chuàng)建了 bean : " + product.toString());
            }
        }
        catch (Exception e){
            log.info("發(fā)生異常，{}", e.getMessage());
            System.out.println("沒有創(chuàng)建 bean");
        }

    }
}

運行測試代碼，發(fā)現(xiàn) bean 已經(jīng)創(chuàng)建了：

在這里插入圖片描述

如果把 application.yml 中的配置改一下，不包含 product 這個字符串，那么返回的是 false，bean 則不會被創(chuàng)建，你可以試一下。

2. @ConditionalOnClass 的使用

這個注解的屬性可以跟上一個類的完整路徑或者是類的 Class 對象，如果類存在，則會創(chuàng)建 bean，例如下面的例子：

@Configuration
public class ProductConfig {

    @ConditionalOnClass(name = "com.roseduan.demo.entity.Product")
    @Bean(name = "product")
    public Product createProd(){

        return Product.builder().id(12312).categoryId(12).
                productName("Mac Book Pro").productImg("prod.png")
                .productPrice(18000).build();
    }
}

這個路徑下面的實體類 Product 是存在的，所以會創(chuàng)建 bean，如果是一個不存在的類，則不會創(chuàng)建。

3. @ConditionalOnProperty 的使用

這個注解可以直接從配置文件中獲取屬性，然后做為是否創(chuàng)建 bean 的依據(jù)。例如我們在 application.yml 中添加一個自定義配置：

在這里插入圖片描述

ProductConfig 類的內(nèi)容是這樣的：

@Configuration
public class ProductConfig {

    @ConditionalOnProperty(value = "create.product.bean")
    @Bean(name = "product")
    public Product createProd(){

        return Product.builder().id(12312).categoryId(12).
                productName("Mac Book Pro").productImg("prod.png")
                .productPrice(18000).build();
    }
}

這里使用了 @ConditionalOnProperty 注解，從文件中讀取配置，因為我們設置的是 true，所以這個 bean 會被創(chuàng)建，如果設置成 false，則 bean 不會被創(chuàng)建，你可以自己試一下。根據(jù)這個特性，我們可以給一些特定的配置加上一個開關(guān)，非常方便控制。

4.@Conditional 的實現(xiàn)子注解

springboot 提供了大量的 @Conditional 子注解供我們使用，我們只需知道有哪些常用的子注解供我們使用即可。
springboot 提供的 @Conditional 子注解有：

@ConditionalOnBean
@ConditionalOnClass
@ConditionalOnCloudPlatform
@ConditionalOnExpression
@ConditionalOnJava
@ConditionalOnJndi
@ConditionalOnMissingBean
@ConditionalOnMissingClass
@ConditionalOnNotWebApplication
@ConditionalOnProperty
@ConditionalOnResource
@ConditionalOnSingleCandidate
@ConditionalOnWarDeployment
@ConditionalOnWebApplication
這些子注解是如何實現(xiàn)的呢？我們以 @ConditionalOnBean 注解為例看下源碼：

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional({OnBeanCondition.class})
public @interface ConditionalOnBean {
    Class<?>[] value() default {};

    String[] type() default {};

    Class<? extends Annotation>[] annotation() default {};

    String[] name() default {};

    SearchStrategy search() default SearchStrategy.ALL;

    Class<?>[] parameterizedContainer() default {};
}

可以看到 OnBeanCondition 是 Condition 接口的具體實現(xiàn)類。
我們挑選一些日常常用的子注解做具體的說明。

這里我只是列舉了幾個常用的注解，你可以查看官方文檔，里面有更詳細的說明：

參考文檔：官網(wǎng)文檔

到此這篇關(guān)于SpringBoot中的@Conditional 注解的使用的文章就介紹到這了,更多相關(guān)SpringBoot @Conditional注解內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: