使用JTA处理分布式事务
Spring Boot通过Atomkos或Bitronix的内嵌事务管理器支持跨多个XA资源的分布式JTA事务,当部署到恰当的J2EE应用服务器时也会支持JTA事务。
当发现JTA环境时,Spring Boot将使用Spring的 JtaTransactionManager
来管理事务。自动配置的JMS,DataSource和JPA beans将被升级以支持XA事务。可以使用标准的Spring idioms,比如 @Transactional
,来参与到一个分布式事务中。如果处于JTA环境,但仍想使用本地事务,你可以将 spring.jta.enabled
属性设置为 false
来禁用JTA自动配置功能。
使用Atomikos事务管理器
Atomikos是一个非常流行的开源事务管理器,并且可以嵌入到Spring Boot应用中。可以使用 spring-boot-starter-jta-atomikos
Starter去获取正确的Atomikos库。Spring Boot会自动配置Atomikos,并将合适的 depends-on
应用到Spring Beans上,确保它们以正确的顺序启动和关闭。
默认情况下,Atomikos事务日志将被记录在应用home目录(应用jar文件放置的目录)下的 transaction-logs
文件夹中。可以在 application.properties
文件中通过设置 spring.jta.log-dir
属性来定义该目录,以 spring.jta.atomikos.properties
开头的属性能用来定义Atomikos的 UserTransactionServiceIml
实现,具体参考AtomikosProperties javadoc。
注 为了确保多个事务管理器能够安全地和相应的资源管理器配合,每个Atomikos实例必须设置一个唯一的ID。默认情况下,该ID是Atomikos实例运行的机器上的IP地址。为了确保生产环境中该ID的唯一性,需要为应用的每个实例设置不同的 spring.jta.transaction-manager-id
属性值。
使用Bitronix事务管理器
Bitronix是一个流行的开源JTA事务管理器实现,可以使用 ·spring-bootstarter-jta-bitronix· starter为项目添加合适的Birtronix依赖。和Atomikos类似,Spring Boot将自动配置Bitronix,并对beans进行后处理(post-process)以确保它们以正确的顺序启动和关闭。
默认情况下,Bitronix事务日志( part1.btm
和 part2.btm
)将被记录到应用home目录下的 transaction-logs
文件夹中,可以通过设置 spring.jta.log-dir
属性来自定义该目录。以 spring.jta.bitronix.properties
开头的属性将被绑定到 bitronix.tm.Configuration
bean,可以通过这完成进一步的自定义,具体参考Bitronix文档。
注 为了确保多个事务管理器能够安全地和相应的资源管理器配合,每个Bitronix实例必须设置一个唯一的ID。默认情况下,该ID是Bitronix实例运行的机器上的IP地址。为了确保生产环境中该ID的唯一性,需要为应用的每个实例设置不同的 spring.jta.transaction-manager-id
属性值。
使用Narayana事务管理器
Narayana是一个流行的开源JTA事务管理器实现,目前只有JBoss支持。可以使用 spring-boot-starter-jta-narayana
starter添加合适的Narayana依赖,像Atomikos和Bitronix那样,Spring Boot将自动配置Narayana,并对beans后处理(post-process)以确保正确启动和关闭。
Narayana事务日志默认记录到应用home目录(放置应用jar的目录)的 transaction-logs
目录下,可以通过设置 application.properties
中的 spring.jta.log-dir
属性自定义该目录。以 spring.jta.narayana.properties
开头的属性可用于自定义Narayana配置,具体参考NarayanaProperties。
注 为了确保多事务管理器能够安全配合相应资源管理器,每个Narayana实例必须配置唯一的ID,默认ID设为 1 。为确保生产环境中ID唯一性,可以为应用的每个实例配置不同的 spring.jta.transaction-manager-id
属性值。
使用J2EE管理的事务管理器
如果将Spring Boot应用打包为一个 war
或 ear
文件,并将它部署到一个J2EE的应用服务器中,那就能使用应用服务器内建的事务管理器。Spring Boot将尝试通过查找常见的JNDI路径( java:comp/UserTransaction
,java:comp/TransactionManager
等)来自动配置一个事务管理器。如果使用应用服务器提供的事务服务,通常需要确保所有的资源都被应用服务器管理,并通过JNDI暴露出去。Spring Boot通过查找JNDI路径 java:/JmsXA
或 java:/XAConnectionFactory
获取一个 ConnectionFactory
来自动配置JMS,并且可以使用 spring.datasource.jndi-name
属性配置 DataSource
。
混合XA和non-XA的JMS连接
当使用JTA时,primary JMS ConnectionFactory
bean将能识别XA,并参与到分布式事务中。有些情况下,可能需要使用non-XA的 ConnectionFactory
去处理一些JMS消息。例如,JMS处理逻辑可能比XA超时时间长。
如果想使用一个non-XA的 ConnectionFactory
,可以注入 nonXaJmsConnectionFactory
bean而不是 @Primary
jmsConnectionFactory
bean。为了保持一致, jmsConnectionFactory
bean将以别名 xaJmsConnectionFactor
来被使用。
示例如下:
支持可替代的内嵌事务管理器
XAConnectionFactoryWrapper和XADataSourceWrapper接口用于支持可替换的内嵌事务管理器。该接口用于包装 XAConnectionFactory
和 XADataSource
beans,并将它们暴露为普通的 ConnectionFactory
和 DataSource
beans,这样在分布式事务中可以透明使用。Spring Boot将使用注册到 ApplicationContext
的合适的XA包装器及 JtaTransactionManager
bean自动配置DataSource和JMS。
BitronixXAConnectionFactoryWrapper和BitronixXADataSourceWrapper提供了很好
的示例用于演示怎么编写XA包装器。
实验
本实验基于Atomikos事务管理器和MYSQL数据库实现。
创建数据库
创建一个Maven项目
pom.xml
application.yml
UserMapper.xml
User.java
Income.java
DataSourceJTAIncomeConfig.java
DataSourceJTAUserConfig.java
IncomeController.java
IncomeMapper.java
UserMapper.java
App.java
项目结构
运行及结果
查看表中数据
首先先看下两个数据库中表的情况:
user
库中user表的数据情况如下:
income
库中income表的数据情况如下:
事务正常
访问http://localhost:9090/income/addincome/1?name=freud&amount=10
,正常在两个数据库各插入一条数据。
user
库中user表的数据情况如下:
income
库中income表的数据情况如下:
事务失败
访问http://localhost:9090/income/addincome/2?name=kkk&amount=10
,程序中会抛出一个运行时异常,事务失败,两个库都不会插入数据成功。
user
库中user表的数据情况如下:
income
库中income表的数据情况如下:
参考资料
Spring Boot Reference Guide : http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/
Spring-boot下的mybatis多数据源JTA配置 : http://blog.csdn.net/pichunhan/article/details/70846695
JTA 深度历险 - 原理与实现 : https://www.ibm.com/developerworks/cn/java/j-lo-jta/