目录
概述
适用于多种场景:纯粹多库、 读写分离、 一主多从、 混合模式等。
一个基于springboot的快速集成多数据源的启动器。
这是一个第三方 mybatis 扩展库,与 mybatis-plus 本身无关,属于组织参与者小锅盖个人发起的项目。
简介
dynamic-datasource-spring-boot-starter 是一个基于springboot的快速集成多数据源的启动器。
其支持 Jdk 1.7+, SpringBoot 1.4.x 1.5.x 2.x.x。
特性
- 支持 数据源分组 ,适用于多种场景 纯粹多库 读写分离 一主多从 混合模式。
- 支持数据库敏感配置信息 加密 ENC()。
- 支持每个数据库独立初始化表结构schema和数据库database。
- 支持无数据源启动,支持懒加载数据源(需要的时候再创建连接)。
- 支持 自定义注解 ,需继承DS(3.2.0+)。
- 提供并简化对Druid,HikariCp,BeeCp,Dbcp2的快速集成。
- 提供对Mybatis-Plus,Quartz,ShardingJdbc,P6sy,Jndi等组件的集成方案。
- 提供 自定义数据源来源 方案(如全从数据库加载)。
- 提供项目启动后 动态增加移除数据源 方案。
- 提供Mybatis环境下的 纯读写分离 方案。
- 提供使用 spel动态参数 解析数据源方案。内置spel,session,header,支持自定义。
- 支持 多层数据源嵌套切换 。(ServiceA >>> ServiceB >>> ServiceC)。
- 提供 **基于seata的分布式事务方案。
- 提供 本地多数据源事务方案。
约定
- 本框架只做 切换数据源 这件核心的事情,并不限制你的具体操作,切换了数据源可以做任何CRUD。
- 配置文件所有以下划线
_
分割的数据源 首部 即为组的名称,相同组名称的数据源会放在一个组下。 - 切换数据源可以是组名,也可以是具体数据源名称。组名则切换时采用负载均衡算法切换。
- 默认的数据源名称为 master ,你可以通过
spring.datasource.dynamic.primary
修改。 - 方法上的注解优先于类上注解。
- DS支持继承抽象类上的DS,暂不支持继承接口上的DS。
使用方法
准备两个数据库
①之前我们在我们的数据库mybatis_plus创建了一个表t_user,现在我们再创建一个数据库mybatis_plus1然后在其中创建一个product表。
两个数据库分别有一个表t_user以及product
t_user表结构如下
product表结构如下
引入依赖
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
<version>3.5.0</version>
</dependency>
配置多数据源
说明:注释掉之前的数据库连接,添加新配置
这个配置可以在官网上直接复制,如下,如果你复制我的代码别忘了修改数据库的信息哦。
红框内是重要内容
spring:
datasource:
# 配置数据源类型
type: com.zaxxer.hikari.HikariDataSource
dynamic:
primary: master #设置默认的数据源或者数据源组,默认值即为master
strict: false #严格匹配数据源,默认false. true未匹配到指定数据源时抛异常,false使用默认数据源
datasource:
master:
url: jdbc:mysql://localhost:3306/mybatis_plus?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
username: root
password: 1230
driver-class-name: com.mysql.cj.jdbc.Driver
slave_1:
url: jdbc:mysql://localhost:3306/mybatis_plus1?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
username: root
password: 1230
driver-class-name: com.mysql.cj.jdbc.Driver
#......省略
#以上会配置一个默认库master,一个slave_1
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
生成对应的mapper类以及文件
这里不再赘述,按照上篇讲过的,使用mybatisplus生成器生成实体类、Service接口以及实现类以及Mapper接口和mapper文件。
别忘了在springboot的启动类上加入mapper包的扫描哦。
在Service类上加上注解@DS指定所操作的数据源
测试
package com.csdn.mybatis;
import com.csdn.mybatis.entity.Product;
import com.csdn.mybatis.entity.User;
import com.csdn.mybatis.service.IProductService;
import com.csdn.mybatis.service.IUserService;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.List;
@SpringBootTest
class Mybatisplus02ApplicationTests {
@Autowired
IUserService userService;
@Autowired
IProductService productService;
@Test
public void test(){
List<User> users = userService.list();
users.forEach(System.out::println);
List<Product> products = productService.list();
products.forEach(System.out::println);
}
}
输出的sql语句为
不同数据库多数据源测试成功。