Zookeeper 客户端API调用示例(基本使用，增删改查znode数据，监听znode，其它案例，其它网络参考资料)

9.1 基本使用

org.apache.zookeeper.Zookeeper是客户端入口主类，负责建立与server的会话

它提供以下几类主要方法  ：

功能	描述
create	在本地目录树中创建一个节点
delete	删除一个节点
exists	测试本地是否存在目标节点
get/set data	从目标节点上读取 / 写数据
get/set ACL	获取 / 设置目标节点访问控制列表信息
get children	检索一个子节点上的列表
sync	等待要被传送的数据

表 1 ： ZooKeeper API 描述

9.2 增删改查znode数据

;

);

11.     protected ZooKeeper zk;

12.

13.     /**

14.      * 连接zookeeper server

15.      */

16.     public void connect() throws Exception {

17.         zk = new ZooKeeper(hosts, SESSION_TIMEOUT, new ConnWatcher());

18.         // 等待连接完成

19.         connectedSignal.await();

20.     }

21.

22.     public class ConnWatcher implements Watcher {

23.         public void process(WatchedEvent event) {

24.             // 连接建立, 回调process接口时, 其event.getState()为KeeperState.SyncConnected

25.             if (event.getState() == KeeperState.SyncConnected) {

26.                 // 放开闸门, wait在connect方法上的线程将被唤醒

27.                 connectedSignal.countDown();

28.             }

29.         }

30.     }

31. }

创建znode

ZooKeeper对象的create方法用于创建znode.

1.  String create(String path, byte[] data, List acl, CreateMode createMode);

以下为各个参数的详细说明:

·         path. znode的路径.

·         data. 与znode关联的数据.

·         acl. 指定权限信息, 如果不想指定权限, 可以传入Ids.OPEN_ACL_UNSAFE.

·         指定znode类型. CreateMode是一个枚举类, 从中选择一个成员传入即可. 关于znode类型的详细说明, 可参考本人的上一篇博文.

1.  /**

2.   * 创建临时节点

3.   */

4.  public void create(String nodePath, byte[] data) throws Exception {

5.      zk.create(nodePath, data, Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL);

6.  }

获取子node列表

ZooKeeper对象的getChildren方法用于获取子node列表.

1.  List getChildren(String path, boolean watch);

watch参数用于指定是否监听path node的子node的增加和删除事件, 以及path node本身的删除事件.

判断znode是否存在

ZooKeeper对象的exists方法用于判断指定znode是否存在.

1.  Stat exists(String path, boolean watch);

watch参数用于指定是否监听path node的创建, 删除事件, 以及数据更新事件. 如果该node存在, 则返回该node的状态信息, 否则返回null.

获取node中关联的数据

ZooKeeper对象的getData方法用于获取node关联的数据.

1.  byte[] getData(String path, boolean watch, Stat stat);

watch参数用于指定是否监听path node的删除事件, 以及数据更新事件, 注意, 不监听path node的创建事件, 因为如果path node不存在, 该方法将抛出KeeperException.NoNodeException异常.
stat参数是个传出参数, getData方法会将path node的状态信息设置到该参数中.

更新node中关联的数据

ZooKeeper对象的setData方法用于更新node关联的数据.

1.  Stat setData(final String path, byte data[], int version);

data为待更新的数据.
version参数指定要更新的数据的版本, 如果version和真实的版本不同, 更新操作将失败. 指定version为-1则忽略版本检查.
返回path node的状态信息.

删除znode

ZooKeeper对象的delete方法用于删除znode.

1.  void delete(final String path, int version);

version参数的作用同setData方法.

其余接口

请查看ZooKeeper对象的API文档.

需要注意的几个地方

·         znode中关联的数据不能超过1M. zookeeper的使命是分布式协作, 而不是数据存储.

·         getChildren, getData, exists方法可指定是否监听相应的事件. 而create, delete, setData方法则会触发相应的事件的发生.

·         以上介绍的几个方法大多存在其异步的重载方法, 具体请查看API说明.