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

创建 Curator 客户端

创建 Curator 客户端

本课创建一个可运行的 CuratorFramework 客户端,配置连接串、会话超时、连接超时、重试策略和命名空间,并通过写入健康节点验证配置是否生效。

学习目标

  • 使用 Builder 创建 Curator 客户端
  • 正确区分会话超时与连接超时
  • 理解命名空间对逻辑路径的映射

关键参数

连接串可包含多个 host:port。会话超时决定失联多久后会话可能失效;连接超时限制单次建立连接的等待时间。重试策略负责短暂连接故障后的再次尝试,但不会修复路径、权限或版本错误。

命名空间会为业务路径统一添加前缀。代码中的 /health 会映射为集群中的 /demo-app/health,业务代码无需在每次调用时重复拼接前缀。

完整示例

示例假设 ZooKeeper 运行在 127.0.0.1:2181,并且项目已引入 curator-framework。

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;

public class CuratorClientDemo {
    public static void main(String[] args) throws Exception {
        try (CuratorFramework client = CuratorFrameworkFactory.builder()
                .connectString("127.0.0.1:2181")
                .sessionTimeoutMs(15_000)
                .connectionTimeoutMs(5_000)
                .retryPolicy(new ExponentialBackoffRetry(500, 3))
                .namespace("demo-app")
                .build()) {

            client.start();
            if (!client.blockUntilConnected(5, TimeUnit.SECONDS)) {
                throw new IllegalStateException("连接 ZooKeeper 超时");
            }

            String path = "/health";
            byte[] data = "ok".getBytes(StandardCharsets.UTF_8);
            if (client.checkExists().forPath(path) == null) {
                client.create().creatingParentsIfNeeded()
                        .forPath(path, data);
            } else {
                client.setData().forPath(path, data);
            }

            byte[] stored = client.getData().forPath(path);
            System.out.println("connected=true");
            System.out.println("logicalPath=" + path);
            System.out.println("physicalPath=/demo-app" + path);
            System.out.println("data="
                    + new String(stored, StandardCharsets.UTF_8));
        }
    }
}

预期输出:

text
connected=true
logicalPath=/health
physicalPath=/demo-app/health
data=ok

启动与验证

build() 只创建客户端对象,必须调用 start() 才会开始连接。blockUntilConnected 应设置等待上限;超时后要终止初始化,不能继续向业务层暴露未就绪客户端。

运行程序后,可使用 ZooKeeper CLI 执行以下命令验证物理路径。实际 CLI 启动命令取决于安装目录。

bash
get /demo-app/health

预期结果:

text
ok

命名空间只改变客户端看到的路径,不是权限隔离。不同应用仍应配置独立 ACL,避免仅依赖路径前缀保护数据。

本课总结

  • Builder 用于集中配置连接、超时、重试和命名空间
  • start() 后客户端才开始连接,等待就绪必须设置上限
  • 命名空间统一路径前缀,但不能代替 ACL

下一课预告

下一课比较固定次数、固定间隔和指数退避策略,并确定哪些错误不应进入重试。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建 Curator 客户端

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

登录哪都通