Spring IoC實(shí)現(xiàn)條件化裝配Bean的方法詳解
條件化裝配 Bean(Conditional Bean Assembly) 指的是:讓 Spring 容器根據(jù)特定的條件來(lái)決定是否要?jiǎng)?chuàng)建和注冊(cè)某一個(gè) Bean。
這就像一個(gè)智能工廠的生產(chǎn)線,可以根據(jù)客戶的訂單(條件)來(lái)決定是安裝汽油引擎還是電動(dòng)機(jī)。這個(gè)機(jī)制是 Spring Boot 自動(dòng)配置(Auto-configuration)的基石。
核心武器:@Conditional 注解
所有條件化裝配都源于 Spring 4.0 引入的 @Conditional 注解。它是一個(gè)元注解,意思是它可以被用在其他注解上。
它的工作原理是:@Conditional 注解需要一個(gè) Condition 接口的實(shí)現(xiàn)類。在這個(gè)實(shí)現(xiàn)類中,你可以編寫(xiě)任意邏輯來(lái)判斷條件是否滿足。如果滿足(返回 true),則被注解的 Bean 會(huì)被創(chuàng)建;如果不滿足(返回 false),則被忽略。
// 這是一個(gè)自定義的條件
public class MyCustomCondition implements Condition {
@Override
public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
// 在這里編寫(xiě)你的判斷邏輯
// 比如,檢查某個(gè)環(huán)境變量是否存在
return System.getenv("MY_APP_MODE") != null;
}
}
// 在配置類或Bean方法上使用
@Configuration
@Conditional(MyCustomCondition.class) // <-- 只有當(dāng)條件滿足時(shí),這個(gè)配置類及其所有Bean才生效
public class MySpecialConfiguration {
@Bean
public MyService myService() {
return new MyService();
}
}
雖然 @Conditional 很強(qiáng)大,但每次都自己寫(xiě)一個(gè) Condition 類比較繁瑣。因此,Spring Boot 在此基礎(chǔ)上,提供了一套開(kāi)箱即用的、更具體的條件注解,覆蓋了 99% 的日常場(chǎng)景。
Spring Boot 提供的常用條件注解
這些注解通常用在 @Bean 方法上或 @Configuration 類上。
1. @ConditionalOnProperty (最常用)
條件:當(dāng)配置文件(application.properties 或 application.yml)中某個(gè)屬性的值滿足指定條件時(shí)。
場(chǎng)景:通過(guò)一個(gè)配置項(xiàng)來(lái)控制某個(gè)功能的開(kāi)啟或關(guān)閉。
// application.properties // a. 開(kāi)啟短信通知 notification.service.type=sms // b. 開(kāi)啟某個(gè)高級(jí)功能 feature.x.enabled=true
// 只有當(dāng) notification.service.type 的值是 "sms" 時(shí),才創(chuàng)建 SmsService 這個(gè) Bean
@Bean
@ConditionalOnProperty(name = "notification.service.type", havingValue = "sms")
public NotificationService smsService() {
return new SmsService();
}
// 只有當(dāng) feature.x.enabled 的值是 "true" 時(shí),才創(chuàng)建 FeatureX Bean
// matchIfMissing = true 表示如果配置文件里根本沒(méi)寫(xiě)這個(gè)屬性,也算作條件滿足(即默認(rèn)開(kāi)啟)
@Bean
@ConditionalOnProperty(name = "feature.x.enabled", havingValue = "true", matchIfMissing = true)
public FeatureX featureX() {
return new FeatureX();
}
2. @ConditionalOnBean 和 @ConditionalOnMissingBean
條件:當(dāng) IoC 容器中存在(或不存在)某個(gè)類型的 Bean 時(shí)。
這是實(shí)現(xiàn)“默認(rèn)實(shí)現(xiàn)”和“用戶可覆蓋”模式的利器。
場(chǎng)景:你提供一個(gè)默認(rèn)的緩存實(shí)現(xiàn)(如內(nèi)存緩存),但允許用戶自己定義一個(gè) Redis 緩存 Bean 來(lái)覆蓋它。
@Configuration
public class CacheAutoConfiguration {
// **關(guān)鍵**:只有當(dāng)容器中不存在任何 CacheService 類型的 Bean 時(shí),
// 才創(chuàng)建下面這個(gè)默認(rèn)的 InMemoryCacheService。
@Bean
@ConditionalOnMissingBean(CacheService.class)
public CacheService inMemoryCache() {
System.out.println("No custom cache found. Creating default InMemoryCache.");
return new InMemoryCacheService();
}
}
// 在用戶的配置中:
// 如果用戶自己定義了下面這個(gè) Bean...
// @Configuration
// public class MyCacheConfig {
// @Bean
// public CacheService redisCache() {
// return new RedisCacheService(); // 用戶自定義的實(shí)現(xiàn)
// }
// }
// ...那么上面的 InMemoryCacheService 就不會(huì)被創(chuàng)建。
@ConditionalOnBean 則相反,表示只有當(dāng)容器中已經(jīng)存在某個(gè) Bean 時(shí),才創(chuàng)建當(dāng)前 Bean。這常用于配置依賴于其他組件的 Bean。
3. @ConditionalOnClass 和 @ConditionalOnMissingClass
條件:當(dāng)應(yīng)用的 classpath 中存在(或不存在)某個(gè)類時(shí)。
這是編寫(xiě) starter 模塊的核心。一個(gè)功能模塊通常依賴于某些第三方庫(kù),只有當(dāng)用戶引入了這些庫(kù),相關(guān)的功能 Bean 才應(yīng)該被創(chuàng)建。
場(chǎng)景:只有當(dāng)用戶在 pom.xml 中引入了 mysql-connector-java 驅(qū)動(dòng)包時(shí),才自動(dòng)配置一個(gè) MySQL 相關(guān)的 Bean。
@Configuration
// 只有當(dāng) classpath 中能找到 "com.mysql.cj.jdbc.Driver" 這個(gè)類時(shí),
// 這個(gè)配置才會(huì)生效。
@ConditionalOnClass(name = "com.mysql.cj.jdbc.Driver")
public class MySqlRelatedConfiguration {
@Bean
public MySqlHealthIndicator mySqlHealthIndicator() {
// 創(chuàng)建一個(gè)檢查 MySQL 健康狀態(tài)的 Bean
return new MySqlHealthIndicator();
}
}
4. @ConditionalOnWebApplication 和 @ConditionalOnNotWebApplication
條件:判斷當(dāng)前應(yīng)用是否是一個(gè) Web 應(yīng)用(例如,classpath 中有 Spring MVC 或 WebFlux)。
場(chǎng)景:某些 Bean(如 Filter, Interceptor, WebMvcConfigurer)只在 Web 環(huán)境下才有意義。
@Configuration
@ConditionalOnWebApplication // 只有是Web應(yīng)用時(shí)才生效
public class WebSpecificConfig {
@Bean
public MyCustomFilter myCustomFilter() {
return new MyCustomFilter();
}
}
綜合示例:智能通知服務(wù)
假設(shè)我們要構(gòu)建一個(gè)通知服務(wù),默認(rèn)使用郵件,但如果用戶配置了短信,則優(yōu)先使用短信。
// 1. application.properties (用戶可以不配置,或配置為sms)
// notification.channel=sms
// 2. 核心配置類
@Configuration
public class NotificationAutoConfiguration {
// 方案A:如果用戶配置了短信渠道,創(chuàng)建 SmsService
@Bean
@ConditionalOnProperty(name = "notification.channel", havingValue = "sms")
public NotificationService smsNotification() {
System.out.println("Condition met: Creating SmsNotificationService.");
return new SmsNotificationService();
}
// 方案B:如果容器里還沒(méi)有任何 NotificationService 的 Bean,
// 就創(chuàng)建一個(gè)默認(rèn)的 EmailService 作為“兜底”方案。
@Bean
@ConditionalOnMissingBean(NotificationService.class)
public NotificationService emailNotification() {
System.out.println("No other NotificationService found. Creating default EmailNotificationService.");
return new EmailNotificationService();
}
}
運(yùn)行結(jié)果分析:
- 如果用戶配置
notification.channel=sms:SmsNotificationService會(huì)被創(chuàng)建。因?yàn)榇藭r(shí)容器中已經(jīng)有了NotificationService類型的 Bean,所以EmailNotificationService的@ConditionalOnMissingBean條件不滿足,它不會(huì)被創(chuàng)建。最終注入的是SmsNotificationService。 - 如果用戶沒(méi)有配置
notification.channel:SmsNotificationService的@ConditionalOnProperty條件不滿足,它不會(huì)被創(chuàng)建。此時(shí)容器中沒(méi)有任何NotificationService類型的 Bean,所以EmailNotificationService的@ConditionalOnMissingBean條件滿足,它會(huì)被創(chuàng)建。最終注入的是EmailNotificationService。
總結(jié)
| 注解 | 條件 | 主要用途 |
|---|---|---|
| @ConditionalOnProperty | 配置文件中屬性的值 | 功能開(kāi)關(guān),按配置切換實(shí)現(xiàn) |
| @ConditionalOnMissingBean | IoC 容器中缺少某個(gè) Bean | 提供可被用戶覆蓋的默認(rèn)實(shí)現(xiàn)(兜底 Bean) |
| @ConditionalOnBean | IoC 容器中存在某個(gè) Bean | 當(dāng)某個(gè)依賴準(zhǔn)備好后,才裝配當(dāng)前 Bean |
| @ConditionalOnClass | Classpath 中存在某個(gè)類 | 檢測(cè)是否引入了某個(gè)依賴庫(kù),是開(kāi)發(fā) starter 的核心 |
| @ConditionalOnWebApplication | 當(dāng)前是 Web 應(yīng)用環(huán)境 | 裝配只在 Web 環(huán)境下有意義的 Bean |
| @Conditional | 自定義 Condition 類 | 實(shí)現(xiàn)高度定制化的、復(fù)雜的判斷邏輯 |
通過(guò)靈活運(yùn)用這些條件注解,你就可以編寫(xiě)出非常智能、健壯、可插拔的模塊,這也是 Spring Boot “約定優(yōu)于配置”理念的精髓所在。
到此這篇關(guān)于Spring IoC實(shí)現(xiàn)條件化裝配Bean的步驟詳解的文章就介紹到這了,更多相關(guān)Spring IoC條件化裝配Bean內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
利用spring-data-redis實(shí)現(xiàn)incr自增的操作
這篇文章主要介紹了利用spring-data-redis實(shí)現(xiàn)incr自增的操作,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-11-11
MyBatisPlus分頁(yè)時(shí)排序的實(shí)現(xiàn)
本文主要介紹了MyBatisPlus分頁(yè)時(shí)排序的實(shí)現(xiàn),文中通過(guò)示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-03-03
java實(shí)現(xiàn)讀寫(xiě)json文件的示例詳解
隨著現(xiàn)代應(yīng)用對(duì)數(shù)據(jù)交換和配置管理需求的增加,JSON(JavaScript Object Notation)已成為最流行的數(shù)據(jù)格式之一,本文將為大家全面展示 Java 讀寫(xiě) JSON 文件的端到端流程,需要的小伙伴可以了解下2025-05-05
Java集合Map的clear與new Map區(qū)別詳解
這篇文章主要介紹了Java集合Map的clear與new Map區(qū)別詳解,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-04-04
使用HttpClient調(diào)用接口的實(shí)例講解
下面小編就為大家?guī)?lái)一篇使用HttpClient調(diào)用接口的實(shí)例講解。小編覺(jué)得挺不錯(cuò)的,現(xiàn)在就分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-10-10
java中Spring Security的實(shí)例詳解
這篇文章主要介紹了java中Spring Security的實(shí)例詳解的相關(guān)資料,spring security是一個(gè)多方面的安全認(rèn)證框架,提供了基于JavaEE規(guī)范的完整的安全認(rèn)證解決方案,需要的朋友可以參考下2017-09-09

