tx-lcn使用

tx-lcn是啥

tx-lcn是一个分布式事务框架，有两个模块组成管理端（server）和client端。
管理端用于分布式事务的注册，事务消息接收，事务消息下发等管理工作。
client端包括事务发起方，事务参与方。
LCN名称是各取如下单词首字母得来的：锁定事务单元（lock）、确认事务模块状态(confirm)、通知事务(notify) 。
分布式事务的本质是多个数据库事务的统一管理。

分布式数据事务多采用二阶段提交协议：
阶段一为准备（prepare）阶段。即所有的参与者准备执行事务并锁住需要的资源。参与者ready时，向transaction manager报告已准备就绪。
阶段二为提交阶段（commit）。当transaction manager确认所有参与者都ready后，向所有参与者发送commit命令。

tx-lcn的模式

一、lcn模式：通过代理数据库连接来实现分布式事务的统一管理，适合于mysql等关系型数据库，使用注解即可，所以对代码侵入性较小。由于使用数据库本身的事务机制，对数据的一致性有较高保证。但是由于代理链接跟发起方链接一起释放，连接占用时间较长。

遵循二阶段提交，执行流程如下描述：
1、事务发起方（client端）调用管理端创建事务组，生成一个事务组。
2、事务发起方调用事务参与方执行业务逻辑，然后事务参与方将执行结果通知给事务管理端。
3、事务发起方将自己模块的执行结果通知给管理端。
4、管理端根据发起方和所有参与方的执行结果通知发起方和所有参与方是提交还是回滚。

二、tcc模式：不依赖于数据库的事务实现分布式事务管理。也不需要事务管理端，而是由代码逻辑控制事物的提交和回滚。为需要使用分布式事物的方发编写确认提交逻辑和回滚逻辑，使用注解参数指定例如：@TccTransaction(confirmMethod=“method1”,cancelMethod=“method2”)。由于每个事务方法都要写这两个逻辑，比较繁琐，对代码侵入性较强，但适用面广，任何数据库都适用。

三、txc模式：执行sql前，先查询影响的数据，然后保存这些数据，并对这些数据加锁，执行SQL，如果执行失败，则用保存的数据回滚。目前分布式锁采用redis的分布式锁

tx-lcn的使用

一、lcn模式：

创建一个管理项目

• pom文件引入依赖

<dependencies><dependency><groupId>com.codingapi.txlcn</groupId><artifactId>txlcn-tm</artifactId><version>5.0.2.RELEASE</version></dependency>
</dependencies>

• 使用application.properties配置属性，或者保留空的application.properties文件新建一个application.yml文件在其中配置属性：

spring:redis:host: 127.0.0.1port: 6381application:name: txManagerdatasource:driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/tx-manager?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghaiusername: rootpassword: root
tx-lcn:manager:host: 127.0.0.1 # tx-manager ip(client请求ip)port: 8070  # client 请求端口heart-time: 12000 # 心跳检测时间 单位：msdtx-time: 3000 # 事务执行总时间admin-key: 123456 #TM后台登陆密码,默认密码是codingapilogger:enabled: true #开启日志,默认为false,开发阶段最好开启日志，并设置为debug等级，这样方便追踪排查问题#日志记录表 t_loggerdriver-class-name: ${spring.datasource.driver-class-name}jdbc-url: ${spring.datasource.url}username: ${spring.datasource.username}password: ${spring.datasource.password}

• 从引入的jar包中找到tx-manager.sql，用它创建管理端需要的数据库表
• 启动类上加注解@EnableTransactionManagerServer

创建一个业务项目

• pom文件引入依赖

<dependency><groupId>com.codingapi.txlcn</groupId><artifactId>txlcn-txmsg-netty</artifactId><version>5.0.2.RELEASE</version>
</dependency>
<dependency><groupId>com.codingapi.txlcn</groupId><artifactId>txlcn-tc</artifactId><version>5.0.2.RELEASE</version>
</dependency>

• yml配置

tx-lcn:client:manager-address: 127.0.0.1:8070 #上述管理端的IP

• 启动类上加注解@EnableDistributedTransaction
  在需要使用分布式事务的方法上加注解@LcnTransaction
  @LcnTransaction属性propagation可取值
  DTXPropagation.REQUIRED：默认值，表示如果当前没有事务组创建事务组，如果有事务组，加入事务组。多用在事务发起方。
  DTXPropagation.SUPPORTS：如果当前没有事务组以本地事务运行，如果当前有事务组加入事务组。多用在事务参与方法。

二、tcc模式：

创建一个业务项目

• pom文件引入依赖

<dependency><groupId>com.codingapi.txlcn</groupId><artifactId>txlcn-txmsg-netty</artifactId><version>5.0.2.RELEASE</version>
</dependency>
<dependency><groupId>com.codingapi.txlcn</groupId><artifactId>txlcn-tc</artifactId><version>5.0.2.RELEASE</version>
</dependency>

• 启动类上加注解@EnableDistributedTransaction
• 在需要使用分布式事务的方法上加注解@TccTransaction(confirmMethod=“confirmMethod”,cancelMethod=“cancelMethod”)
• 为方法创建confirmMethod和cancelMethod方法
  参考文章：
  https://blog.csdn.net/m0_56182317/article/details/130288633
  https://www.cnblogs.com/64Byte/p/13426818.html
  https://www.bilibili.com/read/cv10537863/
  https://zhuanlan.zhihu.com/p/325602044?utm_id=0