错误处理 i18n国际化 国际化消息传参 错误处理 easyopen对错误处理已经封装好了，最简单的做法是向上throw即可，在最顶层的Controller会做统一处理。例如： if ( StringUtils . isEmpty ( param . getGoods_name ())) { throw new Api...

自定义序列化 easyopen序列化使用fastjson处理json，xstream处理xml。现在我们来自定义实现一个json处理： 新建一个类JsonFormatter，实现ResultSerializer接口 public class JsonFormatter implements ResultSerializer ...

使用oauth2 accessToken获取流程 使用refreshToken刷新accessToken 使用oauth2 如果第三方应用和本开放平台对接时需要获取用户隐私数据（如商品、订单），为为了安全与隐私，第三方应用需要取得用户的授权，即获取访问用户数据的授权令牌 AccessToken 。这种情况下，第三方应用需要引导用户完成帐号“登录授...

功能特点 开箱即用，写完业务代码直接启动服务即可使用，无需其它配置。 参数自动校验，支持国际化参数校验（JSR-303）。 校验功能和结果返回功能实现各自独立，方便自定义实现或扩展。 采用注解来定义接口，维护简单方便。 支持i18n国际化消息返回。 自动生成文档页面，类似swagger。 采用数字签名进行参数验证，签名算法见：easyopen\签名算法...

拦截器 配置拦截器 拦截范围 拦截器 easyopen在1.3.1版本开始支持拦截器。 easyopen拦截器实现原理跟springmvc拦截器类似，拦截器作用在api方法上，即有@Api 注解的方法。 拦截器定义如下： /** * 拦截器，原理同springmvc拦截器 * @author tanghc * */ ...

使用JWT JWT的介绍参考这里：什么是 JWT – JSON WEB TOKEN 。 之前我们的web应用使用session来维持用户与服务器之间的关系，其原理是使用一段cookie字符与服务器中的一个Map来对应，Map<cookie,UserInfo>，用户每次交互需要带一个sessionid过来。如果不使用分布式session，一旦服务器重启s...

接口交互详解 请求参数 签名算法 请求方式 服务端验证 接口交互详解 请求参数 easyopen定义了7个固定的参数，用json接收 { "name" : "goods.get" , "version" : "2.0" , "app_key" : "test" , "data...

生成文档页面 设置文档注解 设置参数注解 设置返回结果注解 文档页面URL List返回 设置文档密码（v1.8.5） 修改文档页返回字段名（v1.8.5） 第三方类返回 文档模型复用 更改文档显示位置（v1.9.1） 生成文档页面 easyopen提供一个简单的api文档查看页面，类似于swagger，基于注解功能来生成文档页面...