zookeeper c api 之Stat結構

在頭文件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的版本、時間戳等。

特別要注意的是——結構體變量中的類型和命令出來的信息的類型之間的轉換使用。