From 45eb332d65ba280fda03fc62be546a8620d14a09 Mon Sep 17 00:00:00 2001 From: yedf2 <120050102@qq.com> Date: Fri, 23 Jul 2021 15:52:44 +0800 Subject: [PATCH 1/3] update readme --- README-en.md | 13 +++++++------ README.md | 17 +++++++++-------- go.mod | 2 +- go.sum | 3 --- 4 files changed, 17 insertions(+), 18 deletions(-) diff --git a/README-en.md b/README-en.md index d4085d1..efcfd8b 100644 --- a/README-en.md +++ b/README-en.md @@ -46,16 +46,17 @@ Configure mysql: ``` go // business microservice address const qsBusi = "http://localhost:8081/api/busi_saga" - req := &gin.H{"amount": 30} // Microservice payload - // The address where DtmServer serves DTM, which is a url - saga := dtmcli.NewSaga("http://localhost:8080/api/dtmsvr"). + req := &gin.H{"amount": 30} // Microservice payload + // The address where DtmServer serves DTM, which is a url + DtmServer := "http://localhost:8080/api/dtmsvr" + saga := dtmcli.NewSaga(DtmServer, dtmcli.MustGenGid(DtmServer)). // Add a TransOut sub-transaction, the operation is url: qsBusi+"/TransOut"， // compensation operation is url: qsBusi+"/TransOutCompensate" - Add(qsBusi+"/TransOut", qsBusi+"/TransOutCompensate", req). + Add(qsBusi+"/TransOut", qsBusi+"/TransOutCompensate", req). // Add a TransIn sub-transaction, the operation is url: qsBusi+"/TransOut"， // compensation operation is url: qsBusi+"/TransInCompensate" - Add(qsBusi+"/TransIn", qsBusi+"/TransInCompensate", req) - // Submit the saga transaction, dtm will complete all sub-transactions/rollback all sub-transactions + Add(qsBusi+"/TransIn", qsBusi+"/TransInCompensate", req) + // Submit the saga transaction, dtm will complete all sub-transactions/rollback all sub-transactions err := saga.Submit() ``` ### Complete example diff --git a/README.md b/README.md index f4bf513..2f2fa1f 100644 --- a/README.md +++ b/README.md @@ -55,14 +55,15 @@ DTM是首款golang的开源分布式事务管理器，优雅的解决了幂等 ``` GO // 具体业务微服务地址 const qsBusi = "http://localhost:8081/api/busi_saga" - req := &gin.H{"amount": 30} // 微服务的载荷 - // DtmServer为DTM服务的地址，是一个url - saga := dtmcli.NewSaga("http://localhost:8080/api/dtmsvr"). - // 添加一个TransOut的子事务，正向操作为url: qsBusi+"/TransOut"， 补偿操作为url: qsBusi+"/TransOutCompensate" - Add(qsBusi+"/TransOut", qsBusi+"/TransOutCompensate", req). - // 添加一个TransIn的子事务，正向操作为url: qsBusi+"/TransOut"， 补偿操作为url: qsBusi+"/TransInCompensate" - Add(qsBusi+"/TransIn", qsBusi+"/TransInCompensate", req) - // 提交saga事务，dtm会完成所有的子事务/回滚所有的子事务 + req := &gin.H{"amount": 30} // 微服务的载荷 + // DtmServer为DTM服务的地址，是一个url + DtmServer := "http://localhost:8080/api/dtmsvr" + saga := dtmcli.NewSaga(DtmServer, dtmcli.MustGenGid(DtmServer)). + // 添加一个TransOut的子事务，正向操作为url: qsBusi+"/TransOut"， 补偿操作为url: qsBusi+"/TransOutCompensate" + Add(qsBusi+"/TransOut", qsBusi+"/TransOutCompensate", req). + // 添加一个TransIn的子事务，正向操作为url: qsBusi+"/TransOut"， 补偿操作为url: qsBusi+"/TransInCompensate" + Add(qsBusi+"/TransIn", qsBusi+"/TransInCompensate", req) + // 提交saga事务，dtm会完成所有的子事务/回滚所有的子事务 err := saga.Submit() ``` diff --git a/go.mod b/go.mod index a8e3f1d..90e21d0 100644 --- a/go.mod +++ b/go.mod @@ -7,7 +7,7 @@ require ( github.com/gin-gonic/gin v1.6.3 github.com/go-playground/assert/v2 v2.0.1 github.com/go-resty/resty/v2 v2.6.0 - github.com/json-iterator/go v1.1.10 + github.com/json-iterator/go v1.1.10 // indirect github.com/kr/pretty v0.1.0 // indirect github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect github.com/modern-go/reflect2 v1.0.1 // indirect diff --git a/go.sum b/go.sum index c75d67a..6ee955e 100644 --- a/go.sum +++ b/go.sum @@ -91,8 +91,5 @@ gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C gorm.io/driver/mysql v1.0.3 h1:+JKBYPfn1tygR1/of/Fh2T8iwuVwzt+PEJmKaXzMQXg= gorm.io/driver/mysql v1.0.3/go.mod h1:twGxftLBlFgNVNakL7F+P/x9oYqoymG3YYT8cAfI9oI= gorm.io/gorm v1.20.4/go.mod h1:0HFTzE/SqkGTzK6TlDPPQbAYCluiVvhzoA1+aVyzenw= -gorm.io/gorm v1.20.12 h1:ebZ5KrSHzet+sqOCVdH9mTjW91L298nX3v5lVxAzSUY= -gorm.io/gorm v1.20.12/go.mod h1:0HFTzE/SqkGTzK6TlDPPQbAYCluiVvhzoA1+aVyzenw= gorm.io/gorm v1.21.12 h1:3fQM0Eiz7jcJEhPggHEpoYnsGZqynMzverL77DV40RM= gorm.io/gorm v1.21.12/go.mod h1:F+OptMscr0P2F2qU97WT1WimdH9GaQPoDW7AYd5i2Y0= - From 6fddbd73277cad3a2f1685e72f55b5ff9216fd8d Mon Sep 17 00:00:00 2001 From: yedf2 <120050102@qq.com> Date: Fri, 23 Jul 2021 19:50:12 +0800 Subject: [PATCH 2/3] update readme --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2f2fa1f..309af5a 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ # GO语言分布式事务管理服务 -DTM是首款golang的开源分布式事务管理器，优雅的解决了幂等、空补偿、悬挂等分布式事务难题。提供了高性能和简单易用的分布式事务解决方案。 +DTM是首款golang的开源分布式事务管理器，优雅的解决了幂等、空补偿、悬挂等分布式事务难题。提供了简单易用、高性能、易水平扩展的分布式事务解决方案。 受邀参加中国数据库大会分享[多语言环境下分布式事务实践](http://dtcc.it168.com/yicheng.html#b9) @@ -24,7 +24,7 @@ DTM是首款golang的开源分布式事务管理器，优雅的解决了幂等 |异常处理| [子事务屏障自动处理](https://zhuanlan.zhihu.com/p/388444465)|手动处理 |dtm解决了幂等、悬挂、空补偿| | TCC事务| ✓|✓|| | XA事务|✓|✓|| -|AT事务|✗|✓|AT与XA类似，性能更好| +|AT事务|✗|✓|AT与XA类似，性能更好，但有脏回滚| | SAGA事务 | 简单模式 | 状态机复杂模式 |dtm的状态机模式在规划中| |事务消息|✓|✗|dtm提供类似rocketmq的事务消息| |通信协议|HTTP|dubbo等协议，无HTTP|dtm后续将支持grpc类协议| From bd589bb04ff644551edbf14639034da0a4a189b7 Mon Sep 17 00:00:00 2001 From: yedf2 <120050102@qq.com> Date: Sat, 24 Jul 2021 15:24:57 +0800 Subject: [PATCH 3/3] update readme add bright spots --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 309af5a..c05241d 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,19 @@ DTM是首款golang的开源分布式事务管理器，优雅的解决了幂等 受邀参加中国数据库大会分享[多语言环境下分布式事务实践](http://dtcc.it168.com/yicheng.html#b9) +## 亮点 + +* 极易接入 + - 支持HTTP，提供非常简单的接口，极大降低上手分布式事务的难度，新手也能快速接入 +* 使用简单 + - 开发者不再担心悬挂、空补偿、幂等各类问题，框架层代为处理 +* 跨语言 + - 可适合多语言栈的公司使用。方便go、python、php、nodejs、ruby各类语言使用。 +* 易部署、易扩展 + - 仅依赖mysql，部署简单，易集群化，易水平扩展 +* 多种分布式事务协议支持 + - TCC、SAGA、XA、事务消息 + ## 与其他框架对比 目前开源的分布式事务框架，暂未看到非Java语言有成熟的框架。而Java语言的较多，有阿里的SEATA、华为的ServiceComb-Pack，京东的shardingsphere，以及himly，tcc-transaction，ByteTCC等等，其中以seata应用最为广泛。