SpringBoot中動(dòng)態(tài)數(shù)據(jù)源配置與使用詳解
在現(xiàn)代應(yīng)用中,處理多數(shù)據(jù)源是常見的需求??赡苡捎跇I(yè)務(wù)需要,或者為了實(shí)現(xiàn)讀寫分離,我們往往需要在同一個(gè)應(yīng)用中配置多個(gè)數(shù)據(jù)源,并根據(jù)具體的操作選擇不同的數(shù)據(jù)源。在 Spring Boot 中,這樣的需求可以通過動(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ù)。通過動(dòng)態(tài)數(shù)據(jù)源配置,可以在同一個(gè)應(yīng)用中隔離這些不同的數(shù)據(jù)庫(kù)訪問。
讀寫分離:為了提升系統(tǒng)的性能,通常會(huì)將讀寫操作分離到不同的數(shù)據(jù)庫(kù)上。比如,將寫操作放在主數(shù)據(jù)庫(kù),而讀操作放在從數(shù)據(jù)庫(kù)上。
數(shù)據(jù)庫(kù)遷移:在系統(tǒng)遷移期間,可能需要在兩個(gè)數(shù)據(jù)庫(kù)之間切換,從而確保遷移的平穩(wěn)進(jìn)行。
二、Spring Boot 中的多數(shù)據(jù)源配置
我們將通過一個(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ù)源依賴
為了讓 Spring Boot 能夠識(shí)別和使用這些動(dòng)態(tài)數(shù)據(jù)源,我們需要引入動(dòng)態(tài)數(shù)據(jù)源的依賴庫(kù)。這里我們使用 dynamic-datasource-spring-boot-starter 這個(gè)開源庫(kù)。
在 pom.xml 中添加如下依賴:
<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ù)源
通過 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ù)層,我們可以通過 @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í)行操作
}
}
通過 @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ù)將被回滾。
四、常見問題與解決方案
數(shù)據(jù)源切換失敗
- 確保
@DS注解指向的名稱與配置中的數(shù)據(jù)源名稱完全一致。 - 檢查
DynamicDataSource是否正確配置。
- 確保
事務(wù)回滾失敗
- 確保在同一個(gè)事務(wù)中使用的所有數(shù)據(jù)源都支持事務(wù)管理。
- 使用
@Transactional注解來(lái)管理事務(wù)。
性能問題
- 動(dòng)態(tài)數(shù)據(jù)源切換可能會(huì)帶來(lái)額外的性能開銷??梢钥紤]使用連接池優(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é)
通過動(dòng)態(tài)數(shù)據(jù)源配置,Spring Boot 應(yīng)用可以輕松應(yīng)對(duì)多數(shù)據(jù)源的復(fù)雜需求。無(wú)論是業(yè)務(wù)隔離、讀寫分離,還是數(shù)據(jù)庫(kù)遷移,動(dòng)態(tài)數(shù)據(jù)源都能夠提供靈活且高效的解決方案。
在實(shí)際應(yīng)用中,合理規(guī)劃和使用多數(shù)據(jù)源,可以顯著提升系統(tǒng)的可擴(kuò)展性和可靠性。在實(shí)現(xiàn)過程中,需要特別注意事務(wù)管理和異常處理,以確保數(shù)據(jù)的一致性和完整性。
通過本文的介紹,相信你已經(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)文章
Java基于SpringBoot和tk.mybatis實(shí)現(xiàn)事務(wù)讀寫分離代碼實(shí)例
這篇文章主要介紹了Java基于SpringBoot和tk.mybatis實(shí)現(xiàn)事務(wù)讀寫分離代碼實(shí)例,讀寫分離,基本的原理是讓主數(shù)據(jù)庫(kù)處理事務(wù)性增、改、刪操作,而從數(shù)據(jù)庫(kù)處理SELECT查詢操作,數(shù)據(jù)庫(kù)復(fù)制被用來(lái)把事務(wù)性操作導(dǎo)致的變更同步到集群中的從數(shù)據(jù)庫(kù),需要的朋友可以參考下2023-10-10
Spring Boot統(tǒng)一異常處理最佳實(shí)踐(拓展篇)
這篇文章主要給大家介紹了關(guān)于Spring Boot統(tǒng)一異常處理最佳實(shí)踐(拓展篇)的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-02-02
Google?Kaptcha驗(yàn)證碼生成的使用實(shí)例說(shuō)明
這篇文章主要為大家介紹了Google?Kaptcha驗(yàn)證碼的使用實(shí)例說(shuō)明,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-03-03
java基于Des對(duì)稱加密算法實(shí)現(xiàn)的加密與解密功能詳解
這篇文章主要介紹了java基于Des對(duì)稱加密算法實(shí)現(xiàn)的加密與解密功能,結(jié)合實(shí)例形式詳細(xì)分析了Des加密算法的功能、原理、使用方法與相關(guān)注意事項(xiàng),需要的朋友可以參考下2017-01-01
intelliJ IDEA 多行選中相同內(nèi)容的快捷鍵分享
這篇文章主要介紹了intelliJ IDEA 多行選中相同內(nèi)容的快捷鍵分享,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來(lái)看看吧2021-02-02

