用工具实现 Mock API 的整个流程

3,228 阅读3分钟

在瀑布流开发模式中,如果前端开发人员需要进行页面对接,需要后端先完成 API 的开发工作,因此前后端开发的进度会互相影响。这时候就需要使用 Mock 工具来帮助前端进行模拟页面对接。

我们可以事先编写好 API 的数据生成规则,由 Eolink 的 API 研发管理平台动态生成 API 的返回数据。 开发人员通过访问 Mock API 来获得页面所需要的数据,完成对接工作。

以下为流程示例。

添加 Mock API

  • 进入 API 文档详情页面,点击 Mock API 标签,点击新建 Mock API :

添加Mock.png

  • 在弹窗中输入 Mock API 的名称以及请求触发条件:

输入Mock名称.png

填写触发条件

触发条件支持请求头部、请求体(Form-data、JSON)、Query 参数等。

以下例子表示当 Form-data 参数中包含 user_name = jackliu 时,返回静态的字符串数据:

请求触发条件.png

填写响应结果

Mock API 提供了以下三种返回数据类型:

三种返回数据类型描述.png

  • JSON

如果不填写生成规则和属性值,系统会自动根据 JSON 结构以及数据类型来生成随机的数据。

我们也可以在生成规则和属性值中使用 Mock JS 语法来生成自定义的数据。

Mock Json说明.png 下图是 Mock JS 的官方示例,意为生成字符串长度介于 1~10 位的 ” ★ ”

字符长串.png 在 API 研发管理平台 中,上述的 Mock JS 的官方示例将会改写为如下例子:

注意:如果使用 Mock JS,属性值前需要添加 @mock=,如 @mock= ” ★ ”

添加参数值.png

如果不需要使用 Mock JS,那么我们可以直接在属性值填写静态数据即可:

在属性值填写静态数据.png

点击预览按钮得到的示例结果:

预览示例结果.png

  • Raw

当我们不需要随机生成数据时,可以选择 Raw 类型并填写静态数据:

Raw类型静态数据.png

  • 动态 Javascript

当我们希望通过代码生成返回数据时,可以 使用编写 Javascript 代码的方式,并使用 return 语句返回数据

Javascript 模式中也支持 Mock JS,通过 Mock.mock() 方式调用,详情可以查阅 Mock JS 官方文档。

Java调用mock文档.png

以下例子表示使用 Javascript 代码结合 Mock JS 生成 随机中文名+当前日期 的返回结果:

var date = new Date();
var seperator1 = "-";
var year = date.getFullYear();
var month = date.getMonth() + 1;
var strDate = date.getDate();

//在这里使用Mock JS 获取随机中文名
var userName = Mock.mock("@cname");

if (month >= 1 && month <= 9) 
   {
   month = "0" + month;
    }

if (strDate >= 0 && strDate <= 9) 
  {
   strDate = "0" + strDate;
  }

var currentdate = year + seperator1 + month + seperator1 + strDate;

return userName+seperator1+currentdate;

点击预览按钮得到的示例结果:

动态Java示例结果.png

调用Mock API

进入 Mock API 列表页面,点击调用地址即可复制到剪贴板,在代码中直接对该 API 地址发起请求即可得到响应结果

Mock API 对触发条件的优先级是:

Mock API触发条件优先级.png


以上即通过接口管理工具 Eolink 使用 Mock API 的操作流程。

Eolink 是一款能设计、管理 API ,一键生成 API 文档的管理工具,除此之外还能直接打通接口测试,一键发起 API 测试,方便快捷且功能强大。

其提供了市面最强的 Mock API 能力体系:

Mock方式的能力和优势.png

有兴趣可以自行试用:www.eolink.com