Zookeeper C API 指南一(准备工作)

以前自己的博客中转载、翻译或写过(不过自己才疏学浅，写的不好)一些 Zookeeper 方面的文章，但是都没有涉及到 Zookeeper C API 的内容，今天的这篇博客是我农历新年的第一篇技术博客，我想详细讲讲 Zookeeper C API 的使用规则和示例，算是把以前的旧帐还上吧 :-)

Zookeeper 官方页面上提供了一些编程指南 和 API 文档，不过大部分都是 Java 示例，涉及 C API 的部分很少，只有在 ZooKeeper Programmer's Guide 中 ACL Permissions 一节讲了 Zookeeper C API 中设置 ACL 应该注意的事项，正是由于缺少Zookeeper C API 相关的资料，大部分 Zookeeper C/C++ 开发者只能通过阅读 Zookeeper C API 的源码来了解 C API 的使用方法，本文希望在此方面给大家提供一些便利，减少 Zookeeper 新手使用 C API 的困难和恐惧，当然我自己也是一枚新手啦 :-)。

废话不多说了，先从最基本的开始吧!

Zookeeper 伪分布式安装

首先是 Zookeeper 的安装，如果你没有足够的机器，建议在单机上通过伪分布式安装方法来模拟 Zookeeper 集群，我在这里提供给大家一个简单的安装包来降低伪分布式 Zookeeper 的安装难度，该安装包可以模拟一个 5 Zookeeper 实例的集群。下载 zookeeper-3.4.0-pseudoclusters.tar.bz2，解压至 /tmp/ 目录（注意，安装包里面 dataDir 和 dataLogDir 配置已经预设为 /tmp/ 目录，如果你只是自己在 Zookeeper 上做一些小实验，建议不要更改该配置，这样在你做完了实验以后删除 /tmp/zookeeper/ 目录即可），操作方法如下：

forhappy@haiping-ict:/tmp$ pwd
/tmp
forhappy@haiping-ict:/tmp$ tar xvf zookeeper-3.4.0-pseudoclusters.tar.bz2
forhappy@haiping-ict:/tmp$ cd zookeeper/
forhappy@haiping-ict:/tmp/zookeeper$ ls
server001  server003  server005          stopZKCluster.sh
server002  server004  startZKCluster.sh

然后在 /tmp/zookeeper 目录下执行 startZKCluster.sh 启动 Zookeeper 服务，或者执行 stopZKCluster.sh 停掉 Zookeeper 服务。

启动 Zookeeper 服务：

forhappy@haiping-ict:/tmp/zookeeper$ ./startZKCluster.sh .
starting zookeeper instance server001...
JMX enabled by default
Using config: /tmp/zookeeper/server001/zookeeper-3.4.0/bin/../conf/zoo.cfg
Starting zookeeper ... STARTED
starting zookeeper instance server002...
JMX enabled by default
Using config: /tmp/zookeeper/server002/zookeeper-3.4.0/bin/../conf/zoo.cfg
Starting zookeeper ... STARTED
starting zookeeper instance server003...
JMX enabled by default
Using config: /tmp/zookeeper/server003/zookeeper-3.4.0/bin/../conf/zoo.cfg
Starting zookeeper ... STARTED
starting zookeeper instance server004...
JMX enabled by default
Using config: /tmp/zookeeper/server004/zookeeper-3.4.0/bin/../conf/zoo.cfg
Starting zookeeper ... STARTED
starting zookeeper instance server005...
JMX enabled by default
Using config: /tmp/zookeeper/server005/zookeeper-3.4.0/bin/../conf/zoo.cfg
Starting zookeeper ... STARTED

停掉 Zookeeper 服务：

forhappy@haiping-ict:/tmp/zookeeper$ ./stopZKCluster.sh .
stopping zookeeper instance server001...
JMX enabled by default
Using config: /tmp/zookeeper/server001/zookeeper-3.4.0/bin/../conf/zoo.cfg
Stopping zookeeper ... STOPPED
stopping zookeeper instance server002...
JMX enabled by default
Using config: /tmp/zookeeper/server002/zookeeper-3.4.0/bin/../conf/zoo.cfg
Stopping zookeeper ... STOPPED
stopping zookeeper instance server003...
JMX enabled by default
Using config: /tmp/zookeeper/server003/zookeeper-3.4.0/bin/../conf/zoo.cfg
Stopping zookeeper ... STOPPED
stopping zookeeper instance server004...
JMX enabled by default
Using config: /tmp/zookeeper/server004/zookeeper-3.4.0/bin/../conf/zoo.cfg
Stopping zookeeper ... STOPPED
stopping zookeeper instance server005...
JMX enabled by default
Using config: /tmp/zookeeper/server005/zookeeper-3.4.0/bin/../conf/zoo.cfg
Stopping zookeeper ... STOPPED

Zookeeper C API 安装

Zookeeper C client 的实现在 src/c 目录下，进入到该目录安装 Zookeeper C client，步骤如下：

$ ./configure
$ make
$ sudo make install

至此，基本的准备工作已经完成，你可以通过 Zookeeper 本身提供的 Shell 来操作 Zookeeper，操作方法如下，进入 /tmp/zookeeper/server001/zookeeper-3.4.0 目录，执行bin/zkCli.sh -server 127.0.0.1:2181 进入 Zookeeper shell：

forhappy@haiping-ict:/tmp/zookeeper/server001/zookeeper-3.4.0$ bin/zkCli.sh -server 127.0.0.1:2181

[zk: 127.0.0.1:2181(CONNECTED) 2] help
ZooKeeper -server host:port cmd args
    connect host:port
    get path [watch]
    ls path [watch]
    set path data [version]
    rmr path
    delquota [-n|-b] path
    quit 
    printwatches on|off
    create [-s] [-e] path data acl
    stat path [watch]
    close 
    ls2 path [watch]
    history 
    listquota path
    setAcl path acl
    getAcl path
    sync path
    redo cmdno
    addauth scheme auth
    delete path [version]
    setquota -n|-b val path

在 shell 中你可以完成基本的操作，如创建、获取、删除、设置某一节点，设置节点 ACL等，可以 zookeeper shell 中通过 help 获取相关命令的用法。

如果你按照上面的步骤完成了 Zookeeper 伪分布式的安装，并且想继续了解 Zookeeper C API 的使用方法，请继续阅读《Zookeeper C API 指南二(监视(Wathes), 基本常量和结构体介绍)》