多数据源动态切换及XA分布式事务实现说明文档

 

多数据源动态切换及XA分布式事务实现说明文档

Spring+Mybatis+Druid+AtomikosDataSource

 

文档修改记录

版本

修改日期

修改人

说明

1.0.0

2021-04-20

Oscar

初稿

 

 

 

 

 

 

 

 

 

(本文相关内容均可参照项目DEMO程序,结合测试用例,即可上手应用)


 

一、如何使用

1.1 怎么进行数据源切换?

通过@DataSource注解切换数据源

(a)在对应的方法上加入@DataSource注解,注解的value值设置为对应的数据源。

 

java 根据租户 多数据源 java多数据源事务_mybatis

 

(b)在对应的类上加入@DataSource注解,则该类下未设置@DataSource注解的方法都将以类上的注解切换数据源。

 

java 根据租户 多数据源 java多数据源事务_数据库_02

 

(c)项目上未使用@DataSource注解指定数据源的情况,也可配置全局默认的数据源。

 

java 根据租户 多数据源 java多数据源事务_mybatis_03

 

1.2 同一方法内如何动态切换数据源?

在同一方法内通过DynamicDataSourceHolder动态数据源持有者可设置后续操作所使用的数据源。

 

java 根据租户 多数据源 java多数据源事务_java 根据租户 多数据源_04

 

1.3 怎么支持多数据源的事务?

通过@Transactional注解实现分布式事务,可在类上或方法上使用。该注解已在项目中做了配置,支持XA分布式事务。

 

java 根据租户 多数据源 java多数据源事务_java_05

 

二、相关配置说明

示例项目中的配置文件主要有:

 

java 根据租户 多数据源 java多数据源事务_spring_06

2.1 数据源信息配置

将项目中各个数据源的信息进行配置

 

java 根据租户 多数据源 java多数据源事务_java_07

 

2.2 MyBatis数据库持久层配置

可在配置文件中根据不同类型数据源设置其所使用的SQL映射文件,以及Mapper接口所扫描的路径等。

 

java 根据租户 多数据源 java多数据源事务_数据库_08

2.3 项目的事务配置

通过配置Spring的事务管理器,使@Transactional注解支持分布式事务。

 

java 根据租户 多数据源 java多数据源事务_mybatis_09

 

三、相关实现类说明

3.1 数据源切面类

 

java 根据租户 多数据源 java多数据源事务_java_10

 

3.2 动态数据源抽象实现类

 

java 根据租户 多数据源 java多数据源事务_mybatis_11

 

 

四、如何测试验证?

如下以一个简单的转账案例,模拟测试同一事务下多数据源的操作情景。

 

java 根据租户 多数据源 java多数据源事务_java_12

测试时,可跟进日志中当前所持有的数据源信息,进而验证用例是否准确。

 

java 根据租户 多数据源 java多数据源事务_java_13

 

五、准备工作

根据项目测试需求,创建对应类型的数据库,并导入初始数据库脚本。在jdbc配置文件中,配置相应的数据库驱动类(Oracle\MySQL\DB2等)

 

java 根据租户 多数据源 java多数据源事务_mybatis_14