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

Curator 节点操作

Curator 节点操作

本课用一段完整代码串联递归创建、读取状态、版本化更新和保证删除。你将看到 Curator 如何减少样板代码,同时仍保留 ZooKeeper 的版本并发控制语义。

学习目标

  • 使用流式 API 创建和读取节点
  • 通过 Stat 执行版本化更新
  • 使用保证删除处理短暂连接故障

完整示例

示例会把 /demo/config/app 初始化为 v1,读取数据与版本后更新为 v2,最后删除该节点。

java
import java.nio.charset.StandardCharsets;
import java.util.concurrent.TimeUnit;
import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.CuratorFrameworkFactory;
import org.apache.curator.retry.ExponentialBackoffRetry;
import org.apache.zookeeper.data.Stat;

public class CuratorCrudDemo {
    public static void main(String[] args) throws Exception {
        try (CuratorFramework client =
                     CuratorFrameworkFactory.newClient(
                             "127.0.0.1:2181",
                             new ExponentialBackoffRetry(500, 3))) {
            client.start();
            if (!client.blockUntilConnected(5, TimeUnit.SECONDS)) {
                throw new IllegalStateException("连接 ZooKeeper 超时");
            }

            String path = "/demo/config/app";
            byte[] v1 = "v1".getBytes(StandardCharsets.UTF_8);
            if (client.checkExists().forPath(path) == null) {
                client.create().creatingParentsIfNeeded()
                        .forPath(path, v1);
            } else {
                client.setData().forPath(path, v1);
            }

            Stat stat = new Stat();
            byte[] before = client.getData()
                    .storingStatIn(stat)
                    .forPath(path);

            // 仅当读取到的版本仍然有效时才更新。
            Stat after = client.setData()
                    .withVersion(stat.getVersion())
                    .forPath(path,
                            "v2".getBytes(StandardCharsets.UTF_8));

            client.delete().guaranteed().forPath(path);

            System.out.println("before="
                    + new String(before, StandardCharsets.UTF_8));
            System.out.println("newVersion=" + after.getVersion());
            System.out.println("existsAfterDelete="
                    + (client.checkExists().forPath(path) != null));
        }
    }
}

预期输出:

text
before=v1
newVersion=<VERSION>
existsAfterDelete=false

<VERSION> 是更新后的实际版本号。由于示例每次都会先写入 v1,重复运行时版本可能继续增加。

API 语义

creatingParentsIfNeeded() 会补齐缺失父路径。storingStatIn(stat) 在读取数据时同时取得版本,withVersion 只在版本匹配时更新;其他客户端抢先修改后,当前更新会抛出 BadVersionException。

guaranteed() 表示删除因可重试连接错误未完成时,Curator 会在后台继续尝试。它只增强删除请求的可靠性,不扩大事务边界,也不能替代删除前的 ACL、路径和业务条件校验。

验证与边界

程序输出 existsAfterDelete=false 后,可再用 CLI 执行 get /demo/config/app,预期得到节点不存在错误。父节点 /demo/config 不会被级联删除,这是本例的正常结果。

若要验证版本保护,可在读取 Stat 后由另一个客户端修改节点,再执行 withVersion 更新。预期出现 BadVersionException,此时应重新读取并计算,而不是改用无版本更新。

本课总结

  • Curator 流式 API 能减少递归创建与状态读取样板代码
  • 版本化更新仍遵循 ZooKeeper 乐观并发控制
  • 保证删除只增强删除请求的重试,不扩大事务边界

下一课预告

下一课监听 Curator 的连接状态,并为暂停、恢复、会话丢失和只读模式设置不同动作。

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

目录与阅读设置

阅读设置

17

记录一个想法

Curator 节点操作

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

登录哪都通