easyopen 1.10.1 发布,此次更新内容如下:
新增配置中心,可管理秘钥、公私钥、权限访问,限流等功能 doc
对Java和C#版本的SDK进行了重构,用法更清晰代码更稳定
新增文档页日期选择控件,方便接口调试
新增文档页导出PDF功能
此次更新的重点是配置中心
配置中心的功能有:
接入方管理:管理ISV的appk、secret,管理公私钥
权限管理:可控制接入方调用的接口权限,没有权限的接口将禁止访问。
限流管理:可控制某个接口的限流,并使用两种策略:普通限流和令牌桶限流
配置中心的管理界面图:
具体用法可到项目主页查看。
除此之外,重构SDK也是本次更新的重点,现在SDK的用法如下
Java版本:
// 创建请求对象 GetGoodsRequest request = new GetGoodsRequest(); // 请求参数 GoodsParam param = new GoodsParam(); param.setGoods_name("iphone6"); request.setParam(param); // 发送请求 GetGoodsResponse response = client.execute(request); if (response.isSuccess()) { // 返回结果 Goods goods = response.getData(); System.out.println(goods); } else { System.out.println("errorCode:" + response.getCode() + ",errorMsg:" + response.getMsg()); }
C#版本:
// 接口请求 GetGoodsRequest request = new GetGoodsRequest(); // 请求参数 GoodsParam param = new GoodsParam(); // 属性赋值 param.goods_name = "iphone6"; // 设置请求参数 request.Param = param; // 发送请求,返回结果 GetGoodsResponse response = client.Execute<GetGoodsResponse>(request); if (response.IsSuccess()) { Assert.IsTrue(response.data is Goods); Assert.IsTrue(response.data.goods_name == "苹果iPhoneX"); } else { throw new SystemException(response.msg); }
如果您使用过支付宝的SDK,会发现使用方式是类似的。
接口的封装也简单,只需三步即可, 封装步骤
关于easyopen
一个简单易用的接口开放平台,平台封装了常用的参数校验、结果返回等功能,开发者只需实现业务代码即可。
开箱即用,写完业务代码直接启动服务即可使用,无需其它配置。
参数自动校验,支持国际化参数校验(JSR-303)。
校验功能和结果返回功能实现各自独立,方便自定义实现或扩展。
采用注解来定义接口,维护简单方便。
支持i18n国际化消息返回。
自动生成文档页面,类似swagger。
采用数字签名进行参数验证,签名算法见:easyopen/签名算法.txt。
采用appKey-secret形式接入平台,即需要给接入方提供一个appKey和secret。