Hmily 源码解析 (三) —— 事务日志实体类

• 目录

---

1. HmilyTransaction

• 日志实体类。hmily的核心就是通过事务日志来保证分布式事务的最终一致性，HmilyTransaction就是日志记录的实体映射类。
• 每一个微服务都有一张日志表。在同一个分布式事务之下，每一个微服务都有且会一条自己的事务日志记录，维护各自微服务内的事务处理。

属性说明

1. transId

• 事务id。同一个分布式事务下的所有事务日志id都是相同的。transId的一个原生作用就是来关联两个微服务的事务日志是否属于同一个事务。

2. nodeTransId

• 暂时无用

3. status

• TCC事务流转状态。值域为HmilyActionEnum枚举类型。来描述事务进展到什么状态，有四个状态，PRE_TRY(0, “开始执行try”)、TRYING(1, “try阶段完成”)、CONFIRMING(2, “confirm阶段”)、CANCELING(3, “cancel阶段”)。
• PRE_TRY阶段不生成事务日志到数据库中，只有微服务正常执行完了相应的try阶段代码，才会将状态改为TRYING，并存储到数据库永久化。

4. role

• 角色。值域为HmilyRoleEnum枚举类型。角色的作用比较复杂，简单来说，在通过切面时，会根据角色的不同选择执行不同的代码，起到分流的作用。并在适当的时候修改角色值，以保证下次进入切面时执行相应的代码。我觉得这种设计不是非常好，阅读起来很难受。

5. retriedCount

• 重试次数。在执行cofirm阶段或cancel阶段时，如果执行失败了，后面会定时再重试执行，并记录重试次数，如果达到阈值则不再重试并提醒管理员手动处理。

6. createTime

• 创建时间

7. lastTime

• 最后更新时间

8. version

• 版本，记录日志被更新的次数。

9. pattern

• 事务的类型，值域为PatternEnum 枚举类型。

10. targetClass

• 发起事务的函数的类的Class名

11. targetMethod

• 发起事务的函数的函数名

12. confirmMethod

• 发起事务的函数的Hmily注解上的confirmMethod参数值

13. cancelMethod

• 发起事务的函数的Hmily注解上的cancelMethod参数值

14. hmilyParticipants

• 事务协助类集合。在confirm阶段和cancel阶段，只有hmilyParticipants集合为空了才算是事务结束。

2. HmilyParticipant

• 事务参与者类。每一个有@Hmily注解的方法，都会生成一个HmilyParticipant实例。是根据该方法对象及hmily注解的信息生成，并存储在该微服务的HmilyTransaction实例的hmilyParticipants集合的集合中，随事务日志一起持久化。
• 在confirm阶段和cancel阶段根据该实例的信息以反射的方式调用相应的方法。

属性说明

1. transId

• 冗余的事务id，值同HmilyTransaction。

2. status

• 未使用，未知

3. confirmHmilyInvocation

• 封装confirm方法调用点。HmilyInvocation类型。通过该实例就可以调用方法上@Hmily注解描述的confirm方法。

4. cancelHmilyInvocation

• 封装cancel方法调用点。HmilyInvocation类型。通过该实例就可以调用方法上@Hmily注解描述的cacenl方法。

3. HmilyInvocation

• 存储着调用某一个方法的信息。包含类信息，方法信息，参数信息，参数类型信息。根据该实例可以使用反射的方式根据相应的参数执行相应的方法。

属性说明

1. targetClass

• 类的类型信息

2. methodName

• 方法名

3. parameterTypes

• 方法参数类型数组

4. args

• 方法的参数值数组