Zookeeper C API 指南七(Zookeeper 辅助 API 介绍)

benzhou

　　在前面的文章中我们讲了大部分 Zookeeper  C API，相信大家已经知道怎样使用 Zookeeper  C 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 中找到。:-)