我的 Mock Server - Meow Mock

业余时间基于 Node.js 搭建了 Mock Server 一枚,自娱自乐的产物。功能较简易,非常非常非常小白级,但可满足绝大多需求。

Meow Mock 源码

价值
  • 便于自测:创建虚拟对象代替具备不确定性或不易构造的真实对象。

  • 避免等待:前端与服务端的开发进度往往不同步。前端可使用 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 {}
        }
    }
}

显然,需要定义每一接口的 urltype,返回数据的讲究在于 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。生成每一列表项的时间差非常非常非常小,那么:

我的 Mock Server - Meow Mock_第1张图片

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 查看返回数据如下:

我的 Mock Server - Meow Mock_第2张图片

由于数据是 动态生成 的,你所看到的结果可能与我的不同嗷~

但在重启服务之前,同一 URL 下,刷新浏览器是不会影响返回数据的,除非改变参数值或添加新的参数。

打开 http://localhost:8888/example1/_data?a=1 体会下!

再打开 http://localhost:8888/example1/_data?a=2 体会下!


List 类型特殊说明

列表项 index

渲染列表数据时,往往需要渲染其序号,例如排行榜:

我的 Mock Server - Meow Mock_第3张图片

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)

具体效果形如:

我的 Mock Server - Meow Mock_第4张图片
注意 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 + 1start_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

你可能感兴趣的:(我的 Mock Server - Meow Mock)