zookeeper开源客户端curator
zookeeper的原生api相对来说比较繁琐,比如:对节点添加监听事件,当监听触发后,我们需要再次手动添加监听,否则监听只生效一次;再比如,断线重连也需要我们手动代码来判断处理等等。对于curator的介绍,从网上百度了一段:Curator是Netflix开源的一套zookeeper客户端框架,用它来操作zookeeper更加方便,按Curator官方所比喻的,guava to JAVA,curator to zookeeper,Curator采用了fluent风格的代码,非常简洁。
---------------正-----文-----------------------------------------------------------------------------------------------------------------------------------------------
Curator包含6部分,均可提供单独jar包,每个包简单介绍如下:
client:zk-client的替代品,提供一些底层处理跟工具类;
framework:高级封装,大大简化了zk的客户端编程,包含对zk的连接管理,重试机制等;
repices:提供了一些常用的操作,比如持续监听,锁,选举等;
utilities:各种工具类;
errors:curator对异常跟错误的处理;
extendsion:扩展包;
基本api代码解释:
1、建立连接
建立连接需要指定zk地址以及重试策略等,先上代码再解释:
RetryPolicy retry = new ExponentialBackoffRetry(1000, 5);//重试5次,每次间隔时间指数增长(有具体增长公式)
RetryPolicy retry1 = new RetryNTimes(5, 5000);//重试5次,每次间隔5秒
RetryPolicy retry2 = new RetryUntilElapsed(60000 * 2, 5000);//重试2分钟,每次间隔5秒
//普通创建
CuratorFramework client = CuratorFrameworkFactory.newClient("localhost:2181", 5000, 5000, retry);
//fluent风格创建
CuratorFramework client1 = CuratorFrameworkFactory.builder()
.connectString("localhost:2181")
.connectionTimeoutMs(5000) //连接超时时间
.sessionTimeoutMs(3000) //会话超时时间
.retryPolicy(retry)
.build(); //建立连接
client.start();
如注释,创建客户端连接我们通常需要指定重试策略,curator提供了3种重试机制,分别如上;对于fluent风格,就是每个操作都返回了一个对象,我们可以一直通过[.方法名]的方式书写代码;client创建了之后,需要调用start方法才能真正去建立连接。会话超时时间是指当连接发生故障时,由于zk的心跳机制检测,服务端认为会话超时的时间,会清除session;
2、创建、删除、更新节点
连接建立之后,我们可以在服务器上进行创建节点的操作,代码如下:
//创建节点
String path = client.create()
.creatingParentsIfNeeded() //对节点路径上没有的节点进行创建
.withMode(CreateMode.EPHEMERAL) //临时节点
.forPath("/curator/test", "123".getBytes()); //节点路径,节点的值 //删除节点
client.delete()
.guaranteed() //删除失败,则客户端持续删除,直到节点删除为止
.deletingChildrenIfNeeded() //删除相关子节点
.withVersion(-1) //无视版本,直接删除
.forPath("/curator/mytest");
//更新节点信息
Stat stat2 = new Stat();
byte[] theValue2 = client.getData().storingStatIn(stat).forPath("/curator/test");
client.setData()
.withVersion(stat2.getVersion()) //版本校验,与当前版本不一致则更新失败,-1则无视版本信息进行更新
.forPath("/curator/test", "456".getBytes());
//判断节点是否存在(存在返回节点信息,不存在则返回null)
Stat s = client.checkExists().forPath("/curator/test");
持久节点是persistent,我们创建的节点可能有好几层,如果服务器不存在父节点则会报错并创建失败,createingParentsIfNodeed()的作用是在父节点不存在的时候进行创建。删除操作可能由于网络抖动等情况导致删除失败,由于节点数据操作一般对业务影响较大,故多数都会带持续删除的动作来确保正确删除;节点更新删除等操作若考虑版本校验,则采用代码所示方式,在获取节点数据的时候对节点状态进行赋值,然后通过节点状态可以获得版本信息。判断节点是否存在,一般通过节点信息判断,若不存在,则节点信息为null。
3、获取字节点列表
只有一行代码,返回string类型的list
//获取子节点列表
List<String> paths = client.getChildren().forPath("/curator");
4、异步操作
异步操作不会阻塞代码执行,对于操作完成后的业务处理,需要设定回调函数来完成。以判断节点是否存在为例:
ExecutorService es = Executors.newFixedThreadPool(5);//异步操作线程池,
//异步判断操作
Stat s1 = client.checkExists().inBackground().forPath("/curator/test"); //无回调
client.checkExists().inBackground(new BackgroundCallback() { //有回调
@Override
public void processResult(CuratorFramework curatorFramework, CuratorEvent curatorEvent) throws Exception {
CuratorEventType c = curatorEvent.getType();//事件类型,可在CuratorEventType看到具体种类
int r = curatorEvent.getResultCode();//0,执行成功,其它,执行失败
Object o = curatorEvent.getContext();//事件上下文,一般是由调用方法传入,供回调函数使用的参数
String p = curatorEvent.getPath();//节点路径
List<String> li = curatorEvent.getChildren();//子节点列表
byte[] datas = curatorEvent.getData();//节点数据
//一些其它操作
}
},es).forPath("/curator/test");
异步操作实际是在后台另起一个线程来完成该操作,若线程较多势必会影响服务器性能,所以要用线程池来尽量降低对服务器的消耗。需要考虑线程池的关闭操作,较繁琐,不作赘述。
5、节点、子节点监听
节点监听需要用repices包中的NodeCache来完成,代码如下:
//节点监听
final NodeCache cache = new NodeCache(client,"/curator/test");
cache.start();
cache.getListenable().addListener(new NodeCacheListener() {//监听对象
@Override
public void nodeChanged() throws Exception {//重写监听方法
byte[] ret = cache.getCurrentData().getData();
System.out.println("当前节点内容是:"+ new String(ret));
}
});
子节点的监听需要用PathChildrenCache来完成,跟节点本身不一样,代码如下:
//子节点监听
final PathChildrenCache pccache = new PathChildrenCache(client,"/curator",true);//true指当子节点变化时,获取子节点内容
pccache.start();
pccache.getListenable().addListener(new PathChildrenCacheListener() {
@Override
public void childEvent(CuratorFramework curatorFramework, PathChildrenCacheEvent pathChildrenCacheEvent) throws Exception {//重写监听方法
switch (pathChildrenCacheEvent.getType()){//子节点的事件类型
case CHILD_ADDED:
System.out.println(pathChildrenCacheEvent.getData());//通过pathChildrenCacheEvent,可以获取到节点相关的数据
break;
case CHILD_REMOVED:
System.out.println(pathChildrenCacheEvent.getData().getPath());
break;
case CHILD_UPDATED:
break;
default:
break;
}
}
});
6、权限控制部分,略。
只是简单罗列了curator的一些基本用法,距离具体应用还是有很大差距,稍后将动手写一下选主程序来练手试试,希望顺利。
最新文章
- 利用免费cdn加速webpack单页应用
- 迁移学习( Transfer Learning )
- centos 基本操作(快捷键开户终端,复制,粘贴,yum命令)
- 【WEB】HTTP协议
- SELECT时为何要加WITH(NOLOCK)
- UVALive 4682 XOR Sum (trie)
- Sass中的Map 详解
- 【网络流24题】No.11(航空路线问题 最长不相交路径 最大费用流)
- ♫【模式】自定义函数(self-defining function)
- js对象克隆, 深复制.
- go语言 strconv.ParseInt 的例子
- Python笔记&#183;第六章——集合 (set) 的增删改查及 copy()方法
- 【Python3之函数对象】
- 学习 JavaScript(二)在 HTML 中使用 JS
- Elasticsearch - 简单介绍
- centos 6.5 安装jdk1.8
- angularjs 绑定多个属性到下拉框
- 学习Python语言 基础语法:变量的基本使用
- strlen函数,strcat函数,strcpy函数,strncpy函数,strcmp函数
- CentOS 下搭建Jenkins