.NET Core）的ZooKeeper异步客户端

支持断线重连、永久watcher、递归操作并且能跨平台（.NET Core）的ZooKeeper异步客户端

 

阅读目录

• 什么是ZooKeeper？
• 项目介绍
• 提供的功能
• 使用说明
• FAQ

在公司内部的微服务架构中有使用到了“ZooKeeper”，虽然官方有提供了.NET的SDK，但易用性非常的差，且搜遍github、nuget，没有发现一个可以跨平台且易用的组件，所以我又“美化”了一个轮子。

回到目录

什么是ZooKeeper？

ZooKeeper是一个分布式的，开放源码的分布式应用程序协调服务，是Google的Chubby一个开源的实现，是Hadoop和Hbase的重要组件。它是一个为分布式应用提供一致性服务的软件，提供的功能包括：配置维护、域名服务、分布式同步、组服务等。

ZooKeeper的目标就是封装好复杂易出错的关键服务，将简单易用的接口和性能高效、功能稳定的系统提供给用户。

回到目录

项目介绍

该项目使用了 Apache ZooKeeper .NET async Client 组件，除提供了基本的zk操作，还额外封装了常用的功能以便让.net开发者更好的使用zookeeper。

此项目是开源的，采用了：Apache 2.0开源协议。

支持的平台

1. .NET 4及以上
2. .NET Core

项目地址

GitHub：https://github.com/RabbitTeam/zookeeper-client

NuGet：https://www.nuget.org/packages/Rabbit.Zookeeper/

回到目录

提供的功能

1. session过期重连
2. 永久watcher
3. 递归删除节点
4. 递归创建节点
5. 跨平台（支持.net core）

回到目录

使用说明

下面列一下常用的使用方法，不仅限于此哦！

创建连接

创建节点

获取节点数据

获取子节点

判断节点是否存在

删除节点

更新节点

订阅数据变化

订阅子节点变化

回到目录

FAQ

什么时候会触发 "SubscribeDataChange" 事件 ?

在以下情况下会触发通过 "SubscribeDataChange" 方法订阅的事件：

1. 节点被创建
2. 节点被删除
3. 节点数据发生改变
4. zk连接重连成功

什么时候会触发 "SubscribeChildrenChange" 事件 ?

在以下情况下会触发通过 "SubscribeChildrenChange" 方法订阅的事件：

1. 节点被创建
2. 节点被删除
3. 节点子节点发生改变
4. zk连接重连成功

如何在 "xxxxChange" 事件中区分节点的状态 ?

在事件触发参数会有个类型为 "EventType" 的属性 "Type"，通过该属性可以清楚的区分出节点变更的原因。

为什么要写这个程序，它与 "ZooKeeperEx" 有什么区别 ?

官方提供的组件，只提供了基本的api，在正常的zk使用情景中需要做非常复杂的事情，滋生出很多额外的代码并且不能保证其执行的正确性。

在java语言中也有对官方zk进行封装的包 ZKClient，当前组件也是参考了这个项目。具体组件包提供了什么功能请参考 "提供的功能" 这一节。

有问题怎么办？

可以通过以下方式联系我（依据最容易得到处理优先级排序）：

1. 在github上建立Issues
2. 加入QQ群：384413261（点击加入：RabbitHub）进行提问
3. 给我发邮件，majian159@live.com
4. 站内私信我