本节,我们介绍的是ZkClient和Curator两个开源的zookeeper客户端产品。
好,首先我们创建一个maven工程,将jar引进来,下面是maven的依赖:
<dependencies>
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>3.4.6</version>
</dependency>
<dependency>
<groupId>com.github.sgroschupf</groupId>
<artifactId>zkclient</artifactId>
<version>0.1</version>
</dependency>
</dependencies>
(1)zkServers 指的是zk的服务器列表,由英文状态逗号分开的host:port字符串组成,每一个都代表一台zk机器,例如192,168,11,160:2181,192,168,11,161:2181...
(2)sessionTimeout 会话超时时间,单位为毫秒,默认为30000ms
(3)connectionTimeout 连接创建的超市时间,单位为毫秒,此参数表明如果在这个时间段内还是无法和zk建立连接,那么就放弃连接直接抛出异常
(4)connection IZKConnection 接口的实现类
(5)zkSerializer 自定义的序列化器
在使用zk的api创建连接的时候我们知道,创建连接的过程是一个异步过程,我们需要自己通过线程阻塞来监听链接是否创建成功,而在zkclient里,将异步方式转为了同步方式。这样会更加方便。
IZKconnection接口。这个接口是对zk原生接口最直接的包装,也是和zk最直接的交互层,里面包含了增,删,改,查等接口。zkClient有两种实现方式分别是ZkConnection和InMemoryConnection ,而ZkConnection是常用的。
ZkSerializer接口。这个接口是用来完成data数据序列化用的,默认情况下zkc使用java自带的序列化方式对对象进行序列化。
在zkclient的构造方法里我们没有找到对watcher的传入,那如何实现监听呢,zkclient使用listener来实现watcher注册。下面的代码就可以完成一个zkclient的创建:
public static void main(String[] args) {
ZkClient zk = new ZkClient("192.168.11.160:2181", 5000);
System.out.println(zk.getChildren("/root"));
}
2、创建节点
(1)path 节点路径 (2)data 数据 (3)mode 节点类型 (4)cal 权限策略 (5)callback 异步回调函数 (6)context 上下文对象 (7)createParents 指定是否创建父节点
在这些参数里,和zk自带的api都差不多,其中data因为有了自定义的序列化工具,所以可以传入更为复杂的对象,而新增的createParents参数的作用是可以帮助我们自动的创建父节点,省去了我们要手动的判断其父节点是否存在的麻烦。例如:
public static void main(String[] args) {
ZkClient zk = new ZkClient("192.168.11.160:2181", 5000);
zk.createPersistent("/root/apps/test/test", true);
}
效果如下:
3、删除节点
刚才我们创建了一个永久的节点,下面我们来使用delete方法删除这个节点
ZkClient zk = new ZkClient("192.168.11.160:2181", 5000);
zk.delete("/root/apps/test");
但还有一个方法:deleteRecursive 这个方法可以帮助我们逐层遍历删除节点的工作。
4、获取节点,注册监听
这个方法没有注册watcher,所以我们现在先讲一个如何注册listener。下面这个listener接口可以完成节点的监听。
问题是我们如何将这个监听器注册呢,我们可以使用subscribeChildChanges方法完成注册,下面我们来看一下demo:
public class MyZkChildListener implements IZkChildListener{
/**
* parentPath 子节点变更通知对应的父节点的节点路径
* currentChilds 子节点的相对路径列表 如果没有子节点 则为null
*/
public void handleChildChange(String parentPath, List<String> currentChilds)
throws Exception {
System.out.println("parentPath:"+parentPath+",currentChilds:"+currentChilds);
}
}
问题是我们如何将这个监听器注册呢,我们可以使用subscribeChildChanges方法完成注册,下面我们来看一下demo:问题是我们如何将这个监听器注册呢,我们可以使用subscribeChildChanges方法完成注册,下面我们来看一下demo:
public class ZkClientTest {
static String servers = "192.168.11.160:2181,192.168.11.161:2181";
static String rootPath = "/root/apps";
public static void main(String[] args) {
ZkClient zkClient = new ZkClient(servers, 5000);
zkClient.subscribeChildChanges(rootPath,new MyZkChildListener());
try {
zkClient.createPersistent(rootPath + "/test1");
Thread.sleep(1000);
zkClient.createPersistent(rootPath + "/test2");
Thread.sleep(1000);
zkClient.delete(rootPath + "/test1");
Thread.sleep(1000);
zkClient.delete(rootPath + "/test2");
Thread.sleep(1000);
} catch (Exception e) {
e.printStackTrace();
}
}
}
(1)客户端可以对一个不存在的节点进行子节点变更的监听
(2)一旦客户端对一个节点注册了子节点列表变更监听之后,那么该节点的字节列表发生变化的时候,服务端都会通知客户端,并将最新的子节点列表发送给客户端。
(3)该节点本身的创建或删除会通知到客户端。
(4)listener只需要注册一次会一直生效。
5、获取与更新数据
(1)returnNullIfPathNotExists 默认情况下 在调用这个方法的时候 如果指定的节点不存在会抛出异常,如果设置了这个参数 如果节点不存在就返回null 而不会抛出异常
(2)stat 指定数据节点的节点状态信息 用户是在接口中传入一个旧的stat变量 该stat变量会在方法执行过程中被来自服务器响应的新的stat对象替换。
来看一下DEMO案例
public class ZkClientTest {
static String servers = "192.168.11.160:2181,192.168.11.161:2181/root/apps";
static String rootPath = "/root/apps";
public static void main(String[] args) {
ZkClient zkClient = new ZkClient(servers, 5000);
zkClient.subscribeDataChanges("/name1",new IZkDataListener() {
/**
* 数据被删除时触发
*/
public void handleDataDeleted(String dataPath) throws Exception {
System.out.println("节点数据被删除:"+dataPath);
}
/**
* 数据被修改时触发
*/
public void handleDataChange(String dataPath, Object data) throws Exception {
System.out.println("节点数据被修改:"+dataPath+",获取数据:"+data);
}
});
try {
User user = new User();
user.setCode(200);
user.setName("吕鹏");
zkClient.create("/name1", user, CreateMode.EPHEMERAL);
User data = zkClient.readData("/name1");
Thread.sleep(1000);
User user2 = new User();
user2.setCode(200);
user2.setName("熊哥");
zkClient.writeData("/name1",user2);
Thread.sleep(1000);
zkClient.delete("/name1");
Thread.sleep(1000);
} catch (Exception e) {
e.printStackTrace();
}
}
}