(完整版)zookeeperCAPI中文翻译.doc

1、错误码ZOO_ERRORSZOK正常返回ZSYSTEMERROR系统或服务器端错误(Systemandserver-sideerrors)，服务器不会抛出该错误，该错误也只是用来标识错误范围的，即大于该错误值，且小于ZAPIERROR都是系统错误。ZRUNTIMEINCONSISTENCY运行时非一致性错误。ZDATAINCONSISTENCY数据非一致性错误。ZCONNECTIONLOSSZookeeper客户端与服务器端失去连接ZMARSHALLINGERROR在编码和解码数据时出现错误ZUNIMPLEMENTED该操作未实现/未执行ZOPERATIONTIMEOUT该操作超时ZBADARGUMENTS非法参数错误ZINVALIDSTATE非法句柄状态ZAPIERRORAPI错误(APIerrors)，服务器不会抛出该错误，该错误也只是用来标识错误范围的，错误值大于该值的标识API错误，而小于该值的标识ZSYSTEMERROR。ZNONODE节点不存在(Nodedoesnotexist)ZNOAUTH没有经过授权(Notauthenticated)ZBADVERSION版本冲突(Versionconflict)ZNOCHILDRENFOREPHEMERALS临时节点不能拥有子节点(Ephemeralnodesmaynothavechildren)ZNODEEXISTS节点已经存在(Thenodealreadyexists)ZNOTEMPTY该节点具有自身的子节点(Thenodehaschildren)ZSESSIONEXPIRED会话过期(Thesessionhasbeenexpiredbytheserver)ZINVALIDCALLBACK非法的回调函数(Invalidcallbackspecified)ZINVALIDACL非法的ACL(InvalidACLspecified)ZAUTHFAILED客户端授权失败(Clientauthenticationfailed)ZCLOSINGZookeeper连接关闭(ZooKeeperisclosing)ZNOTHING并非错误，客户端不需要处理服务器的响应(noterror,noserverresponsestoprocess)ZSESSIONMOVED会话转移至其他服务器，所以操作被忽略(sessionmovedtoanotherserver,sooperationisignored)2、日志级别enumZooLogLevel{ZOO_LOG_LEVEL_ERROR=1,ZOO_LOG_LEVEL_WARN=2,ZOO_LOG_LEVEL_INFO=3,ZOO_LOG_LEVEL_DEBUG=4}3、常量3.1、与ZNODE访问权限相关的常量ZOO_PERM_READ;//允许客户端读取znode节点的值以及子节点列表ZOO_PERM_WRITE;//允许客户端设置znode节点的值ZOO_PERM_CREATE;//允许客户端在该znode节点下创建子节点ZOO_PERM_DELETE;//允许客户端删除子节点ZOO_PERM_ADMIN;//允许客户端执行set_acl()ZOO_PERM_ALL;//允许客户端执行所有操作，等价上述所有标识的或3.2、ACLIDs相关的常量structIdZOO_ANYONE_ID_UNSAFE;//表示所有人（’world’,’anyone’）structIdZOO_AUTH_IDS;//仅仅用于设置ACLs(‘auth’,’’)3.3、三种标准的ACLstructACL_vectorZOO_OPEN_ACL_UNSAFE;//全开放权限structACL_vectorZOO_READ_ACL_UNSAFE;//所有人可读权限structACL_vectorZOO_CREATOR_ALL_ACL;//授予创建者ID所有权限3.4、与Interest相关的常量ZOOKEEPER_WRITE,ZOOKEEPER_READ这两个常量用于标识感兴趣的事件并通知zookeeper发生了哪些事件。Interest常量可以进行组合或（OR）来标识多种兴趣(multipleinterests:write,read)，这两个常量一般用于zookeeper_interest()和zookeeper_process()两个函数中。3.5、与节点创建相关的常量ZOO_EPHEMERAL,ZOO_SEQUENCEzoo_create函数标志，ZOO_EPHEMERAL用来标识创建临时节点，ZOO_SEQUENCE用来标识节点命名具有递增的后缀序号(一般是节点名称后填充10位字符的序号，如/xyz0000000000,/xyz0000000001,/xy