二、curator入门

简介

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()去关闭。 

 

posted @ 2018-09-12 14:31  __lay  阅读(543)  评论(0编辑  收藏  举报