dynamic-datasource-spring-boot-starter 是一個(gè)基于springboot的快速集成多數(shù)據(jù)源的啟動(dòng)器。

其支持 Jdk 1.7+, SpringBoot 1.4.x 1.5.x 2.x.x。

特性

1、支持 數(shù)據(jù)源分組 ，適用于多種場(chǎng)景 純粹多庫(kù) 讀寫分離 一主多從 混合模式。

2、支持?jǐn)?shù)據(jù)庫(kù)敏感配置信息 加密(可自定義) ENC()。

3、支持每個(gè)數(shù)據(jù)庫(kù)獨(dú)立初始化表結(jié)構(gòu)schema和數(shù)據(jù)庫(kù)database。

4、支持無(wú)數(shù)據(jù)源啟動(dòng)，支持懶加載數(shù)據(jù)源(需要的時(shí)候再創(chuàng)建連接)。

5、支持 自定義注解 ，需繼承DS(3.2.0+)。

6、提供并簡(jiǎn)化對(duì)Druid，HikariCp，BeeCp,Dbcp2的快速集成。

7、提供對(duì)Mybatis-Plus，Quartz，ShardingJdbc，P6sy，Jndi等組件的集成方案。

8、提供 自定義數(shù)據(jù)源來(lái)源 方案(如全從數(shù)據(jù)庫(kù)加載)。

9、提供項(xiàng)目啟動(dòng)后 動(dòng)態(tài)增加移除數(shù)據(jù)源 方案。

10、提供Mybatis環(huán)境下的 純讀寫分離 方案。

11、提供使用 spel動(dòng)態(tài)參數(shù) 解析數(shù)據(jù)源方案。內(nèi)置spel，session，header，支持自定義。

12、支持 多層數(shù)據(jù)源嵌套切換 。(ServiceA >>> ServiceB >>> ServiceC)。

13、提供 基于seata的分布式事務(wù)方案 。

14、提供 本地多數(shù)據(jù)源事務(wù)方案。

約定

1、本框架只做 切換數(shù)據(jù)源 這件核心的事情，并不限制你的具體操作，切換了數(shù)據(jù)源可以做任何CRUD。2、配置數(shù)據(jù)源。

2、配置文件所有以下劃線 _ 分割的數(shù)據(jù)源 首部 即為組的名稱，相同組名稱的數(shù)據(jù)源會(huì)放在一個(gè)組下。

3、切換數(shù)據(jù)源可以是組名，也可以是具體數(shù)據(jù)源名稱。組名則切換時(shí)采用負(fù)載均衡算法切換。

4、默認(rèn)的數(shù)據(jù)源名稱為 master ，你可以通過(guò) spring.datasource.dynamic.primary 修改。

5、方法上的注解優(yōu)先于類上注解。

6、DS支持繼承抽象類上的DS，暫不支持繼承接口上的DS。

使用方法

1、引入dynamic-datasource-spring-boot-starter。

 <dependency>
<groupId>com.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
<version>${version}</version>
</dependency>

2、配置數(shù)據(jù)源。

spring:
datasource:
dynamic:
primary: master #設(shè)置默認(rèn)的數(shù)據(jù)源或者數(shù)據(jù)源組,默認(rèn)值即為master
strict: false #嚴(yán)格匹配數(shù)據(jù)源,默認(rèn)false. true未匹配到指定數(shù)據(jù)源時(shí)拋異常,false使用默認(rèn)數(shù)據(jù)源
datasource:
master:
url: jdbc:mysql://xx.xx.xx.xx:3306/dynamic
username: root
password: 123456
driver-class-name: com.mysql.jdbc.Driver # 3.2.0開始支持SPI可省略此配置
slave_1:
url: jdbc:mysql://xx.xx.xx.xx:3307/dynamic
username: root
password: 123456
driver-class-name: com.mysql.jdbc.Driver
slave_2:
url: ENC(xxxxx) # 內(nèi)置加密,使用請(qǐng)查看詳細(xì)文檔
username: ENC(xxxxx)
password: ENC(xxxxx)
driver-class-name: com.mysql.jdbc.Driver
#......省略
#以上會(huì)配置一個(gè)默認(rèn)庫(kù)master，一個(gè)組slave下有兩個(gè)子庫(kù)slave_1,slave_2
# 多主多從 純粹多庫(kù)（記得設(shè)置primary） 混合配置
spring: spring: spring:
datasource: datasource: datasource:
dynamic: dynamic: dynamic:
datasource: datasource: datasource:
master_1: mysql: master:
master_2: oracle: slave_1:
slave_1: sqlserver: slave_2:
slave_2: postgresql: oracle_1:
slave_3: h2: oracle_2:

3、使用 @DS 切換數(shù)據(jù)源。

@DS 可以注解在方法上或類上，同時(shí)存在就近原則 方法上注解 優(yōu)先于 類上注解。

@Service
@DS("slave")
public class UserServiceImpl implements UserService {

@Autowired
private JdbcTemplate jdbcTemplate;

public List selectAll() {
return jdbcTemplate.queryForList("select * from user");
}

@Override
@DS("slave_1")
public List selectByCondition() {
return jdbcTemplate.queryForList("select * from user where age >10");
}
}