zookeeper（三）：java操作zookeeper

引入jar包

首先要使用java操作zookeeper，zookeeper的javaclient 使我们更轻松的去对zookeeper进行各种操作，我们引入zookeeper-3.4.5.jar 和 zkclient-0.1.jar即可。

zookeeper-3.3.4.jar 为官方提供的javaApi，zkClient-0.1jar为在源生api基础上进行扩展的开源JAVA客户端。

创建会话方法：客户端可以通过创建一个zookeeper实例来链接zookeeper服务器。

构造方法

Zookeeper(Arguments)方法(一共4个构造方法，根据参数不同)

参数说明如下：

connectString：连接服务器列表，已“，”分割。

sessionTimeOut：心跳检测时间周期(毫秒)

watcher：事件处理通知器。

canBereadOnly：标识当前会话是否支持只读。

sessionId和sessionPasswd：提供连接zookeeper的sessionId和密码，通过这两个确定唯一一台客户端，目的是可以提供重复会话

注意：zookeeper客户端和服务器端会话的建立是一个异步的过程，也就是说在程序中，我们程序方法在处理完客户端初始化后，立即返回(程序往下执行代码，这样，大多数情况下我们并没有真正构建好一个可用会话，在会话的声明周期处于"CONNECTING"时才算真正建立完毕，所以我们需要使用多线程中的一个工具类CountDownLatch)

创建节点

创建节点(znode)方法,create

提供了两套创建节点的方法，同步和异步创建节点方式。

同步方式

　　参数1，节点路径(名称)：/nodeName （不允许递归创建节点，也就是说在父节点不存在的情况下，不允许创建子节点）

　　参数2，节点内容：要求类型是字节数组 (不支持序列化方式，如果需要实现序列化，可使用java相关的序列化框架，如Hession，Kryo框架)

　　参数3，节点权限：使用Ids.OPEN_ACL_UNSAFE开发权限即可(一般在权限没有太高要求的场景下，没必要关注)

　　参数4，节点类型 创建节点的类型：CreateMode.* 提供四种节点类型

　　　　PERSISTENT (持久节点)

　　　　PERSISTENT_SEQUENTIAL(持久顺序节点)

　　　　EPHEMRAL(临时节点)

　　　　EPHEMRAL_SEQUENTIAL(临时顺序节点)

异步方式（在同步基础上增加两个参数）

　　　　参数5：注册一个异步回调函数，要实现AsynCallBack.StringCallBack接口。重写processResult(int rc,String path,Object ctx,String name) 方法，当节点创建完毕后，执行此方法。

　　　　　　1.rc:为服务端响应码， 0表示调用成功，-4表示端口连接，-110表示指定节点存在，-112表示会话已经过期

　　　　　　2.path：接口调用时传入API的数据节点的路径参数

　　　　　　3.ctx：为调用接口传入API的ctx的值

　　　　　　4.name：实际在服务器端创建节点的名称

　　　　参数6传递给回调函数的参数，一般为上下文(Context)信息　

删除节点

　　　　删除节点：delete方法(api提供了两个接口，同步删除和异步删除方式)

　　　　同步方式：

　　　　　　参数1，节点名称 /deletePath

　　　　　　参数2，版本号，即表示本次删除操作是针对该数据的某个版本进行操作。

　　　　异步方式：

　　　　　　参数3：一个异步回调函数

　　　　　　参数4：用于传递上下文信息的对象。

　　　　注意：在zookeeper中，只允许删除叶子节点信息，也就是说如果当前节点不是叶子节点则无法删除，或必须先删除其下所有的子节点，

获取子节点列表和数据

　　　　getChildren读取数据方法：包括子节点列表获取和子节点数据的获取。

　　　　参数1 path：获取指定节点下的数据(获取子节点列表）

　　　　参数2 watcher： 注册的watcher ，一旦在本次子节点获取后，子节点列表发生变更的话，那么就会向客户端发送通知，该参数允许为null

　　　　参数3 wath：表明是否需要注册一个watcher：如果为true，则会使用到zookeeper客户端上下文中提到的那个默认watcher，如果false，则表明不需要注册Watcher，

　　　　参数4 cb： 回调函数

　　　　参数5 ctx：上下文信息

　　　　参数6 stat ：指定数据节点的节点状态信息

　　注意：当我们获取指定节点的子节点列表后，还需要订阅这个子节点列表的变化通知，这时候就可以通过注册一个watcher来实现，当子节点被添加或删除时，服务器端就会触发一个“NodeChildrenChanged”类型的时间通知，需要注意的是服务端发送给客户端的事件通知中，是不包含最新的节点列表的，客户端必须主动重新进行获取，通常在客户端收到这个事件通知后，就可以再次主动获取最新的子节点列表，也就是说，zookeeper服务端在想客户端发送watcher“NodeChildrenChanged”事件通知的时候，仅仅只发了一个通知，不会把节点的变化情况发给客户端，需要客户端自己重新获取，另外Watcher通知是一次性的，即触发后失效，因此客户端需要反复注册Watcher才行。

检测节点是都存在

　　　　exists方法

　　　　参数1 path：路径

　　　　参数2 watcher ：注册的watcher对象。一旦之后节点内容有变更，则会向客户端发送通知，该参数允许为null （用于三类事件监听：节点的创建，删除，更新）

　　　　参数3 watch :是否使用watcher，如果true 则使用默认上文中的watcher，false则不使用watcher

　　　　参数4 cb：回调函数

　　　　参数5 ctx：用于传递的下文信息对象

　　注意：exists 方法意义在与无论节点是都存在，都可以进行注册watcher，能够对节点的创建，删除和修改进行监听，但是其子节点发生各种变化，都不会通知客户端。

代码示例

 1 package bjsxt.zookeeper.base;
 2
 3 import java.util.concurrent.CountDownLatch;
 4
 5 import org.apache.zookeeper.WatchedEvent;
 6 import org.apache.zookeeper.Watcher;
 7 import org.apache.zookeeper.Watcher.Event.EventType;
 8 import org.apache.zookeeper.Watcher.Event.KeeperState;
 9 import org.apache.zookeeper.ZooKeeper;
10
11 /**
12  * Zookeeper base学习笔记
13  */
14 public class ZookeeperBase {
15
16     /** zookeeper地址 */
17     static final String CONNECT_ADDR = "192.168.2.2:2181";// 集群可以写多个，英文逗号隔开
18     /** session超时时间 */
19     static final int SESSION_OUTTIME = 2000;// ms
20     /** 信号量，阻塞程序执行，用于等待zookeeper连接成功，发送成功信号 */
21     static final CountDownLatch connectedSemaphore = new CountDownLatch(1);
22
23     public static void main(String[] args) throws Exception {
24
25         ZooKeeper zk = new ZooKeeper(CONNECT_ADDR, SESSION_OUTTIME,
26                 new Watcher() {
27                     @Override
28                     public void process(WatchedEvent event) {
29                         // 获取事件的状态
30                         KeeperState keeperState = event.getState();
31                         EventType eventType = event.getType();
32                         // 如果是建立连接
33                         if (KeeperState.SyncConnected == keeperState) {
34                             if (EventType.None == eventType) {
35                                 // 如果建立连接成功，则发送信号量，让后续阻塞程序向下执行
36                                 System.out.println("zk 建立连接");
37                                 connectedSemaphore.countDown();
38                             }
39                         }
40                     }
41                 });
42
43         // 进行阻塞
44         connectedSemaphore.await();
45
46         System.out.println("..");
47         // 创建父节点
48         // zk.create("/testRoot", "testRoot".getBytes(), Ids.OPEN_ACL_UNSAFE,
49         // CreateMode.PERSISTENT);
50
51         // 创建子节点
52         // zk.create("/testRoot/children", "children data".getBytes(),
53         // Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT);
54
55         // 获取节点洗信息
56         // byte[] data = zk.getData("/testRoot", false, null);
57         // System.out.println(new String(data));
58         // System.out.println(zk.getChildren("/testRoot", false));
59
60         // 修改节点的值
61         // zk.setData("/testRoot", "modify data root".getBytes(), -1);
62         // byte[] data = zk.getData("/testRoot", false, null);
63         // System.out.println(new String(data));
64
65         // 判断节点是否存在
66         // System.out.println(zk.exists("/testRoot/children", false));
67         // 删除节点
68         // zk.delete("/testRoot/children", -1);
69         // System.out.println(zk.exists("/testRoot/children", false));
70
71         zk.close();
72
73     }
74
75 }