服务注册与分布式协调 / 系统课时
创建 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
下一课预告
下一课比较固定次数、固定间隔和指数退避策略,并确定哪些错误不应进入重试。
按自己的节奏,确认真正理解。