在前面的文章中我们讲了大部分 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 的日志流为文件。
- 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 zoo_state(zhandle_t * zh);
- ZOOAPI const char * zerror(int c);
- ZOOAPI int is_unrecoverable(zhandle_t * zh);
好了,Zookeeper 大部分的辅助函数就介绍到这里了,大家可以更多文档可以在 zookeeper.h 中找到。:-)
来源: http://it.taocms.org/03/22.htm