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

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

特性

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

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

3、支持每個數(shù)據(jù)庫獨立初始化表結構schema和數(shù)據(jù)庫database。

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

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

6、提供并簡化對Druid，HikariCp，BeeCp,Dbcp2的快速集成。

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

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

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

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

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

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

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

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

約定

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

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

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

4、默認的數(shù)據(jù)源名稱為 master ，你可以通過 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ù)據(jù)源或者數(shù)據(jù)源組,默認值即為master
strict: false #嚴格匹配數(shù)據(jù)源,默認false. true未匹配到指定數(shù)據(jù)源時拋異常,false使用默認數(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)置加密,使用請查看詳細文檔
username: ENC(xxxxx)
password: ENC(xxxxx)
driver-class-name: com.mysql.jdbc.Driver
#......省略
#以上會配置一個默認庫master，一個組slave下有兩個子庫slave_1,slave_2
# 多主多從 純粹多庫（記得設置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 可以注解在方法上或類上，同時存在就近原則 方法上注解 優(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");
}
}