二阶段消息例子

本文将介绍一个完整的二阶段消息例子,让读者对二阶段消息型事务有一个准确的了解

业务场景

跨行转账是典型的分布式事务场景,在这里,A需要跨行转账给B,假设需求场景是:只有转出A可能失败,转入B是能够最终成功的

二阶段消息

二阶段消息是dtm首创的事务模式,用于替换本地事务表和事务消息这两种现有的方案。它能够保证本地事务的提交和全局事务提交是“原子的”,适合解决不需要回滚的分布式事务场景。下面我们来看看二阶段消息,如何解决这个业务场景的问题。

核心业务

首先我们创建账户余额表:

  1. CREATE TABLE dtm_busi.`user_account` (
  2. `id` int(11) AUTO_INCREMENT PRIMARY KEY,
  3. `user_id` int(11) not NULL UNIQUE ,
  4. `balance` decimal(10,2) NOT NULL DEFAULT '0.00',
  5. `trading_balance` decimal(10,2) NOT NULL DEFAULT '0.00',
  6. `create_time` datetime DEFAULT now(),
  7. `update_time` datetime DEFAULT now()
  8. );

然后编写核心业务代码,调整用户的账户余额

  1. func SagaAdjustBalance(db dtmcli.DB, uid int, amount int, result string) error {
  2. _, err := dtmimp.DBExec(db, "update dtm_busi.user_account set balance = balance + ? where user_id = ?", amount, uid)
  3. return err
  4. }

再来编写具体的处理函数

  1. app.POST(BusiAPI+"/SagaBTransIn", dtmutil.WrapHandler2(func(c *gin.Context) interface{} {
  2. barrier := MustBarrierFromGin(c)
  3. return barrier.Call(txGet(), func(tx *sql.Tx) error {
  4. return SagaAdjustBalance(tx, TransInUID, reqFrom(c).Amount, "")
  5. })
  6. }))

这些处理函数的核心逻辑都是是调整余额。这里面的barrier.Call主要是用于处理幂等,保证重复调用不会多次调整余额,详情参见异常与子事务屏障

二阶段消息事务

到此各个子事务的处理函数已经OK了,然后是开启二阶段消息事务,进行分支调用

  1. msg := dtmcli.NewMsg(DtmServer, shortuuid.New()).
  2. Add(busi.Busi+"/SagaBTransIn", &TransReq{ Amount: 30 })
  3. err := msg.DoAndSubmitDB(busi.Busi+"/QueryPreparedB", dbGet(), func(tx *sql.Tx) error {
  4. return busi.SagaAdjustBalance(tx, busi.TransOutUID, -req.Amount)
  5. })

这段代码中,会保证 DoAndSubmitDB 中的业务提交和全局事务提交是“原子的”,保证了TransOut和TransIn的同时成功,或同时失败。其中 DoAndSubmitDB 中的第一个参数为回查URL,他的代码如下:

  1. app.GET(BusiAPI+"/QueryPreparedB", dtmutil.WrapHandler2(func(c *gin.Context) interface{} {
  2. bb := MustBarrierFromGin(c)
  3. return bb.QueryPrepared(dbGet())
  4. }))

至此,一个完整的二阶段消息分布式事务编写完成。

按topic投递消息

您还可以通过按topic投递消息来实现分支事务调用。

首先为执行分支事务的API订阅名为TransIn 的topic:

这一步可以在管理后台完成

  1. resp, err := dtmcli.GetRestyClient().R().SetQueryParams(map[string]string{
  2. "topic": "TransIn",
  3. "url": busi.Busi+"/SagaBTransIn",
  4. "remark": "trans in api",
  5. }).Get(dtmutil.DefaultHTTPServer + "/subscribe")

然后开启二阶段消息事务,通过向该topic投递消息实现分支事务调用

  1. msg := dtmcli.NewMsg(DtmServer, shortuuid.New()).
  2. AddTopic("TransIn", &TransReq{ Amount: 30 })
  3. err := msg.DoAndSubmitDB(busi.Busi+"/QueryPreparedB", dbGet(), func(tx *sql.Tx) error {
  4. return busi.SagaAdjustBalance(tx, busi.TransOutUID, -req.Amount)
  5. })

需要注意的是,topic订阅信息的变更有一个生效时间,由ConfigUpdateInterval参数决定。

运行

如果您想要完整运行一个成功的示例,步骤如下:

  1. 运行dtm
  1. git clone https://github.com/dtm-labs/dtm && cd dtm
  2. go run main.go
  1. 运行例子
  1. git clone https://github.com/dtm-labs/dtm-examples && cd dtm-examples
  2. go run main.go http_msg_doAndCommit

如何保证原子性

二阶段消息如何保证本地事务和全局事务要么都成功,要么都失败呢?假定本地事务提交完成后,提交全局事务前,进程crash会如何?下面时序图很好的讲解了二阶段消息是如何处理这个问题的:

msg_query

图中的回查处理逻辑,dtm已经做了自动处理,用户只需要粘贴上述的代码即可

小结

本文给出了一个完整的二阶段消息事务方案,是一个可以实际运行的二阶段消息,您只需要在这个示例的基础上进行简单修改,就能够用于解决您的真实问题

关于更多二阶段消息的原理,可以参见二阶段消息