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

一次性 Watch

一次性 Watch

本课解决“注册一次监听为何只收到一次通知”的问题。你将掌握存在性、数据和子节点三类 Watch 的注册方式,并把事件当作重新读取状态的信号,而不是完整变更记录。

学习目标

  • 选择 exists、getData 和 getChildren 对应的 Watch
  • 理解标准 Watch 的一次触发语义
  • 在事件到达后重新读取权威状态

三类读取与事件范围

exists 可监听节点创建、删除和数据变化;getData 可监听数据变化与节点删除;getChildren 可监听直接子节点列表变化与父节点删除。监听由读取操作附带注册,不需要单独的轮询线程。

一次性 Watch 注册与触发关系

标准 Watch 是一次性触发器。节点第一次发生匹配变化后,服务端发送事件并移除该注册;同一路径再次变化时,除非客户端重新读取并注册,否则不会再次通知。

注册数据 Watch

片段示例:假设 zk 已连接且 /app/config 已存在。

java
import java.nio.charset.StandardCharsets;
import org.apache.zookeeper.WatchedEvent;
import org.apache.zookeeper.Watcher;
import org.apache.zookeeper.data.Stat;

Watcher watcher = (WatchedEvent event) ->
    System.out.println(
        "type=" + event.getType() + ", path=" + event.getPath()
    );

Stat stat = new Stat();
byte[] data = zk.getData("/app/config", watcher, stat);

System.out.println("value=" + new String(data, StandardCharsets.UTF_8));
System.out.println("version=" + stat.getVersion());

若初始值为 v1,随后其他客户端更新一次,预期结果类似:

text
value=v1
version=<CURRENT_VERSION>
type=NodeDataChanged, path=/app/config

<CURRENT_VERSION> 取决于此前更新次数。再次修改节点时,这个 Watch 不会再次触发。

事件不是数据内容

Watch 事件主要告诉客户端“某个路径可能变化了”,不会携带完整的新数据。回调收到 NodeDataChanged 后应再次执行 getData,同时完成下一次监听注册。

如果只在事件对象上累加业务变化,可能遗漏断线期间或重注册窗口内发生的多次更新。正确模型是“事件用于失效本地缓存,读取用于获得最终状态”。

使用时的边界

Watch 回调由客户端事件线程执行,不应在其中进行长时间阻塞、远程调用或复杂计算。可以快速投递到业务线程池,再进行读取和状态更新。

断线期间不会实时收到节点事件。恢复连接后应刷新关键路径,不能把“没有收到事件”解释为“数据没有变化”。

本课总结

  • 三种读取操作覆盖存在性、数据和直接子节点变化
  • 标准 Watch 触发一次后即失效,后续监听必须重新注册
  • Watch 是变化提示,业务状态必须通过重新读取确认

下一课预告

下一课将实现事件后的读取与重注册,并分析监听窗口中多次变化被合并的竞态。

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

目录与阅读设置

阅读设置

17

记录一个想法

一次性 Watch

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

登录哪都通