分布式事务 Seata 教程 - XA模式入门案例

Seata 支持多种分布式事务模型，其中 XA 模型是一种传统的两阶段提交协议，用于保证跨多个资源管理器（如不同的数据库）的事务一致性。在 XA 模型中，Seata 作为事务协调者（Transaction Coordinator, TC），负责协调各个资源管理器（Resource Manager, RM）之间的交互。

XA 模型简介

在 XA 模型中，一个全局事务包含两个阶段：

1. Prepare Phase（准备阶段）：各参与方（资源管理器）准备提交或回滚事务。
2. Commit Phase（提交阶段） 或 Rollback Phase（回滚阶段）：根据 Prepare 阶段的结果决定最终提交还是回滚。

XA 模型入门案例

接下来，我们将通过一个简单的示例来演示如何使用 Seata 的 XA 模型来实现一个分布式事务。

假设我们有两个数据库：db1 和 db2，并且我们需要在这两个数据库之间执行一个事务操作，比如转账操作。

步骤 1: 准备环境

1. 安装 Seata Server：首先需要安装并运行 Seata Server，你可以从 Seata 的 GitHub 仓库下载最新的发布版。
2. 配置 Seata Server：根据官方文档配置 Seata Server 的配置文件（config.txt）。

步骤 2: 配置客户端

1. 引入依赖：在项目中引入 Seata 的客户端依赖。
2. 配置数据源：配置两个数据库的数据源，并启用 XA 模式。

步骤 3: 编写业务逻辑

假设我们的业务逻辑是在 db1 中扣除金额，在 db2 中增加金额。

import io.seata.spring.annotation.GlobalTransactional;
import org.springframework.stereotype.Service;

@Service
public class TransferService {

    private final AccountRepository accountRepository;

    public TransferService(AccountRepository accountRepository) {
        this.accountRepository = accountRepository;
    }

    /**
     * 转账操作
     * @param fromAccountId 转出账户 ID
     * @param toAccountId 转入账户 ID
     * @param amount 金额
     */
    @GlobalTransactional(name = "transfer", transactionType = "XA")
    public void transfer(long fromAccountId, long toAccountId, double amount) {
        // 从账户扣除金额
        accountRepository.deduct(fromAccountId, amount);

        // 向账户增加金额
        accountRepository.add(toAccountId, amount);
    }
}

步骤 4: 配置 Seata Client

在 Spring Boot 项目中，你需要配置 Seata 的客户端，以使其能够与 Seata Server 通信。

@Configuration
@EnableTransactionManagement
public class SeataConfig {

    @Bean
    public DataSourceProxy dataSourceProxy(DataSource dataSource) {
        return new DataSourceProxy(dataSource);
    }

    @Bean
    public PlatformTransactionManager transactionManager(DataSourceProxy dataSourceProxy) {
        return new SeataTransactionManager(dataSourceProxy);
    }

    @Bean
    public GlobalSessionFactoryBean globalSessionFactoryBean() {
        GlobalSessionFactoryBean sessionFactory = new GlobalSessionFactoryBean();
        // 配置 Seata Server 的地址
        sessionFactory.setGlobalTransactionScanner(new GlobalTransactionScanner("myApplication", "localhost:8091"));
        return sessionFactory;
    }
}

步骤 5: 测试

现在，你可以编写测试用例来验证你的转账操作是否能够在两个数据库之间正确执行。

@RunWith(SpringRunner.class)
@SpringBootTest
public class TransferServiceTest {

    @Autowired
    private TransferService transferService;

    @Test
    public void testTransfer() {
        long fromAccountId = 1L;
        long toAccountId = 2L;
        double amount = 100.0;

        // 假设这里有一些预处理逻辑，比如检查账户余额等
        transferService.transfer(fromAccountId, toAccountId, amount);

        // 验证转账操作是否成功
        // ...
    }
}

总结

在本示例中，我们通过使用 Seata 的 XA 模式实现了一个简单的分布式事务案例。Seata 的 XA 模型要求对数据库驱动进行适配，以便支持 XA 协议。此外，还需要注意的是，虽然 XA 模型能够保证事务的一致性，但它的性能开销相对较高，特别是在网络延迟较大的情况下。因此，在选择事务模型时，需要根据具体的应用场景权衡性能与一致性之间的关系。