Mock 假数据模拟

当后端开发人员还没有准备好后端接口时，为了能让前端项目开发继续进行下去，往往需要提供假数据来协助前端开发。

fis 中默认的 node 服务就支持此功能。

步骤

  1. 准备好假数据文件，如 sample.json 文件，放在服务器的 /mock/sample.json 目录，确保通过 http://127.0.0.1:8080/mock/sample.json 可访问到。

    1. {
    2.  "error": 0,
    3.  "message": "ok",
    4.  "data": {
    5.    "uname": "foo",
    6.    "uid": 1
    7.  }
    8. }

  2. 准备一个 server.conf 配置文件，放在服务器目录的 /mock/server.conf，内容如下。

    1. rewrite ^\/api\/user$ /mock/sample.json
  3. 然后当你请求 http://127.0.0.1:8080/api/user 的时候，返回的就是 sample.json 中的内容。

说明

关于 server.conf 配置语法，格式如下：

  1. 指令名称 正则规则 目标文件
  • 指令名称 支持 rewrite 、 redirect 和 proxy。
  • 正则规则 用来命中需要作假的请求路径。
  • 目标文件 设置转发的目标地址，需要配置一个可请求的 url 地址。

刚说的是把文件放在服务器目录，操作起来其实并不是很方便，这类假数据文件建议放在项目源码中，然后通过 fis3 release 伴随源码一起发布到调试服务器。

推荐以下存放规范。

  1. └── mock
  2.     ├── sample.json
  3.     └── server.conf

直接代理到其他服务的 api 地址。

这个功能要求 fis3 >= 3.3.29 使用格式如:

  1. proxy ^\/api\/test http://127.0.0.1:9119/api/test

ps: 还在测试中，目前简单的 API 代理没问题，如果 auth 验证什么的可能就会跪，后续会继续优化。

动态假数据

静态的假数据可以通过 json 文件提供，那么动态数据怎么提供？node 服务器可以通过 js 的方式提供动态假数据。

/mock/dynamic.js

  1. module.exports = function(req, res, next) {
  3.   res.write('Hello world ');
  5.   // set custom header.
  6.   // res.setHeader('xxxx', 'xxx');
  8.   res.end('The time is ' + Date.now());
  9. };

然后结合 server.conf 就可以模拟各种动态请求了。

  1. rewrite ^\/api\/dynamic\/time$ /mock/dynamic.js

如上面的例子，当请求 http://127.0.0.1:8080/api/dynamic/time 时，返回：Hello world The time is 1442556037130