Zookeeper学习笔记(二)通过Java API调用Zookeeper

一、引入依赖

<dependency>
  <groupId>org.apache.zookeeper</groupId>
  <artifactId>zookeeper</artifactId>
  <version>3.4.7</version>
</dependency>

二、常用方法简析

这里只列举了一些常用的方法，其他方法可以查看官方api：https://zookeeper.apache.org/doc/r3.4.10/api/index.html

1、Zookeeper构造方法

方法签名	参数解析
ZooKeeper(String connectString, int sessionTimeout, Watcher watcher)	connectString: 连接字符串，格式为主机：端口号，多个用逗号分隔，如：127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002 sessionTimeout： session超时时间 watcher：watcher事件通知处理
ZooKeeper(String connectString, int sessionTimeout, Watcher watcher, boolean canBeReadOnly)	canBeReadOnly:用于标识当前会话是否支持“read-only”(只读模式)。默认情况下，在Zookeeper集群中，一个机器如果和集群中过半及以上机器失去了网络连接，那么这个机器将不再处理客户端请求（包括读写请求）。但是在某些使用场景下，当ZooKeeper服务器发生此类故障的时候，我们还是希望Zookeeper服务器能够提供读服务。这就是Zookeeper的“read-only”模式。
ZooKeeper(String connectString, int sessionTimeout, Watcher watcher, long sessionId, byte[] sessionPasswd)	sessionId：会话ID sessionPasswd：会话秘钥 这两个参数能够唯一确定一个会话，同时客户端使用这两个参数可以实现客户端会话复用，从而达到恢复会话的效果。具体使用方法是，第一次连接上ZooKeeper服务器时，通过调用Zookeeper对象实例的以下两个接口，即可获得当前会话的ID和秘钥： long getSessionId(); byte[] getSessionPasswd();
ZooKeeper(String connectString, int sessionTimeout, Watcher watcher, long sessionId, byte[] sessionPasswd, boolean canBeReadOnly)

注：ZooKeeper客户端和服务端会话的建立是一个异步的过程。

2、创建节点

方法签名	参数解析
String create(final String path, byte data[], List<ACL> acl, CreateMode createMode)	返回创建的节点的实际路径 path：路径 data： 数据 acl：节点的ACL策略 createMode ：创建模式                 PERSISTENT  持久化目录节点 PERSISTENT_SEQUENTIAL  顺序自动编号的目录节点，这种目录节点会根据当前已近存在的节点数自动加 1 EPHEMERAL 临时目录节点，一旦创建这个节点的客户端与服务器端口也就是 session 超时，这种节点会被自动删除 EPHEMERAL_SEQUENTIAL  临时自动编号节点
void  create(String path, byte[] data, List<ACL> acl, CreateMode createMode, AsyncCallback.StringCallback cb, Object ctx)	异步的创建节点的方法 cb: 一个异步回调函数 ctx: 用于传递一个对象，可以在回调方法执行的时候使用，通常是放一个上下文（Context）信息

3、判断节点是否存在

方法签名	参数解析
Stat exists(String path, Watcher watcher)	path:节点路径 watcher:注册的Watcher，用于监听以下三类事件： 节点被创建 节点被删除 节点被更新
Stat exists(String path, boolean watch)	watcher:指定是否复用ZooKeeper中默认的Watcher
void exists(String path, Watcher watcher, AsyncCallback.StatCallback cb, Object ctx)	异步的判断节点是否存在的方法     cb:注册一个异步回调函数 ctx:用于传递上下文信息的对象
void exists(String path, boolean watch, AsyncCallback.StatCallback cb, Object ctx)	异步的判断节点是否存在的方法

4、设置数据      

方法签名	参数解析
Stat setData(String path, byte[] data, int version)	path:节点路径 data:数据 version：节点的版本，只有版本匹配上了才会修改。-1表示匹配所有版本
void setData(String path, byte[] data, int version, AsyncCallback.StatCallback cb, Object ctx)	异步的设置数据的方法

5、获取数据

方法签名	参数解析
void getData(String path, boolean watch, AsyncCallback.DataCallback cb, Object ctx)	异步的获取数据的方法
byte[] getData(String path, boolean watch, Stat stat)
void getData(String path, Watcher watcher, AsyncCallback.DataCallback cb, Object ctx)	异步的获取数据的方法
byte[] getData(String path, Watcher watcher, Stat stat)

6、删除节点

方法签名	参数解析
void  delete(String path, int version)	path:节点路径 version：节点的版本，只有版本匹配上了才会删除。-1表示匹配所有版本
void delete(String path, int version, AsyncCallback.VoidCallback cb, Object ctx)	异步的删除节点的方法

三、示例

package com.my.zktest;

import org.apache.zookeeper.*;

/**
 * Title: <br/>
 * Intention: <br/>
 * <p>
 * Class Name: com.my.zktest.TestZookeeper<br/>
 * Create Date: 2017/8/1 23:42 <br/>
 * Project Name: MyTest <br/>
 * Company:  All Rights Reserved. <br/>
 * Copyright © 2017 <br/>
 * </p>
 * <p>
 * author: GaoWei <br/>
 * 1st_examiner: <br/>
 * 2nd_examiner: <br/>
 * </p>
 *
 * @version 1.0
 * @since JDK 1.7
 */
public class TestZookeeper {

	public static void main(String[] args) throws Exception{
		ZooKeeper zk = new ZooKeeper("127.0.0.1:2181", 100, new Watcher() {
			public void process(WatchedEvent event) {
				System.out.println("node changes");
			}
		});
		String path = "/fruit";
		String returnPath = zk.create(path, "banana".getBytes("UTF-8"), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT);
		System.out.println("returnPath="+returnPath);
		System.out.println("创建节点" + path + ",数据为:" + new String(zk.getData(path, null, null), "UTF-8"));
		zk.setData(path, "orange".getBytes(), -1);
	}
}

参考：

1、http://ifeve.com/zookeeper-talk-quick-start/

2、http://www.cnblogs.com/ggjucheng/p/3370359.html

3、从PAXOS到ZOOKEEPER分布式一致性原理与实践.