zookeeper c api 之Stat结构及封装

zookeeper c api 之Stat结构及封装

zookeeper入门学习

zookeeper运维操作指南

解读zookeeper的配置项

zookeeper API常用函数功能与参数详解

在头文件zookeeper.jute.h中，找到Stat这个结构，首先需要明白这个变量的特点：

1 存在大部分的zookeeper c api的参数中

2 作为znode的节点信息变量传递出去，供外部查询和使用

结构声明如下：

struct Stat {
    int64_t czxid;
    int64_t mzxid;
    int64_t ctime;
    int64_t mtime;
    int32_t version;
    int32_t cversion;
    int32_t aversion;
    int64_t ephemeralOwner;
    int32_t dataLength;
    int32_t numChildren;
    int64_t pzxid;
};

举一个节点的例子可以见

[zk: 10.15.107.155:3352(CONNECTED) 111] stat /c/hfx/sw1
cZxid = 0x2000007df
ctime = Thu Mar 14 11:08:28 CST 2013
mZxid = 0x200000a87
mtime = Thu Mar 14 15:00:34 CST 2013
pZxid = 0x2000007df
cversion = 0
dataVersion = 608
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 6
numChildren = 0

要地说明cZxid表示创建该节点时候的zxid，mZxid表示当前的，zxid是用来为选举leader服务的，具体可以阅读zookeeper的原理。

我通常会用到ctime和mtime，前者表示创建的时间，后者表示最近一次更新的时间。要注意的是ctime就定死了创建的那一刻，而mtime会在你调用更改节点函数的时候重新设置；但是exists和get是不会引起其更新的。这个特点可以给我们在业务上很灵活的发挥作用——比如我们想作一些过期判断等就可以运用此参数。但是需要注意的是，我们stat命令出来的是时间字符串，而Stat结构里面是时间戳，两者需要做一个转换，转换的方法可以参考如下：　 

time_t  tmtime = stat.mtime/1000; struct  tm  * last = localtime (&tmtime); char  tmtimes[16]; sprintf (tmtimes, "%4d%02d%02d%02d%02d%02d" , last->tm_year+1900, last->tm_mon+1, last->tm_mday, last->tm_hour, last->tm_min, last->tm_sec); int64_t lasttime = (int64_t)strtoll(tmtimes, NULL, 10);

 当然你可以可以参考zookeeper源码里的东西：

void dumpStat(const struct Stat *stat) {
    char tctimes[40];
    char tmtimes[40];
    time_t tctime;
    time_t tmtime;

    if (!stat) {
        fprintf(stderr,"null\n");
        return;
    }   
    tctime = stat->ctime/1000;
    tmtime = stat->mtime/1000;
    fprintf(stderr, "\tctime = %s\tczxid=%llx\n"
    "\tmtime=%s\tmzxid=%llx\n"
    "\tversion=%x\taversion=%x\n"
    "\tephemeralOwner = %llx\n",
    ctime_r(&tctime, tctimes), _LL_CAST_ stat->czxid, ctime_r(&tmtime, tmtimes),
    _LL_CAST_ stat->mzxid,
    (unsigned int)stat->version, (unsigned int)stat->aversion,
    _LL_CAST_ stat->ephemeralOwner);
}

 其他几个变量一般供查询使用，比如你想了解有几个子节点，就查看numChildren参数。

根据自己的业务需求，适当地使用他们。

在zookeeper的api中，大部分都有两套接口，一个是不需要传Stat stat参数的，一个是需要传入stat的；选择哪一个就在于你是否想获取znode的状态。

一般而言，我们主要想关心的是znode的版本、时间戳等。

特别要注意的是——结构体变量中的类型和命令出来的信息的类型之间的转换使用。

封装函数如下:

int
zkconn::get_node(const char *path, char *buf, int *size, int *ts_ctime, int *ts_mtime)
{
    int i, ret, res = -1;
    struct Stat stat;

    debug2(g_log, "path: %s\n", path);

    for(i = 0; i < _retry; i++){
        if(!conned()){
            log2(g_log, "zookeeper not connected\n");
            res = -1;
            sleep(_sleep);
            continue;
        }

        zkconn_lock();
        ret = zoo_get(_zh, path, 0, buf, size, &stat);
        zkconn_unlock();

        if(ret == ZOK){
            debug2(g_log, "zoo_get succed, %s\n", path);
            if(ts_ctime){
                *ts_ctime = stat.ctime / 1000;
            }
            if(ts_mtime){
                *ts_mtime = stat.mtime / 1000;
            }
            res = 1;
            break;
        } else if(ret == ZNONODE) {
            debug2(g_log, "zookeeper node not exist, %s\n", path);
            res = 0;
            break;
        } else {
            log2(g_log, "zoo_get error, %s\n", path);
            res = -1;
            sleep(_sleep);
        }
    }

    return res;
}