- 介绍
- 安装
- 起步
- 工作原理
- 初级使用
- 中级使用
- 高级使用
- 接口文档
- FIS2 到 FIS3
- 资源合并
- mock 假数据模拟
- 常用的插件列表
Mock 假数据模拟
当后端开发人员还没有准备好后端接口时,为了能让前端项目开发继续进行下去,往往需要提供假数据
来协助前端开发。
fis 中默认的 node 服务就支持此功能。
步骤
准备好假数据文件,如 sample.json 文件,放在服务器的
/mock/sample.json
目录,确保通过http://127.0.0.1:8080/mock/sample.json
可访问到。{ "error": 0, "message": "ok", "data": { "uname": "foo", "uid": 1 } }
准备一个
server.conf
配置文件,放在服务器目录的/mock/server.conf
,内容如下。rewrite ^\/api\/user$ /mock/sample.json
- 然后当你请求
http://127.0.0.1:8080/api/user
的时候,返回的就是 sample.json 中的内容。
说明
关于 server.conf 配置语法,格式如下:
指令名称 正则规则 目标文件
指令名称
支持rewrite
、redirect
和proxy
。正则规则
用来命中需要作假的请求路径。目标文件
设置转发的目标地址,需要配置一个可请求的 url 地址。
刚说的是把文件放在服务器目录,操作起来其实并不是很方便,这类假数据文件建议放在项目源码中,然后通过 fis3 release 伴随源码一起发布到调试服务器。
推荐以下存放规范。
└── mock
├── sample.json
└── server.conf
直接代理到其他服务的 api 地址。
这个功能要求 fis3 >= 3.3.29 使用格式如:
proxy ^\/api\/test http://127.0.0.1:9119/api/test
ps: 还在测试中,目前简单的 API 代理没问题,如果 auth 验证什么的可能就会跪,后续会继续优化。
动态假数据
静态的假数据可以通过 json 文件提供,那么动态数据怎么提供?node 服务器可以通过 js 的方式提供动态假数据。
/mock/dynamic.js
module.exports = function(req, res, next) {
res.write('Hello world ');
// set custom header.
// res.setHeader('xxxx', 'xxx');
res.end('The time is ' + Date.now());
};
然后结合 server.conf 就可以模拟各种动态请求了。
rewrite ^\/api\/dynamic\/time$ /mock/dynamic.js
如上面的例子,当请求 http://127.0.0.1:8080/api/dynamic/time
时,返回:Hello world The time is 1442556037130
文档内容有误,可提 PR,文档地址: /doc/docs/node-mock.md