Zookeeper Java 客户端 Curator 使用

Zookeeper 3.6.1

添加依赖

<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-recipes</artifactId>
    <version>5.1.0</version>
</dependency>

添加配置

zookeeper:
  # 连接,多个用逗号隔开
  connect-string: 192.168.110.40:2181
  # 连接超时时间
  connection-timeout-ms: 5000
  # 会话超时时间
  session-timeout-ms: 60000
  # 初始休眠时间
  base-sleep-time-ms: 1000
  # 最大重试次数
  max-retries: 3

初始化

@Configuration
public class ZookeeperConfig {

    @Value("${zookeeper.connect-string:''}")
    private String connectString;

    @Value("${zookeeper.connection-timeout-ms:''}")
    private int connectionTimeoutMs;

    @Value("${zookeeper.session-timeout-ms:''}")
    private int sessionTimeoutMs;

    @Value("${zookeeper.base-sleep-time-ms:''}")
    private int baseSleepTimeMs;

    @Value("${zookeeper.max-retries:''}")
    private int maxRetries;

    @Bean(destroyMethod = "close")
    public CuratorFramework getClient() {
        CuratorFramework client = CuratorFrameworkFactory.builder().connectString(connectString)
                .connectionTimeoutMs(connectionTimeoutMs)
                .sessionTimeoutMs(sessionTimeoutMs)
                .retryPolicy(new ExponentialBackoffRetry(baseSleepTimeMs, maxRetries))
                .build();
        client.start();
        return client;
    }
}

测试

@SpringBootTest
class CuratorTestApplicationTests {

    @Autowired
    private CuratorFramework client;

    /**
     * 创建节点
     * @throws Exception
     */
    @Test
    public void createNode() throws Exception {
        // 非递归创建
        // 持久节点
        client.create().forPath("/persistent_path", "/persistent_path data".getBytes(StandardCharsets.UTF_8));

        // 持久顺序节点
        client.create().withMode(CreateMode.PERSISTENT_SEQUENTIAL).forPath("/persistent_path/seq_");
        client.create().withMode(CreateMode.PERSISTENT_SEQUENTIAL).forPath("/persistent_path/seq_");
        client.create().withMode(CreateMode.PERSISTENT_SEQUENTIAL).forPath("/persistent_path/seq_");

        // 临时节点
        client.create().withMode(CreateMode.EPHEMERAL).forPath("/ephemeral_path", "/ephemeral_path data".getBytes(StandardCharsets.UTF_8));

        // 临时顺序节点
        client.create().withMode(CreateMode.EPHEMERAL_SEQUENTIAL).forPath("/persistent_path/eph_seq_");
        client.create().withMode(CreateMode.EPHEMERAL_SEQUENTIAL).forPath("/persistent_path/eph_seq_");
        client.create().withMode(CreateMode.EPHEMERAL_SEQUENTIAL).forPath("/persistent_path/eph_seq_");

        // sleep一段时间,验证临时节点
        Thread.sleep(60000);

        // 递归创建
        // creatingParentContainersIfNeeded() 会递归创建一个容器类型的父节点,如果当前版本不支持容器类型的父节点,则会创建一个普通的持节化节点。
        // 当容器类型的节点下的子节点全部被删除时,则该节点也会在一段时间内被删除。
        client.create().creatingParentContainersIfNeeded().forPath("/persistent_path_2/path_1", "/persistent_path_2/path_1 data".getBytes(StandardCharsets.UTF_8));
        client.create().creatingParentContainersIfNeeded().forPath("/persistent_path_2/path_2", "/persistent_path_2/path_2 data".getBytes(StandardCharsets.UTF_8));
    }

    /**
     * 节点是否存在,返回节点状态
     * @throws Exception
     */
    @Test
    public void exist() throws Exception {
        Stat stat = client.checkExists().forPath("/persistent_path");
        System.out.println(stat);
    }

    /**
     * 获取数据
     * @throws Exception
     */
    @Test
    public void getData() throws Exception {
        String data = new String(client.getData().forPath("/persistent_path"), StandardCharsets.UTF_8);
        System.out.println(data);
    }

    /**
     * 更新数据
     * @throws Exception
     */
    @Test
    public void setData() throws Exception {
        client.setData().forPath("/persistent_path", "/persistent_path update data".getBytes(StandardCharsets.UTF_8));
    }

    /**
     * 获取子节点
     * @throws Exception
     */
    @Test
    public void getChildren() throws Exception {
        List<String> childrenList = client.getChildren().forPath("/persistent_path");
        System.out.println(childrenList);
    }

    /**
     * 删除节点
     */
    @Test
    public void deleteNode() throws Exception {
        // 非递归删除
        client.delete().forPath("/persistent_path_2/path_1");
        // guaranteed() 保证在session有效的情况下,后台持续进行该节点的删除操作,直到删除掉
        client.delete().guaranteed().forPath("/persistent_path_2/path_2");

        // 递归删除当前节点及其子节点
        client.delete().deletingChildrenIfNeeded().forPath("/persistent_path");
    }

    /**
     * 事务
     * @throws Exception
     */
    @Test
    public void transaction() throws Exception {
        CuratorOp createOp = client.transactionOp().create().forPath("/persistent_path/path", "/persistent_path/path data".getBytes());
        CuratorOp setDataOp = client.transactionOp().setData().forPath("/persistent_path/path", "/persistent_path/path update data".getBytes());
        CuratorOp deleteOp = client.transactionOp().delete().forPath("/persistent_path/path");

        List<CuratorTransactionResult> resultList = client.transaction().forOperations(createOp, setDataOp, deleteOp);
        for(CuratorTransactionResult result : resultList) {
            System.out.println(result.getForPath() + " - " + result.getType());
        }
    }
}

测试事件

/**
 * 注册一次性监听事件
 * @throws Exception
 */
@Test
public void oneTimeWatcher() throws Exception {
    byte[] bytes = client.getData().usingWatcher((Watcher) watchedEvent -> {
        System.out.println("watchedEvent " + watchedEvent);
    }).forPath("/persistent_path");
    String data = new String(bytes, StandardCharsets.UTF_8);

    System.out.println("节点 /persistent_path 内容:" + data);
    // 第一次变更节点数据触发
    client.setData().forPath("/persistent_path","/persistent_path data update 1".getBytes());
    // 第二次变更节点数据没触发
    client.setData().forPath("/persistent_path","/persistent_path data update 2".getBytes());
}

/**
 * 针对 background 通知和错误通知。
 * 使用CuratorListener后,调用 inBackground() 方法会异步获得监听,对于节点的创建或修改则不会触发监听事件。
 * @throws Exception
 */
@Test
public void curatorListener() throws Exception {
    CuratorListener listener = (client, event) -> {
        System.out.println("event:" + event);
    };

    client.getCuratorListenable().addListener(listener);
    // 异步获取数据
    client.getData().inBackground().forPath("/persistent_path");
}

测试 Cache 事件

/**
 * 单独监听当前节点下所有子节点增删改
 * @throws Exception
 */
@Test
public void cache() throws Exception {
    String path = "/persistent_path";
    CuratorCache curatorCache = CuratorCache.build(client, path);

    CuratorCacheListener listener = CuratorCacheListener.builder()
            .forInitialized(() -> {
                System.out.println("初始化");
            })
            .forCreates(childData -> {
                System.out.println("添加节点:" + childData.getPath());
            })
            .forChanges(((oldNode, node) -> {
                System.out.println("更新节点:" + oldNode.getPath());
            }))
            .forDeletes(childData -> {
                System.out.println("删除节点:" + childData.getPath());
            })
            .build();
    curatorCache.listenable().addListener(listener);
    curatorCache.start();

    // 添加节点
    client.create().forPath("/persistent_path/path_1");
    client.create().forPath("/persistent_path/path_1/path_1");

    Thread.sleep(1000);

    // 更新节点
    client.setData().forPath("/persistent_path/path_1", "/persistent_path/path_1 data".getBytes());
    client.setData().forPath("/persistent_path/path_1/path_1", "/persistent_path/path_1/path_1 data".getBytes());

    Thread.sleep(1000);

    // 删除节点
    client.delete().forPath("/persistent_path/path_1/path_1");
    client.delete().forPath("/persistent_path/path_1");
}

/**
 * 监听节点数据增删改
 */
@Test
public void nodeCache() throws Exception {
    String path = "/persistent_path";
    CuratorCache curatorCache = CuratorCache.build(client, path);

    CuratorCacheListener listener = CuratorCacheListener.builder()
            .forNodeCache(() -> {
                if (curatorCache.get(path).isPresent()) {
                    System.out.print("节点 " + curatorCache.get(path).get().getPath());
                    System.out.println(" 数据变化:" + new String(curatorCache.get(path).get().getData(), StandardCharsets.UTF_8));
                }
            }).build();
    curatorCache.listenable().addListener(listener);
    curatorCache.start();

    client.setData().forPath(path, (path + " update data 1").getBytes(StandardCharsets.UTF_8));
    client.setData().forPath(path, (path + " update data 2").getBytes(StandardCharsets.UTF_8));
    client.setData().forPath(path, (path + " update data 3").getBytes(StandardCharsets.UTF_8));
}

/**
 * 监听一级子节点增删改
 */
@Test
public void pathChildrenCache() throws Exception {
    String path = "/persistent_path";
    CuratorCache curatorCache = CuratorCache.build(client, path);
    CuratorCacheListener listener = CuratorCacheListener.builder()
            .forPathChildrenCache(path, client, (client, event) -> {
                switch (event.getType()){
                    case CHILD_ADDED:
                        System.out.println("添加子节点:" + event.getData().getPath());
                        break;
                    case CHILD_UPDATED:
                        System.out.println("更新子节点:" + event.getData().getPath());
                        break;
                    case CHILD_REMOVED:
                        System.out.println("删除子节点:" + event.getData().getPath());
                        break;
                    default:
                }
            })
            .build();
    curatorCache.listenable().addListener(listener);
    curatorCache.start();

    // 添加子节点
    client.create().withMode(CreateMode.PERSISTENT_SEQUENTIAL).forPath("/persistent_path/seq_");
    client.create().withMode(CreateMode.PERSISTENT_SEQUENTIAL).forPath("/persistent_path/seq_");

    // 更新子节点
    String firstNode = client.getChildren().forPath(path).get(0);
    client.setData().forPath(path + "/" + firstNode, (path + "/" + firstNode).getBytes());

    // 删除子节点
    String secondNode = client.getChildren().forPath(path).get(1);
    client.delete().forPath(path + "/" + secondNode);
}

/**
 * 监听当前节点下所有子节点增删改
 */
@Test
public void treeNodeCache() throws Exception {
    String path = "/persistent_path";
    CuratorCache curatorCache = CuratorCache.build(client, path);
    CuratorCacheListener listener = CuratorCacheListener.builder()
            .forTreeCache(client, (client, event) -> {
                switch (event.getType()){
                    case NODE_ADDED:
                        System.out.println("添加节点:" + event.getData().getPath());
                        break;
                    case NODE_UPDATED:
                        System.out.println("更新节点:" + event.getData().getPath());
                        break;
                    case NODE_REMOVED:
                        System.out.println("删除节点:" + event.getData().getPath());
                        break;
                    default:
                }
            })
            .build();
    curatorCache.listenable().addListener(listener);
    curatorCache.start();

    // 添加节点
    client.create().forPath("/persistent_path/path_1");
    client.create().forPath("/persistent_path/path_1/path_1");

    // 更新节点
    client.setData().forPath("/persistent_path/path_1", "/persistent_path/path_1 data".getBytes());
    client.setData().forPath("/persistent_path/path_1/path_1", "/persistent_path/path_1/path_1 data".getBytes());

    // 删除节点
    client.delete().forPath("/persistent_path/path_1/path_1");
    client.delete().forPath("/persistent_path/path_1");
}

测试异步

/**
 * 异步,可指定线程池
 */
@Test
public void async() throws Exception {
    client.getData().inBackground((client, event) -> {
        System.out.println(Thread.currentThread().getName() + " " + event);
    }).forPath("/persistent_path");
}

测试分布式锁

/**
 * 排它锁
 */
@Test
public void lock() throws Exception {
    InterProcessMutex lock = new InterProcessMutex(client, "/lock");

    Thread.sleep(10000);
    System.out.println("等待获取锁");
    lock.acquire();

    System.out.println("获取锁");
    Thread.sleep(10000);

    System.out.println("释放锁");
    lock.release();
}

/**
 * 读锁
 */
@Test
public void readLock() throws Exception {
    InterProcessReadWriteLock lock = new InterProcessReadWriteLock(client, "/readLock");
    InterProcessMutex readLock = lock.readLock();

    Thread.sleep(10000);
    System.out.println("等待获取读锁");
    readLock.acquire();

    System.out.println("获取读锁");
    Thread.sleep(10000);

    System.out.println("释放读锁");
    readLock.release();
}

/**
 * 写锁
 */
@Test
public void writeLock() throws Exception {
    InterProcessReadWriteLock lock = new InterProcessReadWriteLock(client, "/writeLock");
    InterProcessMutex writeLock = lock.writeLock();

    Thread.sleep(10000);
    System.out.println("等待获取写锁");
    writeLock.acquire();

    System.out.println("获取写锁");
    Thread.sleep(10000);

    System.out.println("释放锁锁");
    writeLock.release();
}

参考:
Apache Curator
apache/curator
聊一聊 Zookeeper 客户端之 Curator
Curator Api使用

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值