初窥 RAP：如何使用 RAP 进行接口文档管理

Jason 岂安科技前端研发工程师

三年互联网前端开发经验，曾参与过多个系统框架的搭建和组件开发，负责岂安科技产品的数据可视化和公用组件开发。

1前言

RAP 是一个可视化接口管理工具， 经过分析接口结构，动态生成模拟数据，校验真实接口正确性， 围绕接口定义，经过一系列自动化工具提高咱们的协做效率。
在 RAP 中，您可定义接口的 URL、请求和响应细节格式等等。经过分析这些数据，RAP 提供 MOCK 服务、测试服务等自动化工具。

2为何要选择 RAP？

轻松编辑和分享

可视化编辑，完善的版本控制，各类格式的导入导出。让先后端约定接口的工做变得十分简单。

Mock服务

RAP会自动根据接口文档生成Mock接口，这些接口会自动生成模拟数据，并支持复杂的生成逻辑。

实力的保障

覆盖阿里几乎全部部门，有数百家公司正在使用RAP，历经4年积累大量经验，可适应各类复杂的业务场景。

3开始 RAP

1轻松编辑和分享

要求环境：
✦ JDK 1.8+
✦ MySql 5.6.12+
✦ Tomcat 8.*+
✦ Redis 3.0+

RAP的部署方式有两种：
一种是直接采用阿里编译好的 war 包，放入 tomcat 便可。
另外一种是获取源码后本身编译，或者修改一些代码、作一些个性化的功能以后编译，而后打成 war 包再放入 tomcat。
具体搭建方法参考官方文档：
https://github.com/thx/RAP/wi...

2注册 RAP 帐号，建立团队和项目

部署到本身服务器上以后，先注册帐号后登陆，而后建立团队和项目。

建立以后能够修改项目和添加项目成员，项目成员能够访问该项目的内容和添加修改接口。

3编写接口文档

登陆帐号后在首页，能够看到“个人项目”，选择一个项目点击进入，就能够开始编写咱们的接口文档了。
进入页面后点击编辑，能够看到以下界面：

咱们能够将咱们的接口文档写在这个地方，备注中能够写出模拟的数据格式，具体规则参考官网用户手册：
https://github.com/thx/RAP/wi...
咱们能够定义接口返回固定的字符串、返回随机数，甚至定义方法根据传参作一些处理以后再返回。

4使用接口

一直看到这里，你们可能有疑问，这个文档写出来，好像和普通的文档没有什么区别啊，甚至更加繁琐。这里咱们就要说到RAP与其余文档不一样的地方：
写完文档以后，咱们能够直接调用接口来返回数据，这些数据是根据咱们编写的规则动态生成的，前端不须要等到后台开发好接口以后再调用，而是能够和后台同步开发 。
咱们来看看返回的数据吧：

这里能够模拟请求来看返回的数据是不是本身想要的结果，肯定没有问题以后，咱们就可使用该接口了。由于后台工具暂时还不成熟，因此该处咱们介绍一下前端如何使用该接口：

✫ 前端调用接口时，host 和 url 与日常调用有所不一样，如上图，请求的 url 为右下方的 url（并始终为 get 请求，不管接口是 post 仍是其余的 method），而返回的内容也并非返回的对象，而是文档转换成的一串字符串。

✫ 在这里咱们须要安装 mockjs，用于解析接口返回的内容（安装方法参考： https://github.com/nuysoft/Mo...）

✫ 拿到接口返回的内容后，使用 const result = eval((${res})) ; 解析返回内容，而不是使用 JSON.parse，缘由是文档中编写的内容可能有 function，不能使用 JSON.parse 去转换。解析完成后使用 const data = mockjs.mock(result) ; 这时候变量 data 就是咱们须要的数据了，也就是图中所返回的结果。

✫ 经过上面三步，咱们就能够拿到数据去写咱们的代码了。

4结束语

RAP 的基础用法，看完上面的内容咱们能够了解的差很少了，缺点也比较明显，调用接口时比较麻烦，可是咱们能够经过封装请求方法来减小麻烦程度。总的来讲 RAP 平台仍是比较实用的。

目前RAP1已经中止更新，官方开始推行 RAP2，界面更加简洁易用，可是没有什么文档，大部分文档仍是使用的 RAP1 的文档（也就是今天咱们介绍的 RAP 平台）。

RAP的介绍，到这里也就告一段落了，若是你们比较感兴趣能够去官方部署的 RAP 平台（http://rap.taobao.org/org/ind...）用用看，全部功能和本身部署的是如出一辙的，你们能够先用用看，若是以为还不错，就能够部署在本身的服务器上使用了。