coconut 1.1.全局序列号发生器1.2.全局额度管理器

coconut 1.1.全局序列号发生器1.2.全局额度管理器介绍

概述

coconut是一款应用缓存服务器，主要用于场景化的缓存服务。

coconut目前提供了两种场景模式：全局序列号发生器、全局额度管理器，可成为分布式、集群化系统架构中高性能独立功能部件。

全局序列号发生器为分布式、集群化系统提供有序增长、全局唯一、可反解的高性能序列号生成分发服务
全局额度管理器为分布式、集群化系统提供对理财额度、库存数量等高频热点对象的高性能无锁接口服务

1.1.全局序列号发生器

coconut生成的序列号为16个64进制可见字符组成，具体格式如下：

区号	区名	说明
第一区	分区目录	2个六十四进制字符共12个二进制位第一段3个二进制位表示保留区六十四进制字符个数第二段3个二进制位表示服务器编号区六十四进制字符个数第三段3个二进制位表示秒戳区六十四进制字符个数第四段3个二进制位表示序号区六十四进制字符个数
第二区	保留区	1个六十四进制字符有6个二进制位可用
第三区	服务器编号区	2个六十四进制字符可表示4096台发起器服务器
第四区	秒戳区	6个六十四进制字符可表示2179年的秒戳
第五区	序号区	5个六十四进制字符序号区间[1,10亿]
		共16个六十四进制字符

（64进制字符集合：0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-_）

如序列号：aR2011o_cWG00002

反解出来包含如下信息：reserve: 2 server_no: 1 secondstamp: 1492962986(2017-04-23
23:56:26) serial_no: 2

coconut的全局序列号发生器提供了2个HTTP接口：

获取序列号
方法 : GET
URL : http://(domain|ip):[port]/fetch
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送一个有序增长的全局唯一的序列号，如aR2011o_cWG00002；如果发生系统级错误，返回HTTP状态码非200
备注 : 可利用备注区区分业务类型；可利用服务器编号部署序列号发生器集群
反解序列号
方法 : GET
URL : http://(domain|ip):[port]/explain?sequence=(序列号)
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送反解文本；如果发生系统级错误，返回HTTP状态码非200
备注 : 反解文本格式”reserve: (保留值) server_no: (服务器编号) secondstamp: (1970年至今秒戳)((人可阅读的日期时间格式)) serial_no: (序号)”

1.2.全局额度管理器

全局额度管理器提供高性能无锁接口对额度、库存等高频热点对象做查询额度、申请额度、撤销流水、补充额度、扣减额度、清空额度等处理。

命令行指定额度、导出结果流水文件名启动coconut，coconut对外提供HTTP接口，客户端可长/短连接发送指令给coconut以操作额度。期间还可以补充、扣减甚至清空额度。当额度为0时自动导出结果流水文件，可能会重复导出覆盖导出文件。

导出结果流水文件格式为每行一条流水，白字符分割为两列：申请流水号、申请额度，如果某流水被撤销则再加一列：撤销流水号。

coconut的全局额度管理器提供了6个HTTP接口：

查询额度
方法 : GET
URL : http://(domain|ip):[port]/query
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送”(剩余额度值)”，如果发生参数错误则返回”-1”；如果发生系统级错误，返回HTTP状态码非200
申请额度
方法 : GET
URL : http://(domain|ip):[port]/apply?amt=(额度值)
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送”(申请流水号) (剩余额度值)”，如果额度已空或额度不够则返回”0”，如果发生参数错误则返回”-1”；如果发生系统级错误，返回HTTP状态码非200
撤销流水
方法 : GET
URL : http://(domain|ip):[port]/cancel?jnlsno=(申请流水号)
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送”(撤销流水号) (剩余额度值)”，如果找不到原申请流水或已被撤销则返回”0”，如果发生参数错误则返回”-1”；如果发生系统级错误，返回HTTP状态码非200
补充额度
方法 : GET
URL : http://(domain|ip):[port]/increase?amt=(额度值)
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送”(剩余额度值)”，如果发生参数错误则返回”-1”；如果发生系统级错误，返回HTTP状态码非200
扣减额度
方法 : GET
URL : http://(domain|ip):[port]/decrease?amt=(额度值)
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送”(剩余额度值)”，如果发生参数错误则返回”-1”；如果发生系统级错误，返回HTTP状态码非200
清空额度
方法 : GET
URL : http://(domain|ip):[port]/empty
返回值 : 如果调用成功，返回HTTP状态码200，HTTP体中回送”(剩余额度值)”，如果发生参数错误则返回”-1”；如果发生系统级错误，返回HTTP状态码非200