创建节点
创建节点有两种接口:
同步方式创建数据节点
String org.apache.zookeeper.ZooKeeper.create(String path, byte[] data, List<ACL> acl, CreateMode createMode)
异步方式创建数据节点
void org.apache.zookeeper.ZooKeeper.create(String path, byte[] data, List<ACL> acl, CreateMode createMode, StringCallback cb, Object ctx)
注意:
a. 无论是异步还是同步接口,ZooKeeper都不支持递归创建,无法在父节点不存在的情况下创建一个子节点
b. 如果一个节点已经存在,那么创建同名节点时,会抛出NodeExistsException异常。
c. ZooKeeper的节点内容只支持字节数组类型(byte[]),也就是说zookeeper不负责为节点内容进行序列化。
使用同步方式创建节点
我们来看代码:
public class TestCreate implements Watcher {
// 屏障,计数器
private static CountDownLatch downLatch = new CountDownLatch(1);
public static void main(String[] args) throws Exception {
ZooKeeper zookeeper = new ZooKeeper("10.0.227.66:2181", 5000, new TestCreate());
System.out.println("zookeeper.getState()1 : " + zookeeper.getState());
try {
downLatch.await();// 在计数器未归零之前,所有线程等待
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("zookeeper.getState()2 : " + zookeeper.getState());
String result = zookeeper.create("/cyx", "666".getBytes(), Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL);
System.out.println("result : " + result);
}
@Override
public void process(WatchedEvent event) {
System.out.println("receive watched event : " + event);
if (KeeperState.SyncConnected == event.getState()) {
downLatch.countDown();// 计数器-1
}
}
}
输出内容
receive watched event : WatchedEvent state:SyncConnected type:None path:null
zookeeper.getState()2 : CONNECTED
result : /cyx
临时节点:当客户端与服务端断开连接之后,创建的临时节点会自动消失。
"Ids.OPEN_ACL_UNSAFE":权限设置,设置开放节点,允许任意操作
"CreateMode.EPHEMERAL":节点类型,临时节点
这里了解下权限的配置
Ids.OPEN_ACL_UNSAFE | 开放节点,允许任意操作 |
Ids.READ_ACL_UNSAFE | 只读节点 |
Ids.CREATOR_ALL_ACL | 创建者全部权限 |
一般我们内部系统,对权限要求不高,使用开放节点就好
设置节点的类型
CreateMode.PERSISTENT | 持久化节点 |
CreateMode.PERSISTENT_SEQUENTIAL | 持久化顺序节点 |
CreateMode.EPHEMERAL | 临时节点 |
CreateMode.EPHEMERAL_SEQUENTIAL | 临时顺序节点 |
使用异步方式创建节点
我们来看代码:
/**
* 异步方式创建节点
*
* @author CYX
* @time 2017年8月4日下午1:31:12
*/
public class TestCreate2 implements Watcher {
// 屏障,计数器
private static CountDownLatch downLatch = new CountDownLatch(1);
public static void main(String[] args) throws Exception {
ZooKeeper zookeeper = new ZooKeeper("10.0.227.66:2181", 5000, new TestCreate2());
System.out.println("zookeeper.getState()1 : " + zookeeper.getState());
try {
downLatch.await();// 在计数器未归零之前,所有线程等待
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("zookeeper.getState()2 : " + zookeeper.getState());
zookeeper.create("/cyx", " ".getBytes(), Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL, new MyStringCallback(), "I am context");
zookeeper.create("/cyx", " ".getBytes(), Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL, new MyStringCallback(), "I am context");
zookeeper.create("/cyx", " ".getBytes(), Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL_SEQUENTIAL, new MyStringCallback(), "I am context");
Thread.sleep(Integer.MAX_VALUE);
}
@Override
public void process(WatchedEvent event) {
System.out.println("receive watched event : " + event);
if (KeeperState.SyncConnected == event.getState()) {
downLatch.countDown();// 计数器-1
}
}
static class MyStringCallback implements AsyncCallback.StringCallback {
@Override
public void processResult(int rc, String path, Object ctx, String name) {
System.out.println("Create path result : [ " + rc + " , " + path + " , " + " , " + ctx + " , " + " ,real path name : " + name);
}
}
}
输出结果:
zookeeper.getState()1 : CONNECTING
zookeeper.getState()2 : CONNECTED
Create path result : [ 0 , /cyx , , I am context , ,real path name : /cyx
Create path result : [ -110 , /cyx , , I am context , ,real path name : null
Create path result : [ 0 , /cyx , , I am context , ,real path name : /cyx0000000051
AsyncCallback中包含了七种不同的回调接口,此处暂时不多说。
我们来了解下processResult()回调方法参数的意思:
int rc | result code 服务端响应码。客户端可以从这个编码识别出API调用的结果
0:接口调用成功 -4:客户端和服务端连接已断开 -110:指定节点已存在 -112:会话已过期 |
String path | 接口调用时传入API的数据节点的节点路径 |
Object ctx | 接口调用时传入API的参数值 |
String name | 实际在服务端创建的节点名 |
对照上面的说明,我们看下输出的内容:
第一次调用成功,创建节点成功
第二次因为节点同名,创建失败
第三次,创建临时顺序节点,创建成功