聊聊、Zookeeper API

今天我们来说说 Zookeeper 客户端启动，整个文章分三个部分：第一部分是 Zookeeper 原生 API 客户端，第二部分是开源客户端 ZkClient，第三部分是开源客户端 Curator。

【Zookeeper API】 

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

 

 创建会话

• new ZooKeeper(String connectString,int sessionTimeOut,Watcher watcher)
• new ZooKeeper(String connectString,int sessionTimeOut,Watcher watcher,boolean canBeReadOnly)
• new ZooKeeper(String connectString,int sessionTimeOut,Watcher watcher,long sessionId,byte[] sessionPasswd)
• new ZooKeeper(String connectString,int sessionTimeOut,Watcher watcher,long sessionId,byte[] sessionPasswd,boolean canBeReadOnly)
• 上面四个构造函数都可以创建会话，不同的在于构造参数。
• connectString 就是 host:port 字符串，例如 127.0.0.1:2181，也可以是多个，192.168.0.10:2181,192.168.0.11:2181,192.168.0.12:2181，多个地址表示集群。我们也可以指定到根目录，例如 192.168.0.10:2181/test，这样 Zookeeper服务连接后，所有的操作是针对 test 根目录。
• sessionTimeOut 就是会话超时时间，单位是毫秒。如果在会话超时时间内没有检查到心跳，则会话失效。
• watcher 就是监听器，也可以说是通知，如果传给构造函数 watcher 不为空，则会话创建成功后会有通知到客户端。收到通知后，客户端可以做一些事情。但是 watcher 的生命周期很短，通知一次过后就失效了，需要反复的注册。
• canBeReadOnly 是一个 boolean 类型，如果是 true，则当 Zookeeper 服务器故障，服务器还可以提供读服务。
• sessionId 就是会话序列号，sessionPasswd 就是会话密码，它们的作用就是会话复用，可以达到恢复会话作用。

 创建节点

•  String create(final String path,byte data[],List<ACL> acl,CreateMode createMode)
• void create(final String path,byte data[],List<ACL> acl,CreateMode createMode,StringCallback cb,Object ctx)
• path 就是要创建的节点路径，例如 /app，在根节点 / 下创建 app 节点。
• data[] 就是节点内容，字节数组形式。
• acl 就是节点 ACL 策略。
• createMode 就是节点类型，分为持久，持久顺序，临时，临时顺序。
• cb 就是异步回调方法。实现 StringCallback 接口即可。
• ctx 用于传递一个对象，一般是上下文信息。

 

package zookeeper.client;

import java.io.IOException;
import java.util.concurrent.CountDownLatch;
import org.apache.zookeeper.CreateMode;
import org.apache.zookeeper.KeeperException;
import org.apache.zookeeper.WatchedEvent;
import org.apache.zookeeper.Watcher;
import org.apache.zookeeper.Watcher.Event.EventType;
import org.apache.zookeeper.ZooDefs.Ids;
import org.apache.zookeeper.ZooKeeper;
import org.apache.zookeeper.Watcher.Event.KeeperState;

public class ZKClient {

	private static CountDownLatch down = new CountDownLatch(1);

	private ZooKeeper zk;

	public void getNode(){
		String path = "/";
		try {
			zk = new ZooKeeper("127.0.0.1:2181", 5000, new MyWatcher());
			down.await();
			zk.create(path+"app", "hello".getBytes(), Ids.OPEN_ACL_UNSAFE, CreateMode.EPHEMERAL);
		} catch (IOException e) {
			e.printStackTrace();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	class MyWatcher implements Watcher{
		public void process(WatchedEvent e) {
			if(KeeperState.SyncConnected == e.getState()){
				System.out.println("SyncConnected");
				if(EventType.None == e.getType() && null == e.getPath()){
					down.countDown();
				}else if(e.getType() == EventType.NodeChildrenChanged){
					try {
						System.out.println("NodeChildrenChanged"+zk.getChildren("/", true));
					} catch (KeeperException e1) {
						e1.printStackTrace();
					} catch (InterruptedException e1) {
						// TODO Auto-generated catch block
						e1.printStackTrace();
					}
				}
			}

		}

	}

}

　　

 

删除节点

•  public void delete(final String path,int version)
• public void delete(final String path,int version,VoidCallback cb,Object ctx)
• path 就是要删除的节点路径。
• version 就是节点版本号。
• cb 就是回调方法。
• ctx 就是传递上下文信息对象。

 读取节点

 (一)、getChildren 获取一个节点所有子节点。

• List<String> getChildren(final String path,Watcher watcher)
• List<String> getChildren(final String path,boolean watcher)
• void getChildren(final String path,Watcher watcher,ChildrenCallback cb,Object ctx)
• void getChildren(final String path,boolean watcher,ChildrenCallback cb,Object ctx)
• List<String> getChildren(final String path,Watcher watcher,Stat stat)
• List<String> getChildren(final String path,boolean watcher,Stat stat)

（二）、getData 获取一个节点内容。

• byte[] getData(final String path,Watcher watcher,Stat stat)
• byte[] getData(final String path,boolean watcher,Stat stat)
• void getData(final String path,Watcher watcher,DataCallback cb,Object ctx)
• void getData(final String path,boolean watcher,DataCallback cb,Object ctx)
• stat 就是节点的状态信息。包括 cZxid、mZxid，pZxid等。

更新节点

• Stat setData(final String path,byte data[],int version)
• void setData(final String path,byte data[],int version,StatCallback cb,Object ctx)

检测节点是否存在

• public Stat exists(final String path,Watcher watcher)
• public Stat exists(final String path,boolean watch)
• public void exists(final String path,Watcher watcher,StatCallback cb,Object ctx)
• public void exists(final String path,boolean watch,StatCallback cb,Object ctx)

谢谢大家观看！