easyopen
一个简单易用的接口开放平台,平台封装了常用的参数校验、结果返回等功能,开发者只需实现业务代码即可。
git地址:https://gitee.com/durcframework/easyopen
easyopen的功能类似于淘宝开放平台,它的所有接口只提供一个url,通过参数来区分不同业务。这样做的好处是接口url管理方便了,平台管理者只需维护好接口参数即可。由于参数的数量是可知的,这样可以在很大程度上进行封装。封装完后平台开发者只需要写业务代码,其它功能可以通过配置来完成。
得益于Java的注解功能以及Spring容器对bean的管理,我们的开放接口平台就这样产生了。
功能特点
- 开箱即用,写完业务代码直接启动服务即可使用,无需其它配置。
- 参数自动校验,支持国际化参数校验(JSR-303)。
- 校验功能和结果返回功能实现各自独立,方便自定义实现或扩展。
- 采用注解来定义接口,维护简单方便。
- 支持i18n国际化消息返回。
- 自动生成文档页面,类似swagger。
- 采用数字签名进行参数验证,签名算法见:easyopen\签名算法.txt。
- 采用appKey-secret形式接入平台,即需要给接入方提供一个appKey和secret。
结构图
文档页面
工程说明
- easyopen:easyopen核心代码
- easyopen-server:开放平台服务端(spring-boot),接口提供方
- easyopen-sdk:接口对应的开发包,配合server使用
- static:文档静态资源
- index.html:文档首页,配合Pages功能使用
使用说明
- 启动easyopen-server(业务代码在GoodsApi.java中)
- 运行easyopen-sdk中的SdkTest.java
文档页面:http://localhost:8080/api/doc
开发文档
意见交流
Q群:328419269