软件简介

概述

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

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

• 全局序列号发生器 为分布式、集群化系统提供有序增长、全局唯一、可反解的高性能序列号生成分发服务

• 全局额度管理器 为分布式、集群化系统提供对理财额度、库存数量等高频热点对象的高性能无锁接口服务

1.1.全局序列号发生器

1.1.1.序列号格式

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

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

如序列号：aR2011o_cWG00002

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

1.1.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.全局额度管理器

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

1.2.1.使用过程

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

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

1.2.2.服务接口

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