本文为原创文章,转载请注明出处,谢谢
ZkClient使用
1、jar包引入,演示版本为0.8,非maven项目,可以下载jar包导入到项目中
<dependency>
<groupId>com.101tec</groupId>
<artifactId>zkclient</artifactId>
<version>0.8</version>
</dependency>
2、创建Zookeeper连接
示例:ZkClient zc = new ZkClient("192.168.117.128:2181",10000,10000,new SerializableSerializer());
API:ZkClient(java.lang.String zkServers, int sessionTimeout, int connectionTimeout, org.I0Itec.zkclient.serialize.ZkSerializer zkSerializer)
- zkServers:Zookeeper服务器地址
- sessionTimeout:session超时时间
- connectionTimeout:连接超时时间
- zkSerializer:序列化器,ZkClient提供2种
- SerializableSerializer:对象序列化,可转换对象
- BytesPushThroughSerializer:字节数组序列化
3、创建节点
示例:
@Test
public void createNode() {
createSession();
User user = new User();
user.setId(1l);
user.setName("scot");
String path = zc.create("/zkClient_01/02",user, CreateMode.PERSISTENT);
System.out.println("path :" + path);
}
API:
public java.lang.String create(java.lang.String path, java.lang.Object data, org.apache.zookeeper.CreateMode mode) public java.lang.String create(java.lang.String path, java.lang.Object data, java.util.List<org.apache.zookeeper.data.ACL> acl, org.apache.zookeeper.CreateMode mode)
示例用的为第一种,没有设置访问权限列表(List<org.apache.zookeeper.data.ACL> acl)
- path:创建节点路径。(需要确保父路径存在)
- data:节点数据。设置与获取要注意创建连接时候的序列化器
- Acl:权限列表。详情查看 2.1Zookeeper原始API使用
- mode:节点类型。详情查看 2.1Zookeeper原始API使用
4、节点是否存在
boolean exists(java.lang.String path);
5、获取节点信息
示例:
@Test
public void getNode() {
createSession();
User user = zc.readData("/zkClient_01");
System.out.println(user.getName()); Stat stat = new Stat();
User user1 = zc.readData("/zkClient_01",stat);
System.out.println(user.getName());
System.out.println(stat);
}
API:
public <T> T readData(java.lang.String path)public <T> T readData(java.lang.String path, boolean returnNullIfPathNotExists)public <T> T readData(java.lang.String path, org.apache.zookeeper.data.Stat stat)
- path:节点路径。
- returnnullIfPathNotExists:同字面意思,节点不存在返回null
- stat:节点详细信息。传递stat对象到readData方法,方法内部会填充stat数据
6、获取子节点
示例:
@Test
public void getChild() {
createSession();
String path = "/node_scot";
boolean b = this.exists(path);
if(b) {
List<String> children =zc.getChildren(path);
System.out.println(children.size());
}else {
System.out.println("do not have this node");
}
}
API:
public java.util.List<java.lang.String> getChildren(java.lang.String path)
7、删除节点
示例:
@Test
public void del() {
createSession();
String path = "/zkClient_01/01";
if(this.exists(path)) {
//zc.delete(path);//删除当前节点,有子节点无法删除
zc.deleteRecursive(path);//删除非子节点
}
}
API:
public boolean delete(java.lang.String path) public boolean delete(java.lang.String path, int version) public boolean deleteRecursive(java.lang.String path)
- version:节点的版本。如果版本不符无法删除
8、更新节点信息
示例:
@Test
public void writeNode() {
createSession();
User user = new User();
user.setId(11l);
user.setName("sksujer002");
zc.writeData("/zkClient_01",user);
}
9、监控子节点改变(当前节点不存在也可以设置监控)
示例:
@Test
public void subscribeChildChange() throws InterruptedException {
createSession();
zc.subscribeChildChanges("/zkClient_01",new MyZkChildListener());
Thread.sleep(Integer.MAX_VALUE);
} static class MyZkChildListener implements IZkChildListener { @Override
public void handleChildChange(String s, List<String> strings) throws Exception {
System.out.println("s:"+s);
System.out.println("Strings:" + strings);
}
}
API:
public java.util.List<java.lang.String> subscribeChildChanges(java.lang.String path, org.I0Itec.zkclient.IZkChildListener listener) public interface IZkChildListener {
void handleChildChange(java.lang.String parentPath, java.util.List<java.lang.String> currentChilds) throws java.lang.Exception;
}
-
subscribeChildChanges:注册子节点改变监控
path:路径
IZkChildListener listener:子节点监控接口
-
IZkChildListener - handChildChange:子节点列表发生改变触发此方法
parentPath:监控节点路径
currentChilds:子节点列表
10、监控节点数据
示例:
@Test
public void subscribeDataChange () throws InterruptedException {
createSession();
zc.subscribeDataChanges("/zkClient_01",new MyZkDataListener());
Thread.sleep(Integer.MAX_VALUE);
} static class MyZkDataListener implements IZkDataListener { @Override
public void handleDataChange(String s, Object o) throws Exception {
System.out.println("节点信息改变");
System.out.println("s:"+s);
System.out.println("o:"+o);
} @Override
public void handleDataDeleted(String s) throws Exception {
System.out.println("节点被删除:"+s);
}
}
API:
public void subscribeDataChanges(java.lang.String path, org.I0Itec.zkclient.IZkDataListener listener) public interface IZkDataListener {
void handleDataChange(java.lang.String dataPath, java.lang.Object object) throws java.lang.Exception; void handleDataDeleted(java.lang.String dataPath) throws java.lang.Exception;
}
-
subscribeDataChanges:注册节点数据监控
IZkDataListener listener:数据改变监控接口
-
IZkDataListener - handleDataChange:节点数据改变触发此方法
dataPath:监控节点路径
object:节点的新数据
IZkDataListener - handleDataDeleted:节点被删除触发此方法
dataPath:监控节点路径
下一节:2.3Curator使用