SpringBoot中動(dòng)態(tài)數(shù)據(jù)源配置與使用詳解
在現(xiàn)代應(yīng)用中,處理多數(shù)據(jù)源是常見(jiàn)的需求??赡苡捎跇I(yè)務(wù)需要,或者為了實(shí)現(xiàn)讀寫(xiě)分離,我們往往需要在同一個(gè)應(yīng)用中配置多個(gè)數(shù)據(jù)源,并根據(jù)具體的操作選擇不同的數(shù)據(jù)源。在 Spring Boot 中,這樣的需求可以通過(guò)動(dòng)態(tài)數(shù)據(jù)源來(lái)輕松實(shí)現(xiàn)。本篇博客將詳細(xì)介紹如何在 Spring Boot 中配置和使用動(dòng)態(tài)數(shù)據(jù)源,并演示如何切換到指定的數(shù)據(jù)源。
一、為什么要使用動(dòng)態(tài)數(shù)據(jù)源?
業(yè)務(wù)隔離:在一些復(fù)雜的業(yè)務(wù)場(chǎng)景中,不同的模塊可能需要連接不同的數(shù)據(jù)庫(kù)。通過(guò)動(dòng)態(tài)數(shù)據(jù)源配置,可以在同一個(gè)應(yīng)用中隔離這些不同的數(shù)據(jù)庫(kù)訪(fǎng)問(wèn)。
讀寫(xiě)分離:為了提升系統(tǒng)的性能,通常會(huì)將讀寫(xiě)操作分離到不同的數(shù)據(jù)庫(kù)上。比如,將寫(xiě)操作放在主數(shù)據(jù)庫(kù),而讀操作放在從數(shù)據(jù)庫(kù)上。
數(shù)據(jù)庫(kù)遷移:在系統(tǒng)遷移期間,可能需要在兩個(gè)數(shù)據(jù)庫(kù)之間切換,從而確保遷移的平穩(wěn)進(jìn)行。
二、Spring Boot 中的多數(shù)據(jù)源配置
我們將通過(guò)一個(gè)示例來(lái)介紹如何在 Spring Boot 中配置和使用動(dòng)態(tài)數(shù)據(jù)源。假設(shè)我們有兩個(gè)數(shù)據(jù)源,一個(gè)是 master,另一個(gè)是 adcontrol。master 數(shù)據(jù)源主要用于主業(yè)務(wù)數(shù)據(jù)庫(kù),而 adcontrol 數(shù)據(jù)源用于廣告控制的相關(guān)數(shù)據(jù)存儲(chǔ)。
1. 數(shù)據(jù)源配置
首先,我們需要在 application.yml 文件中配置兩個(gè)數(shù)據(jù)源。
datasource: dynamic: primary: master # 默認(rèn)使用master庫(kù) strict: false # 不使用嚴(yán)格模式 datasource: master: url: jdbc:mysql://127.0.0.1:3306/test?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useSSL=false username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver hikari: connection-timeout: 30000 max-lifetime: 1800000 max-pool-size: 15 min-idle: 5 connection-test-query: select 1 pool-name: YsxHikariCP adcontrol: url: jdbc:mysql://ip:3306/test2?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useSSL=false username: test password: test driver-class-name: com.mysql.cj.jdbc.Driver
上述配置中,master 數(shù)據(jù)源是默認(rèn)使用的數(shù)據(jù)源,而 adcontrol 數(shù)據(jù)源是備用的廣告控制數(shù)據(jù)源。
2. 引入動(dòng)態(tài)數(shù)據(jù)源依賴(lài)
為了讓 Spring Boot 能夠識(shí)別和使用這些動(dòng)態(tài)數(shù)據(jù)源,我們需要引入動(dòng)態(tài)數(shù)據(jù)源的依賴(lài)庫(kù)。這里我們使用 dynamic-datasource-spring-boot-starter 這個(gè)開(kāi)源庫(kù)。
在 pom.xml 中添加如下依賴(lài):
<dependency> <groupId>com.github.dynamic-datasource</groupId> <artifactId>dynamic-datasource-spring-boot-starter</artifactId> <version>3.2.1</version> <!-- 確保使用合適的版本 --> </dependency>
3. 配置動(dòng)態(tài)數(shù)據(jù)源
通過(guò) DynamicDataSource
,我們可以在應(yīng)用中靈活切換數(shù)據(jù)源。下面是一個(gè)簡(jiǎn)單的 DynamicDataSource
配置示例:
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import com.github.dynamic.datasource.DynamicRoutingDataSource; import javax.sql.DataSource; import org.springframework.boot.autoconfigure.jdbc.DataSourceBuilder; import java.util.HashMap; import java.util.Map; @Configuration public class DataSourceConfig { @Bean public DataSource dataSource() { DynamicRoutingDataSource dataSource = new DynamicRoutingDataSource(); // 配置主數(shù)據(jù)源 DataSource masterDataSource = DataSourceBuilder.create() .url("jdbc:mysql://127.0.0.1:3306/test1?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useSSL=false") .username("root") .password("123456") .driverClassName("com.mysql.cj.jdbc.Driver") .build(); // 配置廣告控制數(shù)據(jù)源 DataSource adcontrolDataSource = DataSourceBuilder.create() .url("jdbc:mysql://ip1:3306/test2?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useSSL=false") .username("test") .password("test") .driverClassName("com.mysql.cj.jdbc.Driver") .build(); // 將數(shù)據(jù)源放入Map Map<Object, Object> dataSourceMap = new HashMap<>(); dataSourceMap.put("master", masterDataSource); dataSourceMap.put("adcontrol", adcontrolDataSource); dataSource.setDefaultTargetDataSource(masterDataSource); dataSource.setTargetDataSources(dataSourceMap); return dataSource; } }
4. 使用 @DS 注解動(dòng)態(tài)切換數(shù)據(jù)源
在服務(wù)層,我們可以通過(guò) @DS
注解來(lái)指定當(dāng)前方法應(yīng)該使用哪個(gè)數(shù)據(jù)源。例如:
import com.github.dynamic.datasource.annotation.DS; import org.springframework.stereotype.Service; @Service public class MyService { @DS("adcontrol") public void handleAdControlLogic() { // 使用adcontrol數(shù)據(jù)源執(zhí)行操作 } @DS("master") public void handleMasterLogic() { // 使用master數(shù)據(jù)源執(zhí)行操作 } }
通過(guò) @DS
注解,我們可以在方法層面靈活切換數(shù)據(jù)源,確保不同的業(yè)務(wù)邏輯使用正確的數(shù)據(jù)庫(kù)連接。
三、異常處理與回滾
在使用多個(gè)數(shù)據(jù)源時(shí),處理好事務(wù)和異常非常重要。如果在一個(gè)事務(wù)內(nèi)執(zhí)行了多個(gè)數(shù)據(jù)源的操作,那么事務(wù)的管理和異常處理就變得尤為關(guān)鍵。
Spring 提供了全局事務(wù)管理器的支持,可以配置為管理多個(gè)數(shù)據(jù)源的事務(wù)。但是在使用 dynamic-datasource 時(shí),要特別注意確保在同一個(gè)事務(wù)中操作的多個(gè)數(shù)據(jù)源能夠正確地提交或回滾。
例如:
import org.springframework.transaction.annotation.Transactional; @Service public class MyService { @Transactional @DS("master") public void processTransaction() { try { // 操作master數(shù)據(jù)庫(kù) handleMasterLogic(); // 切換到adcontrol數(shù)據(jù)源 handleAdControlLogic(); } catch (Exception e) { // 處理異常,可能需要回滾事務(wù) throw new RuntimeException("事務(wù)失敗,進(jìn)行回滾", e); } } @DS("adcontrol") public void handleAdControlLogic() { // 操作adcontrol數(shù)據(jù)庫(kù) } @DS("master") public void handleMasterLogic() { // 操作master數(shù)據(jù)庫(kù) } }
在上面的代碼中,如果 handleAdControlLogic
方法拋出了異常,那么整個(gè)事務(wù)將被回滾。
四、常見(jiàn)問(wèn)題與解決方案
數(shù)據(jù)源切換失敗
- 確保
@DS
注解指向的名稱(chēng)與配置中的數(shù)據(jù)源名稱(chēng)完全一致。 - 檢查
DynamicDataSource
是否正確配置。
- 確保
事務(wù)回滾失敗
- 確保在同一個(gè)事務(wù)中使用的所有數(shù)據(jù)源都支持事務(wù)管理。
- 使用
@Transactional
注解來(lái)管理事務(wù)。
性能問(wèn)題
- 動(dòng)態(tài)數(shù)據(jù)源切換可能會(huì)帶來(lái)額外的性能開(kāi)銷(xiāo)。可以考慮使用連接池優(yōu)化數(shù)據(jù)庫(kù)連接管理。
無(wú)法連接數(shù)據(jù)庫(kù)
- 檢查數(shù)據(jù)庫(kù)連接配置,確保
url
、username
和password
等參數(shù)正確。 - 檢查數(shù)據(jù)庫(kù)服務(wù)器是否可達(dá)。
- 檢查數(shù)據(jù)庫(kù)連接配置,確保
五、總結(jié)
通過(guò)動(dòng)態(tài)數(shù)據(jù)源配置,Spring Boot 應(yīng)用可以輕松應(yīng)對(duì)多數(shù)據(jù)源的復(fù)雜需求。無(wú)論是業(yè)務(wù)隔離、讀寫(xiě)分離,還是數(shù)據(jù)庫(kù)遷移,動(dòng)態(tài)數(shù)據(jù)源都能夠提供靈活且高效的解決方案。
在實(shí)際應(yīng)用中,合理規(guī)劃和使用多數(shù)據(jù)源,可以顯著提升系統(tǒng)的可擴(kuò)展性和可靠性。在實(shí)現(xiàn)過(guò)程中,需要特別注意事務(wù)管理和異常處理,以確保數(shù)據(jù)的一致性和完整性。
通過(guò)本文的介紹,相信你已經(jīng)掌握了在 Spring Boot 中配置和使用動(dòng)態(tài)數(shù)據(jù)源的基本方法。在實(shí)際項(xiàng)目中,可以根據(jù)業(yè)務(wù)需求,進(jìn)一步優(yōu)化和擴(kuò)展動(dòng)態(tài)數(shù)據(jù)源的使用。希望本文能對(duì)你有所幫助。
以上就是SpringBoot中動(dòng)態(tài)數(shù)據(jù)源配置與使用詳解的詳細(xì)內(nèi)容,更多關(guān)于SpringBoot動(dòng)態(tài)數(shù)據(jù)源的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
- SpringBoot配置動(dòng)態(tài)數(shù)據(jù)源的實(shí)戰(zhàn)詳解
- SpringBoot自定義動(dòng)態(tài)數(shù)據(jù)源的流程步驟
- SpringBoot實(shí)現(xiàn)動(dòng)態(tài)數(shù)據(jù)源切換的項(xiàng)目實(shí)踐
- SpringBoot動(dòng)態(tài)數(shù)據(jù)源連接測(cè)試的操作詳解
- SpringBoot實(shí)現(xiàn)動(dòng)態(tài)數(shù)據(jù)源切換的方法總結(jié)
- springboot配置多數(shù)據(jù)源(靜態(tài)和動(dòng)態(tài)數(shù)據(jù)源)
- SpringBoot中動(dòng)態(tài)數(shù)據(jù)源是實(shí)現(xiàn)與用途
- springboot 動(dòng)態(tài)數(shù)據(jù)源的實(shí)現(xiàn)方法(Mybatis+Druid)
- springboot動(dòng)態(tài)數(shù)據(jù)源+分布式事務(wù)的實(shí)現(xiàn)
相關(guān)文章
使用Spring框架實(shí)現(xiàn)用戶(hù)登錄
這篇文章主要為大家詳細(xì)介紹了使用Spring框架實(shí)現(xiàn)用戶(hù)登錄,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-09-09Java基于SpringBoot和tk.mybatis實(shí)現(xiàn)事務(wù)讀寫(xiě)分離代碼實(shí)例
這篇文章主要介紹了Java基于SpringBoot和tk.mybatis實(shí)現(xiàn)事務(wù)讀寫(xiě)分離代碼實(shí)例,讀寫(xiě)分離,基本的原理是讓主數(shù)據(jù)庫(kù)處理事務(wù)性增、改、刪操作,而從數(shù)據(jù)庫(kù)處理SELECT查詢(xún)操作,數(shù)據(jù)庫(kù)復(fù)制被用來(lái)把事務(wù)性操作導(dǎo)致的變更同步到集群中的從數(shù)據(jù)庫(kù),需要的朋友可以參考下2023-10-10Spring Boot統(tǒng)一異常處理最佳實(shí)踐(拓展篇)
這篇文章主要給大家介紹了關(guān)于Spring Boot統(tǒng)一異常處理最佳實(shí)踐(拓展篇)的相關(guān)資料,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-02-02Google?Kaptcha驗(yàn)證碼生成的使用實(shí)例說(shuō)明
這篇文章主要為大家介紹了Google?Kaptcha驗(yàn)證碼的使用實(shí)例說(shuō)明,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-03-03java基于Des對(duì)稱(chēng)加密算法實(shí)現(xiàn)的加密與解密功能詳解
這篇文章主要介紹了java基于Des對(duì)稱(chēng)加密算法實(shí)現(xiàn)的加密與解密功能,結(jié)合實(shí)例形式詳細(xì)分析了Des加密算法的功能、原理、使用方法與相關(guān)注意事項(xiàng),需要的朋友可以參考下2017-01-01intelliJ IDEA 多行選中相同內(nèi)容的快捷鍵分享
這篇文章主要介紹了intelliJ IDEA 多行選中相同內(nèi)容的快捷鍵分享,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2021-02-02