ole db 访问接口 sqlncli 无法启动分布式事务_2阶段提交分布式事务中间件Raincat

架构设计

流程图

流程图原理详解

首先用户发起request请求进入consume端(也可以是controller层)，controller层进入AOP切面，开启分布式事务

• 会与txManager通信，创建事务组
• 发起业务方法调用point.proceed(),这一步是分布式事务调用RPC方法的入口，会一个一个调用RPC方法
• 主线程调用provder1 提供的RPC方法，同样会进入切面，此时，会启动另一个线程去调用该RPC方法，当前线程wait

调用失败，调用业务方法线程，会唤醒等待的主线程，并把异常信息返回，走的就是one fial rollback这条线，消费方获取异常信息，自动回滚当前事务，分布式事务结束。调用成功 业务线程，将唤醒主线程，并返回数据。业务线程同txManager 通信 将自己加入到当前事务组中，业务线程进入等待，等待txManager指令，commit or rollback 即 图中的4,5,6

• 主线程继续调用provider2提供的RPC方法 ，同样会进入AOP切面，当前主线程等待，启动一个业务线程去调用业务方法

调用失败，调用业务方法线程，会唤醒等待的主线程，并把异常信息返回，走的就是two fial rollback这条线，消费方获取异常信息，自动回滚当前事务，并与txManager进行通信(two TransactionGroup fail 这条线)，txManager发起rollback指令(two fail rollback 这条线)，通知provider1 rollback调用成功 业务线程，将唤醒主线程，并返回数据。业务线程同txManager 通信 将自己加入到当前事务组中，业务线程进入等待，等待txManager指令，commit or rollback 即 图中的9,10,11

• 主线程point.proceed()方法成功执行，会向txManager发出commit请求，txManager接收请求后，会检查各模块的网络通信等状态，符合条件后，发出commit指令，即 14。通知各个模块提交自己的事务。

三阶段提交最大的问题，在于当txManager发出commit指令后，业务方down机，或者网络通信断了。怎么解决事务一致性的问题。我们这么想，当txManager 发出commit指令的时候，其实业务方法都没有任何异常，都是执行成功的，那么数据就是需要提交的。那么我们本地的补偿机制正是为了该场景而考虑，如果down机，或者网络异常。本地服务恢复后，会执行补偿，达到数据的一致性。如果业务方是集群部署的话，会立刻执行补偿，达到数据的一致性。

重要提醒，如果调用服务方是timeout，那么会判断当前事务不成功，这次分布式事务统一不会执行。

快速开始：

Spring-Boot-Starter

导出

• 首先引入rpc框架所支持的jar包,注意：版本号，根据你拉代码自己打包上传到私服一致
• Dubbo

com.raincat raincat-spring-boot-starter-dubbo ${your version}

• SpringCloud

com.raincat raincat-spring-boot-starter-springcloud ${your version}

• Motan

 com.raincat raincat-spring-boot-starter-motan ${your version}

• 在你的 application.yml 中新增如下配置：

raincat: tx : txManagerUrl: http://localhost:8761 serializer: kroy nettySerializer: kroy compensation: true compensationCacheType : db txDbConfig : driverClassName : com.mysql.jdbc.Driver url : jdbc:mysql://10.4.4.202:3306/tx?useUnicode=true&characterEncoding=utf8 username : root password : 123123 # repositorySupport : redis # txRedisConfig : # hostName : 192.168.1.68 # port : 6379 # password : # repositorySupport : zookeeper # tx-zookeeper-config : # host : 92.168.1.73:2181 # sessionTimeOut : 100000 # rootPath : /tx # repositorySupport : mongodb # tx-mongo-config : # mongoDbUrl : localost:27017 # mongoDbName : xiaoyu # mongoUserName : xiaoyu # mongoUserPwd : 123456 # repositorySupport : file # tx-file-config: # path : /consume # prefix : consume

TxManager配置详解

• application.properties 主要是配置tmManager的http服务端口，redis信息,netty相关信息 注意：因为现在tmManager 是自己向自己注册，所以http端口(server.port)应该要与eureka的端口一致。

server.port=8761 txManager 的http端口

tx.manager.netty.port=9998 对业务方提供的TCP 端口。

tx.manager.netty.serialize=kryo netty 序列化方式，注意应该要与业务方的序列化方式一致。

• bootstrap.yml 主要是配置eureka的相关属性，比如renew时间，注册地址等
• 部署集群配置： 1.修改application.properties中的 server.port 如： 第一份服务为 server.port=8761 tx.manager.netty.port=9998; 第二份服务为：server.port=8762 tx.manager.netty.port=9999; 2. 修改bootstrap.yml中的eureka:client:serviceUrl:defaultZone:http://localhost:8761/eureka/,http://localhost:8762/eureka/ 再依次启动

业务方配置详解

 @TxTransaction 该注解为分布式事务的切面(AOP point)，如果业务方的service服务需要参与分布式事务，则需要加上此注解

applicationContext.xml 详解：

    TxTransactionBootstrap 详解(具体参见com.raincat.core.config.TxConfig)：  

本地数据保存配置与详解(spi扩展支持db，redis，zookeeper，mongodb，file),详情配置请参照sample工程:

1. 本地数据存储为数据库(数据库支持mysql，oracle ，sqlServer)，当业务模块为集群时，推荐使用 会自动创建表，表名称为 tx_transaction_模块名称(applicationName),每个模块配置成一样的补偿方式，如果是用db进行存储，请使用同一个库来存储。

1. 本地数据存储为redis，当业务模块为集群时，推荐使用。(更多配置请参考 com.happylifeplat.transaction.core.config.TxRedisConfig)

1. 本地数据存储为zookeeper，当业务模块为集群时，推荐使用

1. 本地数据存储为mongodb，当业务模块为单节点时，可以使用。会自动创建集合，集合名称为 tx_transaction_模块名称(applicationName) 这里mongdb连接方式采用3.4.0版本推荐使用的Sha1,不是CR模式，同时mongdb应该开启权限认证，使用者需要注意

1. 本地数据存储为file，当业务模块为单节点时，可以使用。创建的文件名称TX_ + prefix配置 + 模块名称

dubbo用户指南

导出

dubbo用户指南(jar包的版本问题可以自己git源代码，然后编译上传到自己公司的私服)

• 配置并且启动txManager,在aoolication.properties修改你的服务端口，redis配置，具体可以参考配置详解
• 在你的dubbo服务端添加jar包，并在需要参与分布式事务的方法上添加 @TxTransaction注解

 com.raincat raincat-dubbo ${your.version}

• 配置applicationContext.xml,如下所示，如有其他问题可以参考配置详解

• 在dubbo的消费方，也是如上配置，配置好以后，启动项目.

快速体检，运行dubbo-sample( 使用者JDK必须为1.8)

步骤一：

配置txManaager, 修改application.properties中你自己的redis配置

启动TxManagerApplication

注意：如果需要修改服务端口，则应该保证与eureka:client:serviceUrl:defaultZone中的端口一致

步骤二：

1. 引入依赖包(sample已经引入)

com.raincat raincat-dubbo ${you.version}

1. 执行 raincat-dubbo-sample 工程 sql文件 dubbo-sample.sql
2. 在每个工程下的application.yml 中配置您的数据库连接(只需要改ip和端口)
3. 在工程下的spring-dubbo.xml 中配置您的zookeeper注册中心
4. 在每个工程下 applicationContext.xml中的TxDbConfig 配置您的补偿数据库连接，提供单独的库来存储。
5. 在需要做分布式事务的接口上加上注解 @TxTransaction (sample已经加上)
6. 依次启动order模块，stock 模块 ,consume模块
7. 访问http://localhost:8888/swagger-ui.html 进行测试体验

springcloud用户指南

导出

springcloud用户指南(jar包的版本问题可以自己git源代码，然后编译上传到自己公司的私服)

• 配置并且启动txManager,在aoolication.properties修改你的服务端口，redis配置，具体可以参考配置详解
• 在你的springcloud服务端添加jar包，并在需要参与分布式事务的方法上添加 @TxTransaction注解

com.raincat raincat-springcloud ${your.version}

• 配置applicationContext.xml,如下所示，如有其他问题可以参考配置详解

• 在springcloud的消费方，也是如上配置，配置好以后，启动项目.

快速体检，运行springcloud-sample( 使用者JDK必须为1.8)

步骤一：

配置txManaager, 修改application.properties中你自己的redis配置 启动TxManagerApplication

注意：如果需要修改服务端口，则应该保证与eureka:client:serviceUrl:defaultZone中的端口一致

步骤二：

• 引入依赖包(sample已经引入)

 com.raincat raincat-springcloud ${your.version}

• 执行 raincat-springcloud-sample 工程 sql文件 springcloud-sample.sql
• 在每个工程下 application.yml 中配置您的数据库连接(只需要改ip和端口)
• 在每个工程下 applicationContext.xml中的TxDbConfig 配置您的补偿数据库连接，提供单独的数据库来存储。
• 在需要做分布式事务的接口上加上注解 @TxTransaction (sample已经加上)
• 依次启动AliPayApplication，WechatApplication ,PayApplication
• 访问http://localhost:8881/pay-service/swagger-ui.html 进行体验测试

启动事务管理后台(admin)

导出

raincat-admin 启动教程

启动前提：分布式事务项目已经部署并且运行起来，用户根据自己的RPC框架进行使用 dubbo 用户 springcloud 用户

• 首先用户使用的JDK必须是1.8+ 本地安装了git ,maven ，执行以下命令

git clone https://github.com/yu199195/Raincat.gitmaven clean install

• 使用你的开发工具打开项目，比如idea Eclipse

步骤一： 配置并且启动transaction-admin

• 在项目中的application.properties文件中，修改您的服务端口，redis配置等配置:

#admin项目的tomcat端口server.port=8888#admin项目的上下文server.context-path=/adminserver.address=0.0.0.0#admin项目的应用名称spring.application.name=tx-transaction-admin# admin项目激活的类型，支持db，file，mongo，zookeeper，redis 下文会继续讲解spring.profiles.active=db# txManager redis 配置#集群配置#tx.redis.cluster=true#tx.redis.cluster.nodes=127.0.0.1:70001;127.0.1:7002#tx.redis.cluster.redirects=20#单机配置tx.redis.cluster=falsetx.redis.hostName=192.168.1.68#redis主机端口tx.redis.port=6379#tx.redis.password=happylifeplat01# admin管理后台的用户名，用户可以自己更改tx.admin.userName=admin# admin管理后台的密码，用户可以自己更改tx.admin.password=admin#采用二阶段提交项目的应用名称集合，这个必须要填写recover.application.list=alipay-service,wechat-service,pay-service#事务补偿最大重试次数recover.retry.max=10#事务补偿的序列方式recover.serializer.support=kryo#dbSuport 采用db进行的补偿方式的配置recover.db.driver=com.mysql.jdbc.Driverrecover.db.url=jdbc:mysql://192.168.1.68:3306/tx?useUnicode=true&characterEncoding=utf8recover.db.username=xiaoyurecover.db.password=Wgj@555888#redis 采用redis进行补偿方式的配置recover.redis.cluster=falserecover.redis.hostName=192.168.1.68recover.redis.port=6379recover.redis.password=#recover.redis.clusterUrl=127.0.0.1:70001;127.0.1:7002#mongo 采用mongo 进行补偿方式的配置recover.mongo.url=192.168.1.68:27017recover.mongo.dbName=happyliferecover.mongo.userName=xiaoyurecover.mongo.password=123456#zookeeper 采用zookeeper进行补偿的方式配置recover.zookeeper.host=192.168.1.132:2181recover.zookeeper.sessionTimeOut=200000

配置解释

• 关于txManager的redis配置:其实就是在txManager项目中的redis配置，在这里需要配置成一样的； 注意，如果你的redis是集群模式请参考集群配置，并注释掉单机redis配置，同理redis单机模式也一样。
• 关于 recover.application.list配置：这里需要配置每个参与二阶段分布式事务的系统模块的applicationName，多个模块用