Zookeeper 辅助 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);