Zookeeper C API 指南七(Zookeeper 辅助 API 介绍)
在前面的文章中我们讲了大部分 ZookeeperC API，相信大家已经知道怎样使用 ZookeeperC API了吧。我曾在《Zookeeper C API 指南》系列文章的第四篇《Zookeeper C API 指南四(C API 概览)》中也 Zookeeper C API 的分为了 5 类，他们分别是：(1)、初始化、销毁 Zookeeper 句柄，(2)、与 zoo_multi() 和 zoo_amulti() 批量操作相关的 zoo_op_t 初始化函数，(3)、同步 API，(4)、异步 API，(5)、辅助函数。其中“(1)、初始化、销毁 Zookeeper 句柄”已经在《Zookeeper C API 指南四(C API 概览)》中介绍过了，并且在《Zookeeper C API 指南五(同步 API 介绍)》和《Zookeeper C API 指南六(异步 API 介绍)》中我们又分别讲了“同步 API” 和 “异步 API”（其中也简单地介绍了一下与 zoo_multi() 和 zoo_amulti() 批量操作相关的 zoo_op_t 初始化函数），所以接下来我们再来讲讲 Zookeeper C API 中的 “辅助函数”。我们分类的 Zookeeper C API 中辅助函数如下：
ZOOAPI void zoo_set_debug_level(ZooLogLevel logLevel);
ZOOAPI void zoo_set_log_stream(FILE * logStream);
ZOOAPI const clientid_t *zoo_client_id(zhandle_t * zh);
ZOOAPI int zoo_recv_timeout(zhandle_t * zh);
ZOOAPI const void *zoo_get_context(zhandle_t * zh);
ZOOAPI void zoo_set_context(zhandle_t * zh, void *context);
ZOOAPI watcher_fn zoo_set_watcher(zhandle_t * zh, watcher_fn newFn);
ZOOAPI struct sockaddr *zookeeper_get_connected_host(zhandle_t * zh, struct sockaddr
*addr,
socklen_t * addr_len);
ZOOAPI int zookeeper_interest(zhandle_t * zh, int *fd, int *interest,
struct timeval *tv);
ZOOAPI int zookeeper_process(zhandle_t * zh, int events);
ZOOAPI int zoo_state(zhandle_t * zh);
ZOOAPI const char *zerror(int c);
ZOOAPI int is_unrecoverable(zhandle_t * zh);
ZOOAPI void zoo_deterministic_conn_order(int yesOrNo);
下面我们来讲讲其中比较常用的几个函数吧 :-)
[*] 设置日志等级
ZOOAPI void zoo_set_debug_level(ZooLogLevel logLevel);
其中 logLevel 可以是ZOO_LOG_LEVEL_ERROR, ZOO_LOG_LEVEL_WARN, ZOO_LOG_LEVEL_INFO, ZOO_LOG_LEVEL_DEBUG四个取值。
[*]设置日志流
ZOOAPI void zoo_set_log_stream(FILE * logStream);
Zookeeper C API 默认的日志流是标准输出，可以通过该函数设置 Zookeeper C API的日志流为文件。
[*]获取客户端的 session id，只有在客户端的当前连接状态有效时才可以。
ZOOAPI const clientid_t *zoo_client_id(zhandle_t * zh);
[*]返回当前会话的超时时间，只有在客户端的当前连接状态有效时才可以。
ZOOAPI int zoo_recv_timeout(zhandle_t * zh);
[*]获取 Zookeeper 句柄的上下文。
ZOOAPI const void *zoo_get_context(zhandle_t * zh);
[*]设置 Zookeeper 句柄的上下文。
ZOOAPI void zoo_set_context(zhandle_t * zh, void *context);
[*]设置 Zookeeper 句柄的全局监视器回调函数，该函数返回全局监视器的旧回调函数。
ZOOAPI watcher_fn zoo_set_watcher(zhandle_t * zh, watcher_fn newFn);
[*]返回当前 Zookeeper 连接的套接字地址。
ZOOAPI struct sockaddr *zookeeper_get_connected_host(zhandle_t * zh, struct sockaddr
*addr,
socklen_t * addr_len);
[*]获取当前 Zookeeper 连接状态。
ZOOAPI int zoo_state(zhandle_t * zh);
[*]返回某一错误码的字符串表示。
ZOOAPI const char *zerror(int c);
[*]检查当前 Zookeeper 连接是否为不可恢复的，如果不可恢复，则客户端需要关闭连接，然后重连。
ZOOAPI int is_unrecoverable(zhandle_t * zh);
好了，Zookeeper 大部分的辅助函数就介绍到这里了，大家可以更多文档可以在 zookeeper.h 中找到。:-)
页:
[1]