Zookeeper C API 指南三(回呼函數)(轉)

最後更新：2016-11-23 來源：互聯網

上載者：User

創建阿里雲帳戶，並獲得超過 40 款產品的免費試用版；而企業帳戶則可以享有總值 $1200 的免費試用版。立即註冊！

標籤：let and 用戶端 comment com pos char 出錯 stat

2013-02-21 12:54 by Haippy, 9237 閱讀, 0 評論, 收藏, 編輯

接上一篇《Zookeeper C API 指南二(監視(Wathes), 基本常量和結構體介紹)》，本文重點介紹 Zookeeper C API 中的各種回呼函數。

Zookeeper C API 中各種回呼函數簡介

在具體介紹 Zookeeper C API 之前，首先介紹一下 Zookeeper C API 中的各種回呼函數的原型：

監視函數(watch function)原型

typedef void (*watcher_fn)(zhandle_t *zh, int type, int state, const char *path,void *watcherCtx);

監視函數原型的各個參數解釋如下：

zh	zookeeper 控制代碼(handle)
type	*事件類型(event type). _EVENT 常量之一.**
state	*串連狀態(connection state). 狀態值為 _STATE 常量之一.**
path	觸發監視事件的 znode 節點的路徑，若為 NULL，則事件類型為 ZOO_SESSION_EVENT
watcherCtx	監視器上下文(watcher context).

其他回呼函數的原型

Zookeeper 中還有幾種在非同步 API(一般以 zoo_a*開頭的函數) 中使用的回呼函數，根據回呼函數處理非同步函數傳回值類型的不同分為以下幾類：處理返回 void 類型的回呼函數，處理返回 Stat 結構的回呼函數，處理返回字串的回呼函數，處理返回資料的回呼函數，處理返回字串列表(a list of string)的回呼函數，同時處理返回字串列表(a list of string)和 Stat 結構的回呼函數，以及處理返回 ACL 資訊的回呼函數，它們分別如下：

// 處理返回 void 類型的回呼函數typedef void(* void_completion_t)(int rc, const void *data);// 處理返回 Stat 結構的回呼函數typedef void(* stat_completion_t)(int rc, const struct Stat *stat, const void *data); // 處理返回字串的回呼函數typedef void(* string_completion_t)(int rc, const char *value, const void *data); // 處理返回資料的回呼函數typedef void(* data_completion_t)(int rc, const char *value, int value_len, const struct Stat *stat, const void *data); // 處理返回字串列表(a list of string)的回呼函數typedef void(* strings_completion_t)(int rc, const struct String_vector *strings, const void *data); // 同時處理返回字串列表(a list of string)和 Stat 結構的回呼函數typedef void(* strings_stat_completion_t)(int rc, const struct String_vector *strings, const struct Stat *stat, const void *data); // 處理以及返回 ACL 資訊的回呼函數typedef void(* acl_completion_t)(int rc, struct ACL_vector *acl, struct Stat *stat, const void *data);

下面一一介紹上述幾種回呼函數的用法：

處理返回 void 類型的回呼函數

typedef void(* void_completion_t)(int rc, const void *data)

該回呼函數一般在非同步 API 呼叫結束或 Zookeeper 用戶端失去串連時被調用。

非同步函數調用返回的錯誤碼，串連丟失/逾時將觸發該原型函數(此處指具有該函數原型的回呼函數，下同)的調用，並且錯誤碼為 ZCONNECTIONLOSS -- Zookeeper 用戶端與伺服器端的串連丟失，或者 ZOPERATIONTIMEOUT -- 連線逾時；而與資料相關的事件也會觸發該原型函數的調用，同時置相應的錯誤碼，具體見後文(0 代非同步函數調用成功)

data

由調用者傳入的指標，調用者可以通過該指標向回呼函數傳入自訂的參數，開發人員應負責此指標所指向記憶體的釋放。

處理返回 Stat 結構的回呼函數

typedef void(* stat_completion_t)(int rc, const struct Stat *stat, const void *data)