sf-atom接口文档说明.doc

《sf-atom接口文档说明.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、个人收集整理勿做商业用途1.Atom功能简要说明Atom支持两种全局唯一id生成的场景，两种场景分别对应atom的两个不同的子系统。场景一（atom—idonly）:单纯获取全局唯一id，不要求基于请求内存进行分配.如planid、unitid、winfoid等，业务系统每次只是从atom—idonly中获取一个全局唯一的id;场景二(atom-idword）：基于请求的内容（字符串)分配id，如果相同的内容已经分配，则返回原来已经分配的id,如果没有分配,则分配新的全局唯一id.并且支持从id到内容的反查询。如wordi

2、d(两个相同的字面，wordid要相同)；1.1.交互协议以及服务说明1.1.1.交互协议中的常量定义以下常量在atom-idonly与atom—idword中共用。常量含义备注返回码（res_status)staticconstintSG_SUCC=0；成功staticconstintATOM_INVALID_REQ_TYPE=4;不合法的请求码staticconstintATOM_EXCEED_ALLOWED_ID_NUM=5;批量请求个数超过上限staticconstintATOM_INVALID_PACK_BODY

3、=6；包体数据有问题staticconstintATOM_INVALID_HEADER=7;包头数据有问题staticconstintATOM_EXCEED_MAX_PACK=8;包体数据大小超过上限值请求码(type）1keywordid生成请求2groupid生成请求3unitid生成请求4wordid生成请求5根据id查询word请求没有查到word时,不返回改id的相应数据.6查询word是否存在请求存在返回对应的id，不存在，返回07ideaid生成请求8mcid分配请求9mediaid分配请求10tmpmcid

4、分配请求11histmcid分配请求12tmpmediaid分配请求13adrcadid分配请求14adrclaunchid分配请求其他staticconstintATOM_MAX_WORD_LEN=64；最大的word长度staticconstintIDONLY_MAX_REQ_NUM=5000;id个人收集整理勿做商业用途only类型批量请求的上限staticconstintIDWORD_MAX_REQ_NUM=2000；word类型批量请求的上限staticconstintATOM_MAX_PACK_LEN=(ATO

5、M_MAX_WORD_LEN+2＊sizeof（int)）*IDWORD_MAX_REQ_NUM最大包体长度wordid+word_len+word,所以一个数据节点的长度是2个int+word的最大长度1.1.2.服务说明2.服务可支持长、短连接。如果长连接在一段时间内没有请求数据，server会主动关闭连接，以避免资源浪费;3.支持批量请求,但是批量请求个数有上限,具体上限见协议说明；4.超时默认设置读超时：5s写超时：5s连接超时:5s1.1.1.Atom—idonly1.1.1.1.请求协议typedefstruc

6、t_pack_req_header_t｛intversion；intreq_num；intkeeplive;inttype;charreserved[8］；｝pack_req_header_t；包头协议字段定义：协议字段类型取值范围单位字段含义备注versionint必须为1版本号req_numint〉0请求的id个数keepliveint任意是否长连接0:短连接，其他为长连接typeint常量定义中的请求码1,2，3,7,8,9无请求码reservedchar［8］保留字段1.1.1.2.应答协议typedefstruc

7、t_pack_rsp_header_t｛intres_status;个人收集整理勿做商业用途unsignedintres_num;unsignedintstart_id；unsignedintend_id;unsignedintstep；charreserved［8];｝pack_rsp_header_t;返回包应答协议字段定义:协议字段类型取值范围单位字段含义备注res_statusint见常量定义部分的返回码返回状态码res_numu_int〉=0生成的id个数start_idu_int＞０分配的起始idend_idu

8、_int＞０分配的截止idstepu_int＞０id分配时的步长reservedchar[8]保留字段1.1.1.1.特殊处理说明当返回包中start_id等于end_id时，说明是１个id请求。批量时,分配的各个id是以start_id起始,end_id截止，步长为step的等差数列。数据异常时,返回