zookeeper使用篇-Zookeeper Api实践，看完老板就给加薪了

zookeeper使用篇-Zookeeper Api实践，看完老板就给加薪了

可以看到Zookeeper的源码中总共提供了四个构造函数，参数从三个到六个不等，我们分别来看看这几个参数的说明:

connectString

connectString代表Zookeeper的服务器列表,每个zk服务器使用host:port字符串组成，多个zk服务器之间使用英文输入法的逗号分隔，需要注意的是我们还可以在连接中指定根目录，例如

192.168.1.3 :2181/zk-root，则当客户端连接上当前zk服务器的时候，后续所有的 *** 作都会基于当前目录作为根目录进行 *** 作

sessionTimeout

sessionTimeout指的是会话时间，单位是毫秒，zk引入了会话的概念，在一个会话周期内，zk会通过心跳检测机制来维持会话的有效性，一旦在当前指定的时间内没有完成心跳检测，则视为当前会话已经失效

watcher

watcher是zk中提供的事件通知机制，在zk中允许传入当前类型的接口实例来作为客户端默认的事件通知处理器，如果我们当前不需要引入事件通知机制，当前参数传递null即可

canBeReadOnly

canBeReadOnly是zk中提供的一个保护机制，默认情况下zk集群如果出现大半的机器失去网络连接(宕机)，那么zk将进入保护，不再处理任何客户端请求(包括读)，但是如果我们需要继续提供读服务 *** 作，则需要将当前的参数设置为true

aHostProvider

aHostProvider是zk提供的支持客户端的自定义行为 *** 作，内部提供next、onConnected以及updateServerList等 *** 作

clientConfig

clientConfig是zk提供的用来灵活配置的配置类，可以将连接的信息配置进去，例如zk超时时间，连接方式，连接信息等

了解了Zookeeper的构造函数，我们来编写第一个demo，创建一个zk会话实例:

public class SessionDemo implements Watcher {
private static CountDownLatch latch = new CountDownLatch(1);

public static void main(String[] args) throws IOException, InterruptedException {
ZooKeeper zooKeeper = new ZooKeeper(“127.0.0.1:2181”,5000,new SessionDemo());
System.out.println(zooKeeper.getState());
latch.await();
}

@Override
public void process(WatchedEvent event) {
System.out.println(“触发了监听事件：”+event);
//如果当前是异步连接状态
if(Event.KeeperState.SyncConnected == event.getState()){
latch.countDown();
}
}
}

点击运行以后，可以看到控制台的输出:

CONNECTING
触发了监听事件：WatchedEvent state:SyncConnected type:None path:null

创建节点

zookeeper提供了两种创建节点的方式，一种是同步创建，一种是异步，我们首先来看看create方法:

//创建同步节点
public String create(final String path, byte data[], List acl,CreateMode createMode)throws KeeperException, InterruptedException

//创建异步节点
public void create(final String path, byte data[], List acl,CreateMode createMode, StringCallback cb, Object ctx)

可以看到异步创建节点的接口多了两个参数，一个是callback回调，一个是传递的object对象，接下来我们针对这些参数进行一下说明:

path

path是创建zk节点的时候指定的对应路径，如:/root

data[]

**data[]**是创建节点的时候对应存储的内容

acl

acl是创建节点的时候
的策略

createMode

createMode是创建节点的时候指定的节点类型，通常指定四种类型(实际不止)：

1.持久化节点–PERSISTENT

2.持久化顺序节点–PERSISTENT _ S E QUENTIAL

3.临时节点–EPHEMERAL

4.临时顺序节点-- EPHEMERAL _ S EQUENTIAL

cb

cb是注册一个异步回调函数，类型为StringCallback，一般重写void processResult( int rc , String path , Object ctx , String
n ame ) ;当zk创建节点完毕以后，会自动调用这个方法，可以在当前方法内处理对应的业务逻辑

ctx

ctx在创建节点的时候可以传递的对象，在StringCallback的回调函数执行的时候使用(传递)，通常会传递上下文(Context)

注意：这里需要注意的是，zk默认创建的时候不会给我们进行序列化，需要我们手动序列化转换为字节数组传递节点存储的内容，并且zk默认不允许跨节点创建，即如果上层路径不存在的情况下，直接创建子节点，并且如果当前路径对应节点已经创建，再去创建并不会覆盖原来的内容，会抛出NodeExistsException异常

创建同步节点

接下来，我们来创建一个同步节点:

public class CreateDemo implements Watcher {
private static final CountDownLatch LATCH = new CountDownLatch(1);

public static void main(String[] args) throws IOException, InterruptedException, KeeperException {
ZooKeeper zk = new ZooKeeper(“127.0.0.1:2181”,
5000,new CreateDemo());
LATCH.await();
//等待连接上zk以后
String path1 = zk.create("/test01", “test01”.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL);
System.out.println(“创建无序节点:”+path1);

String path2 = zk.create("/test02", “test02”.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL_SEQUENTIAL);
System.out.println(“创建有序节点:”+path2);
}

@Override
public void process(WatchedEvent event) {
if(Event.KeeperState.SyncConnected == event.getState()){
LATCH.countDown();
}
}
}

我们来运行一下，可以看到控制台输出的内容:

创建无序节点:/test01
创建有序节点:/test020000000002

创建异步节点

创建异步节点，我们需要注意传递ctx参数，以及StringCallback的实例，并且我们需要注意的是，create方法并不会阻塞后续业务执行:

public class CreateAyncDemo implements Watcher {
private static final CountDownLatch LATCH = new CountDownLatch(1);

public static void main(String[] args) throws IOException, InterruptedException, KeeperException {
ZooKeeper zk = new ZooKeeper(“127.0.0.1:2181”,
5000,new CreateAyncDemo());
LATCH.await();
//等待连接上zk以后
zk.create("/testAsyn001", “testAsyn001”.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL,
new IStringCallback(),“我是上下文”);

zk.create("/testAsyn002", “testAsyn002”.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL_SEQUENTIAL,
new IStringCallback(),“我是上下文”);
Thread.sleep(Integer.MAX_VALUE);
}

@Override
public void process(WatchedEvent event) {
if(Event.KeeperState.SyncConnected == event.getState()){
LATCH.countDown();
}
}

}
class IStringCallback implements AsyncCallback.StringCallback{
@Override
public void processResult(int rc, String path, Object ctx, String name) {
System.out.println(“创建节点完毕的回调函数:[rc:”+rc+",path:"+path+",ctx:"+ctx+",name:"+name+"]");
}
}

我们使用Thread.sleep阻塞一下当前的业务，运行可以看到控制台成功输出:

创建节点完毕的回调函数:[rc:0,path:/testAsyn001,ctx:我是上下文,name:/testAsyn001]
创建节点完毕的回调函数:[rc:0,path:/testAsyn002,ctx:我是上下文,name:/testAsyn0020000000009]

删除节点

客户端通过delete方法来删除某一个节点，delete方法如下:

//同步删除
public void delete(final String path, int version)
throws InterruptedException, KeeperException
//异步删除
public void delete(final String path, int version, VoidCallback cb,Object ctx)

可以看到删除节点 *** 作和创建节点一样，支持同步和异步 *** 作，但是这里我们需要注意的是，**在Zookeeper中，只运行按照顺序删除节点，即子节点存在无法直接删除父节点，必须优先删除下面的所有子节点！**接下来我们编写一个案例，删除节点：

public class DeleteDemo implements Watcher {
private static final CountDownLatch LATCH = new CountDownLatch(1);

public static void main(String[] args) throws IOException, InterruptedException, KeeperException {
ZooKeeper zk = new ZooKeeper(“127.0.0.1:2181”,
5000,new DeleteDemo());
LATCH.await();
//等待连接上zk以后
String path1 = zk.create("/test01", “test01”.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL);
System.out.println(“创建无序节点:”+path1);

String path2 = zk.create("/test02", “test02”.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL_SEQUENTIAL);
System.out.println(“创建有序节点:”+path2);
//触发同步删除
zk.delete("/test01",0);
//触发异步删除
zk.delete("/test02",0,new IVoidCallback(),“我是触发异步删除的数据”);
Thread.sleep(Integer.MAX_VALUE);
}

@Override
public void process(WatchedEvent event) {
if(Event.KeeperState.SyncConnected == event.getState()){
LATCH.countDown();
}
}
}

class IVoidCallback implements AsyncCallback.VoidCallback{

@Override
public void processResult(int rc, String path, Object ctx) {
System.out.println(“异步删除节点触发:[path:”+path+",rc:"+rc+",ctx:"+ctx+"]");
}
}

运行以后，可以看到控制台的输出如下:

创建无序节点:/test01
创建有序节点:/test020000000011
异步删除节点触发:[path:/test02,rc:-101,ctx:我是触发异步删除的数据]

获取数据

在Zookeeper中有两种获取数据的接口，一种是获取当前节点的相关数据信息，一种是获取当前节点下的子节点相关的数据信息，接下来我们来看看这两种Api接口

getData

客户端通过getData方法可以获取当前节点的相关数据内容，方法如下:

public byte[] getData(final String path, Watcher watcher, Stat stat) throws KeeperException, InterruptedException
//第二个
public byte[] getData(String path, boolean watch, Stat stat) throws KeeperException, InterruptedException
//第三个
public void getData(final String path, Watcher watcher,DataCallback cb, Object ctx)
//第四个
public void getData(String path, boolean watch, DataCallback cb, Object ctx)

可见这里也提供了同步获取数据和异步获取数据的方法，接下来我们来看看对应参数的说明:

path

path是需要获取数据的节点所在的路径

watcher

watcher是用来注册的通知接口，如果节点发生变更，就会通过当前的接口通知客户端

stat

stat是用来描述该数据节点的状态信息，如果我们需要获取当前节点的状态信息，可以在客户端创建该变量传入方法中，有服务端替换该变量

cb

cb是异步获取数据的时候注册的回调函数接口，类型为DataCallback

ctx

ctx是在异步获取数据过程中传递给异步回调函数接口的实例，一般用来传递上下文

接下来，我们来编写代码获取一下节点的内容数据:

public class GetDataDemo implements Watcher {
private static final CountDownLatch LATCH = new CountDownLatch(1);

public static void main(String[] args) throws IOException, KeeperException, InterruptedException {
ZooKeeper zk = new ZooKeeper(“127.0.0.1:2181”,5 * 1000,
new GetDataDemo());
LATCH.await();
String path = zk.create("/testGetData01", “/testGetData01”.getBytes(), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL);
System.out.println(“创建节点成功:”+path);
//同步调用查询接口
Stat stat = new Stat();
byte[] data = zk.getData("/testGetData01", true, stat);
System.out.println(“同步获取当前节点内容:”+new String(data)+",stat:"+stat);
//异步调用查询接口
zk.getData("/testGetData01", true,new IDataCallback(),“我是异步获取数据的回调函数”);
Thread.sleep(5 * 1000);
}

@Override
public void process(WatchedEvent event) {
if(Event.KeeperState.SyncConnected == event.getState()){
LATCH.countDown();
}
}
}

class IDataCallback implements AsyncCallback.DataCallback{

@Override
//异步调用查询接口
zk.getData("/testGetData01", true,new IDataCallback(),“我是异步获取数据的回调函数”);
Thread.sleep(5 * 1000);
}

@Override
public void process(WatchedEvent event) {
if(Event.KeeperState.SyncConnected == event.getState()){
LATCH.countDown();
}
}
}

class IDataCallback implements AsyncCallback.DataCallback{

@Override