服务注册与分布式协调 / 系统课时

Curator 事务

Curator 事务

Curator 事务把多个 ZooKeeper 写操作一次性提交:只要其中任意检查或写入失败,整组操作都不会部分生效。本篇用 transactionOp() 组合检查、创建、更新和删除,并通过版本冲突验证原子回滚。

学习目标

  • 使用 TransactionOp 构造 check、create、setData 与 delete
  • 用版本号把并发检查和数据修改放进同一个原子提交
  • 根据提交结果和失败后的节点状态验证事务是否真正原子

事务 API 的本质

Curator 的现代事务 API 分两步:先用 client.transactionOp() 把每个动作构造成 CuratorOp,再交给 client.transaction().forOperations(...) 一次提交。底层对应 ZooKeeper 的 multi 操作,因此“构造操作”本身不会立刻修改节点。

check 很适合做乐观并发控制。把读取到的 ZNode 版本带入事务后,只有版本仍然匹配时,后续创建、更新、删除才会一起提交;如果版本已经变化,ZooKeeper 会拒绝整个事务,而不是只拒绝其中一条。

Curator 事务原子提交链路

构建包含四类操作的事务

下面示例假设本机已有可连接的 ZooKeeper,连接串默认是 127.0.0.1:2181,也可以把实际连接串作为第一个命令行参数传入。示例先准备两个节点,再在一个事务中完成版本检查、审计节点创建、配置更新和旧节点删除。

java
import java.nio.charset.StandardCharsets;
import java.util.List;
import java.util.concurrent.TimeUnit;

import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.CuratorFrameworkFactory;
import org.apache.curator.framework.api.transaction.CuratorOp;
import org.apache.curator.framework.api.transaction.CuratorTransactionResult;
import org.apache.curator.framework.api.transaction.TransactionOp;
import org.apache.curator.retry.ExponentialBackoffRetry;
import org.apache.zookeeper.KeeperException;
import org.apache.zookeeper.data.Stat;

public class CuratorTransactionDemo {
    private static final String ROOT = "/tx-demo";

    public static void main(String[] args) throws Exception {
        String connectString = args.length > 0 ? args[0] : "127.0.0.1:2181";

        try (CuratorFramework client = CuratorFrameworkFactory.newClient(
                connectString, new ExponentialBackoffRetry(1000, 3))) {
            client.start();
            if (!client.blockUntilConnected(5, TimeUnit.SECONDS)) {
                throw new IllegalStateException("ZooKeeper connection timeout");
            }

            if (client.checkExists().forPath(ROOT) != null) {
                client.delete().deletingChildrenIfNeeded().forPath(ROOT);
            }
            client.create().forPath(ROOT);
            client.create().forPath(ROOT + "/config", bytes("v1"));
            client.create().forPath(ROOT + "/obsolete", bytes("old"));

            Stat stat = client.checkExists().forPath(ROOT + "/config");
            int expectedVersion = stat.getVersion();

            TransactionOp op = client.transactionOp();
            CuratorOp check = op.check()
                    .withVersion(expectedVersion)
                    .forPath(ROOT + "/config");
            CuratorOp create = op.create()
                    .forPath(ROOT + "/audit", bytes("created"));
            CuratorOp update = op.setData()
                    .withVersion(expectedVersion)
                    .forPath(ROOT + "/config", bytes("v2"));
            CuratorOp delete = op.delete()
                    .withVersion(0)
                    .forPath(ROOT + "/obsolete");

            List<CuratorTransactionResult> results =
                    client.transaction().forOperations(check, create, update, delete);

            System.out.println("committed operations=" + results.size());
            System.out.println("config=" + text(client.getData().forPath(ROOT + "/config")));
            System.out.println("audit=" + (client.checkExists().forPath(ROOT + "/audit") != null));
            System.out.println("obsolete=" + (client.checkExists().forPath(ROOT + "/obsolete") != null));

            // 仍使用旧版本号,故意制造版本冲突;后面的 create 也必须回滚。
            CuratorOp staleCheck = op.check()
                    .withVersion(expectedVersion)
                    .forPath(ROOT + "/config");
            CuratorOp shouldRollback = op.create()
                    .forPath(ROOT + "/should-not-exist", bytes("x"));

            try {
                client.transaction().forOperations(staleCheck, shouldRollback);
            } catch (KeeperException.BadVersionException e) {
                System.out.println("failure=" + e.getClass().getSimpleName());
            }

            System.out.println("rollback node=" +
                    (client.checkExists().forPath(ROOT + "/should-not-exist") != null));
            System.out.println("config after failure=" +
                    text(client.getData().forPath(ROOT + "/config")));
        }
    }

    private static byte[] bytes(String value) {
        return value.getBytes(StandardCharsets.UTF_8);
    }

    private static String text(byte[] value) {
        return new String(value, StandardCharsets.UTF_8);
    }
}

预期输出

text
committed operations=4
config=v2
audit=true
obsolete=false
failure=BadVersionException
rollback node=false
config after failure=v2

如果使用的连接地址、会话建立时间或服务器日志不同,实际环境信息会变化,但以上业务输出应保持一致。

版本检查与失败边界

事务里的 withVersion(expectedVersion) 不是装饰信息,而是并发条件。读取 Stat.version 后,若另一个客户端先修改了该节点,原事务中的 check 或 setData 会触发 BadVersionException,后续操作不会留下半完成状态。

需要注意,事务只能保证同一个 ZooKeeper 集群内这组 ZNode 操作的原子性。它不能把数据库写入、HTTP 调用、消息发送等外部副作用一起纳入 ZooKeeper 事务;这类跨系统一致性仍要由业务协议补偿或重新设计。

当一组协调状态必须“一起成功或一起失败”,并且这些状态都位于 ZooKeeper 中时,Curator 事务能把版本校验与多节点修改合并成一个清晰的原子边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Curator 事务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通