业余时间基于 Node.js 搭建了 Mock Server 一枚，自娱自乐的产物。功能较简易，非常非常非常小白级，但可满足绝大多需求。
价值
便于自测：创建虚拟对象代替具备不确定性或不易构造的真实对象。
避免等待：前端与服务端的开发进度往往不同步。前端可使用 Mock Server 根据约定仿制假接口以不受服务端进度的约束。
代替接口文档：接口文件可按业务类型划分，文档内容可渲染于前台方便查阅。
特性
请求类型支持 GET、POST。其中 GET 请求返回列表数据 支持分页，两套参数可选：page + count、start_num + count，具体差别稍后阐述。
数据类型支持数值、布尔值、字符串、图片、富文本、字典、列表。所有数据均可 动态生成，但仍支持定义为固定值。
启动方式
cd meow-mock
npm install
npm run start
默认端口号 8888，可在 /bin/www 文件中修改：
var port = normalizePort(process.env.PORT || '8888');
未安装 Node.js 的请先移驾此处下载并安装。
未安装 Npm 的请先执行：
curl -L https://npmjs.com/install.sh | sh
使用方法
在 /data 文件夹内创建 .js 接口文件，例如 example.js。打开 route.js 添加如下代码：
var example = require('./data/example');
var requestGatherLst = [
example
];
可理解为在该服务中注册了刚刚创建的接口文件。我们可以创建多个接口文件 module1.js、module2.jd、module3.js...
假定 example.js 代码如下：
var type = require('../type');
module.exports = {
example1: {
url: '/example1/_data',
type: 'GET',
data: function () {
return {}
}
},
example2: {
url: '/example2/_data',
type: 'POST',
data: function () {
return {}
}
}
}
显然，需要定义每一接口的 url 及 type，返回数据的讲究在于 data 回调函数的返回值。
举个板栗：
所有数据均可动态生成
example1: {
url: '/example1/_data',
type: 'GET',
data: function () {
return {
message: '请求成功',
error: 0,
data: {
id: type.id(), // 返回 id
number: type.number({ // 返回数值
min: 288,
max: 999
}),
bool: type.bool(), // 返回布尔值
string1: type.string([ // 返回字符串
'文案一',
'文案二',
'文案三'
]),
string2: type.string({ // 返回字符串
minL: 5,
maxL: 16
}),
image1: type.image([ // 返回图片链接
'http://oij8a9ql4.bkt.clouddn.com/default-fe.jpg',
'http://osm0bpix4.bkt.clouddn.com/thumb.jpg'
]),
image2: type.image({ // 返回图片链接
type: '-thumb'
}),
list1: type.list({ // 返回列表
length: 5,
data: function () {
return type.number()
}
}),
list2: type.list({ // 返回列表
length: 22,
index: {
name: 'idx',
format: '0\d'
},
data: function () {
return {
pro1: type.number(),
pro2: type.string()
}
}
})
}
}
}
}
- id -> 返回 id，为避免重复使用时间戳。
此处有坑！假定一列表长度为 n，列表项含字段 id。生成每一列表项的时间差非常非常非常小，那么：
id 怎么可以重复...想办法去重喽~
module.exports = {
timestamps: {},
id: function () {
var _this = this;
var curtime = (new Date()).valueOf();
var recursion = function (key) {
if (_this.timestamps[key]) {
var tmp = recursion(key + 1);
} else {
_this.timestamps[key] = 1;
return key;
}
return tmp;
};
return recursion(curtime);
}
}
number -> 返回数值，可使用 min、max 配置项规定其取值范围，默认范围 1 ~ 11。
bool -> 返回布尔值。
string1 -> 返回字符串，可从配置列表中随机选取一值。
string2 -> 返回字符串，可使用 minL、maxL 配置项规定其长度范围，默认范围 1 ~ 11。
image1 -> 返回图片链接，可从配置列表中随机选取一值。
image2 -> 返回图片链接，可使用 type 配置项规定图片尺寸，目前支持：640 * 307（-w）、320 * 320（-half）、120 * 120（-thumb），默认值为 -half。
list1 -> 返回列表，可使用 length 配置项规定其长度，默认长度为 0。
list2 -> 返回列表，可使用 length 配置项规定其长度，默认长度为 0。
打开 http://localhost:8888/example1/_data 查看返回数据如下：
由于数据是 动态生成 的，你所看到的结果可能与我的不同嗷~
但在重启服务之前，同一 URL 下，刷新浏览器是不会影响返回数据的，除非改变参数值或添加新的参数。
打开 http://localhost:8888/example1/_data?a=1 体会下！
再打开 http://localhost:8888/example1/_data?a=2 体会下！
List 类型特殊说明
列表项 index
渲染列表数据时，往往需要渲染其序号，例如排行榜：
index 配置项便是为上述需求而生：
index: {
name: 'idx',
format: '\d',
type: 'int'
}
index.name -> 规定命名，默认值为 index。
index.format -> 规定格式，目前支持：\d、0\d、00\d，默认值为 \d。
index.type -> 规定变量类型，目前支持：int、string，默认值取决于 index 格式。
关于 format
\d 格式：index 值为 1, 2, 3, 4, ...（默认变量类型 int）
0\d 格式：index 值为 01, 02, 03, ... 10, 11, ...（变量类型仅有 string）
00\d 格式：index 值为 001, 002, ... 010, 011, ... 099, 100, 101, ...（变量类型仅有 string）
具体效果形如：
注意 data 配置项写法
推荐：
list: type.list({
length: 5,
data: function() {
return type.number()
}
})
返回列表值不同：
不推荐：
list: type.list({
length: 5,
data: type.number()
})
返回列表值相同：
多数情况我们不喜欢这样的结果~
GET 请求列表数据分页
首先说明列表数据请求接口对象写法：
example2: {
url: '/example2/_data',
type: 'GET',
list_name: 'items',
data: function () {
return {
message: '请求成功',
error: 0,
items: type.list({
length: 36,
index: {
name: 'idx',
format: '0\d'
},
data: function () {
return {
id: type.id(),
number: type.number(),
string: type.string(),
image: type.image()
}
}
})
}
}
}
list_name 配置项决定了返回数据中究竟哪个字段是待分段的 list，其默认值为 data。
两套分页参数
page + count
假如数据总长 36，每一分页数据长度 count=10，那么：
page=1 时，返回第 1 ~ 10 条数据；
page=2 时，返回第 11 ~ 20 条数据；
page=3 时，返回第 21 ~ 30 条数据；
page=4 时，返回第 31 ~ 36 条数据；
page > 4 时，返回空列表。
打开 http://localhost:8888/example2/_data?page=1&count=10 体会下！
start_num + count
截取列表中第 start_num + 1 至 start_num + count 条数据。假如 ?start_num=6&count=5，那么返回第 7 ~ 11 条数据。
打开 http://localhost:8888/example2/_data?start_num=6&count=5 体会下！
备注：
无分页参数时默认返回所有数据。
无 count 参数时默认返回 10 条数据。
作者：呆恋小喵
我的后花园：https://sunmengyuan.github.io/garden/
我的 github：https://github.com/sunmengyuan
原文链接：https://sunmengyuan.github.io/garden/2017/09/15/meow-mock.html
