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 }
复制代码

 

posted @ 2018-10-14 14:41  夏威夷8080  阅读(846)  评论(0编辑  收藏  举报