在 Spring 框架中，@Conditional注解是什么？它有什么用途？它是如何工作的？這篇文章，我們來(lái)聊一聊。@Conditional注解。

1. 什么是 @Conditional？

首先，我們看看@Conditional注解的源碼，截圖如下：

通過(guò)源碼可以知道：@Conditional是一個(gè)標(biāo)記注解，表示組件只有全部匹配才有資格注冊(cè)，它可以用于類(lèi)和方法級(jí)別。更具體地說(shuō)，@Conditional 允許開(kāi)發(fā)者基于特定條件來(lái)決定是否加載某個(gè) Bean或配置。它通過(guò)實(shí)現(xiàn) Condition 接口的類(lèi)來(lái)定義條件邏輯。當(dāng) Spring 容器在啟動(dòng)時(shí)解析 @Conditional 注解時(shí)，會(huì)調(diào)用對(duì)應(yīng)的 Condition 實(shí)現(xiàn)來(lái)判斷是否滿(mǎn)足加載 Bean 或配置的條件。

2. 工作原理

關(guān)于 @Conditional 的工作原理，我們可以分為三個(gè)步驟來(lái)理解：

• 注解使用：在一個(gè)配置類(lèi)、方法或者 Bean 上使用 @Conditional 注解，并指定一個(gè)或多個(gè) Condition 實(shí)現(xiàn)類(lèi)。
• 條件判斷：當(dāng) Spring 容器加載配置時(shí)，會(huì)實(shí)例化并調(diào)用指定的 Condition 類(lèi)的 matches 方法。
• 決定加載：根據(jù) matches 方法的返回值（true 或 false），決定是否加載被注解的 Bean 或配置。

為了更好地理解 @Conditional 的工作原理，我們下面將通過(guò)代碼示例來(lái)展示該注解常見(jiàn)地用法。

3. 常見(jiàn)用法

Spring 提供了多種基于不同條件的 Condition 實(shí)現(xiàn)，下面我們將從四個(gè)方面來(lái)討論。

(1) 基于操作系統(tǒng)的條件

可以根據(jù)操作系統(tǒng)類(lèi)型（如 Windows、Linux、macOS）來(lái)加載不同的 Bean。示例代碼如下：

@Configuration
@ConditionalOnOperatingSystem(OS.WINDOWS)
public class WindowsConfig {
    // Windows 專(zhuān)屬 Bean 定義
}

@Configuration
@ConditionalOnOperatingSystem(OS.MAC)
public class WindowsConfig {
    // MAC 專(zhuān)屬 Bean 定義
}

實(shí)現(xiàn)示例：

Spring 提供了內(nèi)置的 @ConditionalOnProperty、@ConditionalOnClass 等注解，但基于操作系統(tǒng)的條件通常需自定義 Condition。

(2) 基于類(lèi)存在的條件

只有當(dāng)特定的類(lèi)在類(lèi)路徑中存在時(shí)，才會(huì)加載相關(guān) Bean。這在模塊化和插件化開(kāi)發(fā)中尤為有用。

@Configuration
@ConditionalOnClass(name = "com.example.SomeClass")
public class SomeClassConfig {
    // 當(dāng) com.example.SomeClass 存在時(shí)加載的 Bean
}

Spring 提供了 @ConditionalOnClass 注解，簡(jiǎn)化了這一需求。

(3) 基于屬性的條件

可以根據(jù)配置文件中的屬性值來(lái)決定是否加載某個(gè) Bean。這在根據(jù)不同環(huán)境（開(kāi)發(fā)、測(cè)試、生產(chǎn)）配置不同 Bean 時(shí)非常有用。

@Configuration
@ConditionalOnProperty(name = "feature.enabled", havingValue = "true")
public class FeatureConfig {
    // 當(dāng) feature.enabled=true 時(shí)加載的 Bean
}

Spring 提供了 @ConditionalOnProperty 注解，方便基于屬性進(jìn)行條件化配置。

(4) 自定義條件

盡管 Spring 提供了許多內(nèi)置的條件注解，但是，有些業(yè)務(wù)需求可能需要更復(fù)雜的條件邏輯。這時(shí)，我們可以創(chuàng)建自定義的 Condition 類(lèi)。具體步驟如下：

實(shí)現(xiàn) Condition 接口：

public class MyCustomCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        // 自定義條件判斷邏輯
        // 可以基于環(huán)境變量、配置文件、類(lèi)路徑等
        return true; // 或 false
    }
}

使用 @Conditional 注解：

@Configuration
@Conditional(MyCustomCondition.class)
public class MyCustomConfig {
    // 配置 Bean
}

下面通過(guò)一個(gè)完整地例子來(lái)演示自定義條件的使用：假設(shè)我們希望只有在環(huán)境變量 MY_ENV 設(shè)置為 production 時(shí)加載某個(gè) Bean。

public class ProductionEnvironmentCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        String env = context.getEnvironment().getProperty("MY_ENV", "development");
        return"production".equalsIgnoreCase(env);
    }
}

@Configuration
@Conditional(ProductionEnvironmentCondition.class)
public class ProductionConfig {
    @Bean
    public SomeService someService() {
        returnnew ProductionSomeService();
    }
}

在上述例子中，只有當(dāng) MY_ENV=production 時(shí)，ProductionSomeService 會(huì)被加載。

(5) @Conditional系列注解

除了上面的條件之外，Spring Boot 在 spring-boot-autoconfigure 模塊中，擴(kuò)展了 @Conditional 注解，提供了一系列更具體的條件注解，簡(jiǎn)化了常見(jiàn)的條件判斷。這些注解通常以 @ConditionalOn 開(kāi)頭，如：

• @ConditionalOnClass：當(dāng)指定類(lèi)存在于類(lèi)路徑中時(shí)生效。
• @ConditionalOnMissingClass：當(dāng)指定類(lèi)不存在于類(lèi)路徑中時(shí)生效。
• @ConditionalOnBean：當(dāng)指定的 Bean 存在時(shí)生效。
• @ConditionalOnMissingBean：當(dāng)指定的 Bean 不存在時(shí)生效。
• @ConditionalOnProperty：當(dāng)指定的屬性滿(mǎn)足條件時(shí)生效。
• @ConditionalOnResource：當(dāng)指定的資源存在時(shí)生效。
• @ConditionalOnWebApplication：僅在 Web 應(yīng)用環(huán)境中生效。
• @ConditionalOnNotWebApplication：僅在非 Web 應(yīng)用環(huán)境中生效。

4. 注意事項(xiàng)

上面，我們完整了分析了 @Conditional 注解，在使用該注解時(shí)，我們同時(shí)需要關(guān)注一些注意事項(xiàng)，這里總結(jié)了四點(diǎn)：

• 條件優(yōu)先級(jí)：多個(gè)條件注解疊加時(shí)，它們的邏輯關(guān)系是“與”（AND）。即所有條件都滿(mǎn)足，配置才會(huì)生效。
• 作用范圍：@Conditional 可以用于類(lèi)級(jí)別、方法級(jí)別或?qū)傩约?jí)別。不同的應(yīng)用場(chǎng)景可能需要不同的使用方式。
• 性能考慮：復(fù)雜的條件實(shí)現(xiàn)可能影響應(yīng)用啟動(dòng)時(shí)間，尤其是在啟動(dòng)時(shí)需要進(jìn)行大量邏輯判斷的情況下。
• 可讀性和維護(hù)性：過(guò)多或過(guò)于復(fù)雜的條件邏輯可能導(dǎo)致配置難以理解和維護(hù)。建議在必要時(shí)使用，并保持條件邏輯的清晰和簡(jiǎn)單。

5. 總結(jié)

本文，我們?nèi)娣治隽薂Conditional注解的原理以及如何使用它，在 Spring生態(tài)系統(tǒng)中，@Conditional注解扮演著至關(guān)重要的角色，因此，作為一個(gè)Java程序員，要想更深層次的理解 Spring，強(qiáng)烈建議掌握該注解。