引入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 }