分布式事务管理器DTM的C客户端安装教程

1. 项目介绍

DTM（Distributed Transaction Manager）是一个分布式事务解决方案，它为跨服务的最终数据一致性提供了支持。DTM 提供了多种事务策略，包括 Saga、TCC、XA 和事务性消息等，适用于多种应用场景。此外，它支持多种语言和存储引擎，易于适配，降低分布式事务的入门门槛。

本项目是 DTM 的 C# 客户端，它包括了工作流、dtmcli 和 dtmgrpc 等功能。C# 客户端使得 .NET 程序能够轻松接入 DTM，实现分布式事务的管理。

2. 项目下载位置

您可以在 GitHub 上找到 DTM 的 C# 客户端项目，地址为：dtm-labs/client-csharp。

3. 项目安装环境配置

在开始安装之前，请确保您的开发环境已经配置以下要求：

• .NET SDK
• Git

以下是环境配置的示例图片：

注意：图片路径 image_path/example_env_config.png 需替换为实际的图片路径。

4. 项目安装方式

安装 DTM C# 客户端非常简单，您可以通过以下步骤完成：

1. 克隆项目到本地：

   git clone https://github.com/dtm-labs/client-csharp.git
   

2. 进入项目目录：

   cd client-csharp
   

3. 使用 NuGet 安装项目依赖：

   dotnet add package Dtmcli
   

5. 项目处理脚本

以下是一个使用 DTM C# 客户端实现的Saga模式示例代码：

public class MyBusi
{
    private readonly Dtmcli.IDtmTransFactory _transFactory;

    public MyBusi(Dtmcli.IDtmTransFactory transFactory)
    {
        this._transFactory = transFactory;
    }

    public async Task DoBusAsync()
    {
        var gid = Guid.NewGuid().ToString();
        var req = new BusiReq { Amount = 30 };
        var svc = "http://localhost:5005";
        var saga = _transFactory.NewSaga(gid);
        
        // 添加子事务
        saga.Add(
            // 前置操作URL
            svc + "/api/TransOut",
            // 补偿操作URL
            svc + "/api/TransOutCompensate",
            // 操作参数
            req
        );
        saga.Add(
            svc + "/api/TransIn",
            svc + "/api/TransInCompensate",
            req
        );

        await saga.Submit();
    }
}

确保您已经按照项目配置了正确的服务地址和参数，然后运行您的程序来测试 DTM 客户端的功能。