简介
curator是Apache下开源的项目,它包含了zookeeper的客户端高层级API的实现,并提供了一些常见的用例实现方便我们直接使用。简单来说,使用curator作为zookeeper客户端能够使我们更加简单且可靠地在我们的程序中使用zookeeper。
curator官网:http://curator.apache.org/
JavaDoc:http://curator.apache.org/apidocs/index.html
依赖
它主要包含三个依赖(curator的依赖都已经放到maven仓库,你直接使用maven来构建它。对于大多数人来说,我们可能最常需要引入的是curator-recipes):
1)curator-recipes:包含了curator实现的各项功能,如读写锁、互斥锁、队列等,依赖于framework和Client:http://curator.apache.org/curator-recipes/index.html
2)curator-framework:包含了高层级的流式API,构建在Client之上如对节点的增删改查等:http://curator.apache.org/curator-framework/index.html
3)curator-client:zookeeper的基础客户端实现,如连接、重试、超时处理等:http://curator.apache.org/curator-client/index.html
下面示例我们将看到如何使用curator连接zookeeper并进行CRUD操作,这不需要recipes,只需要client和framework即可。使用maven的话,引入framework的时候会自动引入Client,因此,我们将直接引入framework。
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-framework</artifactId>
<version>2.12.0</version>
</dependency>
兼容性
zookeeper 3.4.x版本和3.5.x版本已经被大量的使用在了生产环境中,即使截止到18年5月3.5.x还处于beta版本中。
在curator4.0之前,对于3.4.x和3.5.x的兼容需要引入两个不同的版本来对应,分别是:
1)curator 2.x.x -> zookeeper 3.4.x 和 3.5.x
2)curator 3.x.x -> zookeeper 3.5.x
而在curator4.0以后,可以同时兼容这两种版本。但是你需要排除zookeeper的客户端依赖包,如:
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-recipes</artifactId>
<version>4.0.0</version>
<exclusions>
<exclusion>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
</exclusion>
</exclusions>
</dependency>
并,引入你需要的zookeeper依赖包版本,比如引入3.4.6:
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>3.4.6</version>
</dependency>
curator会自动兼容你引入的zookeeper依赖,并根据你引入的依赖来决定采用哪一种模式。
增删改查
CuratorFramework对外提供基本的流式API操作,需要通过CuratorFrameworkFactory来连接zookeeper,并build一个实例对象。
在使用API操作之前,你需要调用start()方法,操作结束以后需要调用close()方法结束。不过CuratorFramework是线程安全的,所以你可以采用单例的形式去使用它而不用频繁地创建、开始、关闭等。
import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.CuratorFrameworkFactory;
import org.apache.curator.retry.ExponentialBackoffRetry;
public class CuratorDemo {
public static void main(String[] args) throws Exception {
// 连接zookeeper到本地的2181端口,并设置重试策略为3秒一次,最多3次重试
CuratorFramework client = CuratorFrameworkFactory.builder().connectString("127.0.0.1:2181").retryPolicy(new ExponentialBackoffRetry(3000, 3)).build();
System.out.println("启动");
client.start();
System.out.println("创建节点");
// 创建
client.create().forPath("/user", "lay".getBytes());
System.out.println("查询节点");
// 查看
byte[] result = client.getData().forPath("/user");
System.out.println(new String(result));
System.out.println("更新节点");
// 更新
client.setData().forPath("/user", "marry".getBytes());
result = client.getData().forPath("/user");
System.out.println(new String(result));
System.out.println("删除节点");
// 删除
client.delete().forPath("/user");
// 判断节点存在
System.out.println("isExsits: " + client.checkExists().forPath("/user") != null);;
System.out.println("关闭");
client.close();
}
}
使用curator必须先调用start()方法,当你不需要使用的时候需要调用close()去关闭。