sf_atom接口文档说明.docVIP

Atom功能简要说明 Atom支持两种全局唯一id生成的场景，两种场景分别对应atom的两个不同的子系统。 场景一（atom-idonly）：单纯获取全局唯一id，不要求基于请求内存进行分配。如planid、unitid、winfoid等，业务系统每次只是从atom-idonly中获取一个全局唯一的id； 场景二（atom-idword）：基于请求的内容（字符串）分配id，如果相同的内容已经分配，则返回原来已经分配的id，如果没有分配，则分配新的全局唯一id。并且支持从id到内容的反查询。如wordid（两个相同的字面，wordid要相同）； 交互协议以及服务说明 交互协议中的常量定义 以下常量在atom-idonly与atom-idword中共用。 常量含义备注返回码（res_status）static const int SG_SUCC = 0;成功static const int ATOM_INVALID_REQ_TYPE = 4; 不合法的请求码static const int ATOM_EXCEED_ALLOWED_ID_NUM = 5;批量请求个数超过上限static const int ATOM_INVALID_PACK_BODY = 6;包体数据有问题static const int ATOM_INVALID_HEADER = 7;包头数据有问题static const int ATOM_EXCEED_MAX_PACK = 8;包体数据大小超过上限值请求码（type）1keyword id生成请求2group id生成请求3unit id生成请求4word id生成请求5根据id查询word请求没有查到word时,不返回改id的相应数据.6查询word是否存在请求存在返回对应的id,不存在,返回07idea id生成请求8mc id分配请求9media id分配请求10tmp mc id分配请求11hist mc id分配请求12tmp mediaid分配请求13adrc adid分配请求14adrc launchid分配请求其他static const int ATOM_MAX_WORD_LEN = 64;最大的word长度static const int IDONLY_MAX_REQ_NUM = 5000;id only类型批量请求的上限static const int IDWORD_MAX_REQ_NUM = 2000;word类型批量请求的上限static const int ATOM_MAX_PACK_LEN = (ATOM_MAX_WORD_LEN + 2 * sizeof(int)) * IDWORD_MAX_REQ_NUM最大包体长度word id + word_len + word, 所以一个数据节点的长度是2个int + word的最大长度  服务说明 服务可支持长、短连接。如果长连接在一段时间内没有请求数据，server会主动关闭连接，以避免资源浪费； 支持批量请求，但是批量请求个数有上限，具体上限见协议说明； 超时默认设置 读超时: 5s 写超时: 5s 连接超时: 5s Atom-idonly 请求协议 typedef struct _pack_req_header_t { int version; int req_num; int keeplive; int type; char reserved[8]; } pack_req_header_t; 包头协议字段定义： 协议字段类型取值范围单位字段含义备注versionint必须为1版本号req_numint0请求的id个数keepliveint任意是否长连接0:短连接，其他为长连接typeint常量定义中的请求码1, 2, 3, 7,8,9无请求码reservedchar[8]保留字段 应答协议 typedef struct _pack_rsp_header_t { int res_status; unsigned int res_num; unsigned int start_id; unsigned int end_id; unsigned int step; char reserved[8]; } pack_rsp_header_t; 返回包应答协议字段定义： 协议字段类型取值范围单位字段含义