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

在前面的文章中我们讲了大部分 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 中找到。:-)