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

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

文档修改记录

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

一、如何使用
1.1 怎么进行数据源切换？
通过@DataSource注解切换数据源
（a）在对应的方法上加入@DataSource注解，注解的value值设置为对应的数据源。

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

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

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

1.3 怎么支持多数据源的事务？
通过@Transactional注解实现分布式事务，可在类上或方法上使用。该注解已在项目中做了配置，支持XA分布式事务。

二、相关配置说明
示例项目中的配置文件主要有：

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

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

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

三、相关实现类说明
3.1 数据源切面类

3.2 动态数据源抽象实现类

四、如何测试验证？
如下以一个简单的转账案例，模拟测试同一事务下多数据源的操作情景。

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

五、准备工作
根据项目测试需求，创建对应类型的数据库，并导入初始数据库脚本。在jdbc配置文件中，配置相应的数据库驱动类（Oracle\MySQL\DB2等）