服务注册与分布式协调 / 系统课时
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 的连接状态,并为暂停、恢复、会话丢失和只读模式设置不同动作。
按自己的节奏,确认真正理解。