简体中文 | English
dtm 有许多示例，帮助大家快速上手分布式事务
- quick-start-sample: dtm的快速开始使用示例，包括HTTP以及gRPC协议的最简用法
- dtm-examples: 项目含大量示例，主要演示了dtm SDK的各种用法。
- dtm-cases：包含多个项目，主要演示dtm在部分领域的完整应用，例如订单系统，秒杀系统。
- dtmdriver-clients：包含dtm对微服务框架的支持，例如go-zero的示例
您要运行这里的例子，需要首先运行dtm服务器，运行的方式，可以选择最常见的源码运行方式：
git clone https://github.com/dtm-labs/dtm && cd dtm
go run main.go成功运行后，dtm会在本地监听两个端口，36789的HTTP，和36790的gRPC
您还可以使用其他多种方式，具体参考运行dtm服务
我们从一个最简单的quick-start开始我们的第一个例子，下面的命令可以运行它
git clone https://github.com/dtm-labs/dtm-examples && cd dtm-examples
go run main.go qs
运行上述这个例子中，可以看到输出TransOut TransIn，那么一个跨行转账的分布式事务，包含了转出和转入两个子事务，就已经成功完成
当您运行完上述例子，有了最初的概念之后，下面我们来详细讲解更多的例子。
examples里面的例子中，quick_start做成了完全独立不共享代码的应用，这样方便使用者快速复制出代码，然后进行修改并上线自己的应用。其他的例子则封装可能会多一些，但原理与quick_start是近似的，用户需要详细研究的话，自己跟踪调试一下代码即可。
例子分为多个维度，包括协议、事务模式、数据库等，你可以运行如下命令，查看所有的示例名称：
go run main.godtm支持http协议和gRPC协议
- HTTP协议：dtm服务器会监听HTTP端口36789，这里的例子业务会监听HTTP 8081
- gRPC协议：dtm服务器会监听gRPC端口36790，这里的例子业务会监听gRPC 58081
在所有的例子中，都会带上协议的名称，是http或grpc，您可以根据您的需要进行选择
dtm支持多种事务模式，在所有的例子中，都会带上事务模式的名称，分别如下，您可以根据您的需要进行选择
- msg：二阶段消息，适合不需要回滚的全局事务
- saga：适合需要支持回滚的全局事务
- tcc：适合一致性要求较高的全局事务
- xa：适合性能要求不高，没有行锁争抢的全局事务
如果您对这些事务模式还不够熟悉，可以参考dtm.pub中的相关讲解
分布式事务通常是要将多个本地事务组合成一个整体全局事务，因此大量的实际业务是带着数据库的。dtm也首创了子事务屏障，帮助用户更好的解决空补偿、悬挂、幂等相关问题。
在带有barrier的示例中，会演示与数据库相关的技巧。dtm提供了一个示例mysql供大家使用，省去大家配置数据库的麻烦。
如果您想要配置自己的数据库，参见dtm文档中的部署与运维
dtm 可以组合 Redis，形成一个全局事务，查找名字含有redis的例子即可
dtm 可以组合 Mongo，形成一个全局事务，查找名字含有mongo的例子即可
dtm 可以组合 Mysql, Redis, Mongo，甚至更多的支持事务的数据库，形成一个全局事务，您可以查找名字含有multidb的例子
我们有很多例子中也演示了回滚的情况，您查找名字含有rollback的例子即可
在我们的示例中，还演示了与第三方ORM例如gorm的对接，未来会看需求给出更多第三方ORM的例子
您查找名字带有gorm的例子即可
有一部分的业务中的子事务，需要自定义header。dtm支持全局事务粒度的header定制，即您可以给各个全局事务指定自定义header，dtm调用您的子事务服务时，将会添加您指定的header
HTTP和gRPC都支持自定义header，详情可以参考名字中带有Header的例子