ByteTCC 分布式事务管理器快速入门指南

本文档将指导你了解并设置基于TCC机制的ByteTCC分布式事务管理器。

1. 项目目录结构及介绍

ByteTCC/
├── idea/                # IDEA 工程配置文件
├── bytetcc-common/      # 公共模块，包括核心接口定义
├── bytetcc-core/        # 核心模块，实现TCC事务协调器
├── bytetcc-supports-dubbo   # Dubbo适配模块
├── bytetcc-supports-springboot  # Spring Boot支持模块
└── bytetcc-supports-springcloud  # Spring Cloud支持模块

• bytecc-common 包含TCC模式下的通用接口和异常类。
• bytecc-core 提供了TCC事务处理器和相关的基础组件。
• bytecc-supports-dubbo 适配Dubbo服务，使得服务端能够处理TCC事务。
• bytecc-supports-springboot 和 bytecc-supports-springcloud 分别为Spring Boot和Spring Cloud应用提供了集成方案。

2. 项目的启动文件介绍

在实际的应用中，ByteTCC通常作为服务端的一个组件运行，因此启动文件通常是应用程序中的主类，例如在Spring Boot应用中：

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.bytesoft.tcc.ApplicationConfigurer;

@SpringBootApplication
public class MyApplication {

    public static void main(String[] args) {
        // 配置TCC事务管理器
        ApplicationConfigurer.configurer()
            .withTransactionManager("byteTcc")
            .register();
        
        SpringApplication.run(MyApplication.class, args);
    }

}

这里的关键是调用ApplicationConfigurer来配置并注册TCC事务管理器。

3. 项目的配置文件介绍

Spring Boot 示例

在Spring Boot应用中，你可以通过application.yml或application.properties来配置ByteTCC:

application.yml

tcc:
  transaction-manager-id: byteTcc
  registry:
    type: zookeeper
    address: localhost:2181
  service:
    timeout: 3000       # 服务调用超时时间（毫秒）
    retry-times: 2       # 重试次数

application.properties

tcc.transaction-manager-id=byteTcc
tcc.registry.type=zookeeper
tcc.registry.address=localhost:2181
tcc.service.timeout=3000
tcc.service.retry-times=2

配置项解释：

• tcc.transaction-manager-id：指定事务管理器的ID。
• tcc.registry.type：注册中心类型，例如zookeeper。
• tcc.registry.address：注册中心地址。
• tcc.service.timeout：服务调用的超时时间。
• tcc.service.retry-times：服务调用失败后的重试次数。

完成上述步骤后，你的应用就可以利用ByteTCC来处理分布式事务了。如有疑问，可参考官方文档User Guide，或加入开发者QQ群讨论。