SpringBoot中動態(tài)數(shù)據(jù)源配置與使用詳解
在現(xiàn)代應(yīng)用中,處理多數(shù)據(jù)源是常見的需求??赡苡捎跇I(yè)務(wù)需要,或者為了實現(xiàn)讀寫分離,我們往往需要在同一個應(yīng)用中配置多個數(shù)據(jù)源,并根據(jù)具體的操作選擇不同的數(shù)據(jù)源。在 Spring Boot 中,這樣的需求可以通過動態(tài)數(shù)據(jù)源來輕松實現(xiàn)。本篇博客將詳細介紹如何在 Spring Boot 中配置和使用動態(tài)數(shù)據(jù)源,并演示如何切換到指定的數(shù)據(jù)源。
一、為什么要使用動態(tài)數(shù)據(jù)源?
業(yè)務(wù)隔離:在一些復(fù)雜的業(yè)務(wù)場景中,不同的模塊可能需要連接不同的數(shù)據(jù)庫。通過動態(tài)數(shù)據(jù)源配置,可以在同一個應(yīng)用中隔離這些不同的數(shù)據(jù)庫訪問。
讀寫分離:為了提升系統(tǒng)的性能,通常會將讀寫操作分離到不同的數(shù)據(jù)庫上。比如,將寫操作放在主數(shù)據(jù)庫,而讀操作放在從數(shù)據(jù)庫上。
數(shù)據(jù)庫遷移:在系統(tǒng)遷移期間,可能需要在兩個數(shù)據(jù)庫之間切換,從而確保遷移的平穩(wěn)進行。
二、Spring Boot 中的多數(shù)據(jù)源配置
我們將通過一個示例來介紹如何在 Spring Boot 中配置和使用動態(tài)數(shù)據(jù)源。假設(shè)我們有兩個數(shù)據(jù)源,一個是 master,另一個是 adcontrol。master 數(shù)據(jù)源主要用于主業(yè)務(wù)數(shù)據(jù)庫,而 adcontrol 數(shù)據(jù)源用于廣告控制的相關(guān)數(shù)據(jù)存儲。
1. 數(shù)據(jù)源配置
首先,我們需要在 application.yml 文件中配置兩個數(shù)據(jù)源。
datasource: dynamic: primary: master # 默認使用master庫 strict: false # 不使用嚴格模式 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ù)源是默認使用的數(shù)據(jù)源,而 adcontrol 數(shù)據(jù)源是備用的廣告控制數(shù)據(jù)源。
2. 引入動態(tài)數(shù)據(jù)源依賴
為了讓 Spring Boot 能夠識別和使用這些動態(tài)數(shù)據(jù)源,我們需要引入動態(tài)數(shù)據(jù)源的依賴庫。這里我們使用 dynamic-datasource-spring-boot-starter 這個開源庫。
在 pom.xml 中添加如下依賴:
<dependency> <groupId>com.github.dynamic-datasource</groupId> <artifactId>dynamic-datasource-spring-boot-starter</artifactId> <version>3.2.1</version> <!-- 確保使用合適的版本 --> </dependency>
3. 配置動態(tài)數(shù)據(jù)源
通過 DynamicDataSource
,我們可以在應(yīng)用中靈活切換數(shù)據(jù)源。下面是一個簡單的 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 注解動態(tài)切換數(shù)據(jù)源
在服務(wù)層,我們可以通過 @DS
注解來指定當(dāng)前方法應(yīng)該使用哪個數(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í)行操作 } }
通過 @DS
注解,我們可以在方法層面靈活切換數(shù)據(jù)源,確保不同的業(yè)務(wù)邏輯使用正確的數(shù)據(jù)庫連接。
三、異常處理與回滾
在使用多個數(shù)據(jù)源時,處理好事務(wù)和異常非常重要。如果在一個事務(wù)內(nèi)執(zhí)行了多個數(shù)據(jù)源的操作,那么事務(wù)的管理和異常處理就變得尤為關(guān)鍵。
Spring 提供了全局事務(wù)管理器的支持,可以配置為管理多個數(shù)據(jù)源的事務(wù)。但是在使用 dynamic-datasource 時,要特別注意確保在同一個事務(wù)中操作的多個數(shù)據(jù)源能夠正確地提交或回滾。
例如:
import org.springframework.transaction.annotation.Transactional; @Service public class MyService { @Transactional @DS("master") public void processTransaction() { try { // 操作master數(shù)據(jù)庫 handleMasterLogic(); // 切換到adcontrol數(shù)據(jù)源 handleAdControlLogic(); } catch (Exception e) { // 處理異常,可能需要回滾事務(wù) throw new RuntimeException("事務(wù)失敗,進行回滾", e); } } @DS("adcontrol") public void handleAdControlLogic() { // 操作adcontrol數(shù)據(jù)庫 } @DS("master") public void handleMasterLogic() { // 操作master數(shù)據(jù)庫 } }
在上面的代碼中,如果 handleAdControlLogic
方法拋出了異常,那么整個事務(wù)將被回滾。
四、常見問題與解決方案
數(shù)據(jù)源切換失敗
- 確保
@DS
注解指向的名稱與配置中的數(shù)據(jù)源名稱完全一致。 - 檢查
DynamicDataSource
是否正確配置。
- 確保
事務(wù)回滾失敗
- 確保在同一個事務(wù)中使用的所有數(shù)據(jù)源都支持事務(wù)管理。
- 使用
@Transactional
注解來管理事務(wù)。
性能問題
- 動態(tài)數(shù)據(jù)源切換可能會帶來額外的性能開銷。可以考慮使用連接池優(yōu)化數(shù)據(jù)庫連接管理。
無法連接數(shù)據(jù)庫
- 檢查數(shù)據(jù)庫連接配置,確保
url
、username
和password
等參數(shù)正確。 - 檢查數(shù)據(jù)庫服務(wù)器是否可達。
- 檢查數(shù)據(jù)庫連接配置,確保
五、總結(jié)
通過動態(tài)數(shù)據(jù)源配置,Spring Boot 應(yīng)用可以輕松應(yīng)對多數(shù)據(jù)源的復(fù)雜需求。無論是業(yè)務(wù)隔離、讀寫分離,還是數(shù)據(jù)庫遷移,動態(tài)數(shù)據(jù)源都能夠提供靈活且高效的解決方案。
在實際應(yīng)用中,合理規(guī)劃和使用多數(shù)據(jù)源,可以顯著提升系統(tǒng)的可擴展性和可靠性。在實現(xiàn)過程中,需要特別注意事務(wù)管理和異常處理,以確保數(shù)據(jù)的一致性和完整性。
通過本文的介紹,相信你已經(jīng)掌握了在 Spring Boot 中配置和使用動態(tài)數(shù)據(jù)源的基本方法。在實際項目中,可以根據(jù)業(yè)務(wù)需求,進一步優(yōu)化和擴展動態(tài)數(shù)據(jù)源的使用。希望本文能對你有所幫助。
以上就是SpringBoot中動態(tài)數(shù)據(jù)源配置與使用詳解的詳細內(nèi)容,更多關(guān)于SpringBoot動態(tài)數(shù)據(jù)源的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
解決SpringBoot配置文件項目重啟出現(xiàn)亂碼的問題
最近在創(chuàng)建了SpringBoot項目后往配置文件中寫了相關(guān)的系統(tǒng)配置,并且在上面加了中文注釋,但是在重啟項目或開機重啟后遇到了注釋亂碼的情況,下面這篇文章主要給大家介紹一下如何解決SpringBoot配置文件項目重啟出現(xiàn)亂碼的問題,需要的朋友可以參考下2023-06-06Spring?Boot?Shiro?auto-configure工作流程詳解
這篇文章主要為大家介紹了Spring?Boot?Shiro?auto-configure工作流程詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2023-02-02java數(shù)據(jù)結(jié)構(gòu)和算法之馬踏棋盤算法
這篇文章主要為大家詳細介紹了java數(shù)據(jù)結(jié)構(gòu)和算法之馬踏棋盤算法,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2022-02-02Java實現(xiàn)的具有GUI的校園導(dǎo)航系統(tǒng)的完整代碼
這篇文章主要介紹了Java實現(xiàn)的具有GUI的校園導(dǎo)航系統(tǒng)的完整代碼,本文給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2021-04-04手把手帶你掌握SpringBoot RabbitMQ延遲隊列
RabbitMQ 是一個由Erlang語言開發(fā)的AMQP的開源實現(xiàn),支持多種客戶端。用于在分布式系統(tǒng)中存儲轉(zhuǎn)發(fā)消息,在易用性、擴展性、高可用性等方面表現(xiàn)不俗,下文將帶你深入了解 RabbitMQ 延遲隊列2021-09-09JAVA不可變類(immutable)機制與String的不可變性(推薦)
這篇文章主要介紹了JAVA不可變類(immutable)機制與String的不可變性(推薦)的相關(guān)資料,非常不錯,具有參考借鑒價值,需要的朋友可以參考下2016-08-08