easyopen 接口开放平台 v1.16.20

 easyopen是一个简单易用的接口开放平台，平台封装了常用的参数校验、结果返回等功能，开发者只需实现业务代码即可。

easyopen的功能类似于淘宝开放平台，它的所有接口只提供一个url，通过参数来区分不同业务。这样做的好处是接口url管理方便了，平台管理者只需维护好接口参数即可。由于参数的数量是可知的，这样可以在很大程度上进行封装。封装完后平台开发者只需要写业务代码，其它功能可以通过配置来完成。

得益于Java的注解功能以及Spring容器对bean的管理，我们的开放接口平台就这样产生了。

功能特点

1、开箱即用，写完业务代码直接启动服务即可使用，无需其它配置。

2、参数自动校验，支持国际化参数校验(JSR-303)。

3、校验功能和结果返回功能实现各自独立，方便自定义实现或扩展。

4、采用注解来定义接口，维护简单方便。

5、支持i18n国际化消息返回。

6、自动生成文档页面，类似swagger。

7、采用数字签名进行参数验证，签名算法见：easyopen\签名算法.txt。

8、采用appKey-secret形式接入平台，即需要给接入方提供一个appKey和secret。

技术点

加密算法(MD5、AES、RSA)

Netty(编解码、长连接、断开重连)

限流(漏桶策略、令牌桶策略)

权限(RBAC、校验)

session(单机、分布式)

注解(文档生成)

token(jwt、accessToken)

SDK(Java、C#、JavaScript)

结构图

配置中心截图

文档页面

示例

定义接口：

@Api(name = "goods.get")public Goods getGoods(GoodsParam param) {    Goods goods = new Goods();    goods.setId(1L);    goods.setGoods_name("苹果iPhoneX");    goods.setPrice(new BigDecimal(8000));    return goods;}

请求数据：

{  "name": "goods.get",  "version": "",  "app_key": "test",  "data": "%7B%22goodsPrice%22%3A%22%22%2C%22goods_name%22%3A%22iphoneX%22%7D",  "timestamp": "2018-03-22 13:48:58",  "format": "json",  "sign": "C946ACA5AC95B1790511764A10E675B7"}

返回结果：

{    "code":"0",    "data":{        "goods_name":"苹果iPhoneX",        "id":1,        "price":8000    }}

工程说明

easyopen：easyopen：核心代码

easyopen-configuration：配置中心[可选]

easyopen-demo：接口服务端demo(含springboot,springmvc)

easyopen-ext：扩展包(提供增强功能如熔断降级等功能)

easyopen-sdk:接口对应的SDK(含Java,C#,Javascript)

easyopen-starter:springboot对应的starter

develop-doc:开发文档

使用说明

1、启动easyopen-demo下的easyopen-server-manual(业务代码在GoodsApi.java中)

2、运行easyopen-sdk下的sdk-java中的SdkTest.java