Skip to content
This repository has been archived by the owner on Aug 14, 2020. It is now read-only.

kuitos/json-mock-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JSON Mock Server

Goals

  1. 解决前端使用mock方式开发过程中 PUT/POST/DELETE 等接口的数据无法被持久化的问题。例如对user资源做了rename操作,调用接口成功返回204,但是下次get user得到的依然是原始name。
  2. 解决前后端接口联调成本问题,本地不用改一行代码就可以直接调用远程服务器接口。总不能接口联调出一次问题改一次然后测试发布一次到服务器吧,太傻太累效率太低。
  3. 我TM只是想mock一个接口,我TM不想写一堆js代码啊!!!

The Truth

  1. 将文件作为数据库,提供数据持久化功能。每次对资源的修改记录都会保存在文件中。
  2. 使用本地node服务器作http代理,通过接口命名规则拦截数据接口,将拦截到的请求转发到配置的远程服务器上,然后输出响应结果。
  3. 基于restful规范配置数据,node会根据url规则找到对应的资源实体,从而达到只配数据源不写一行js代码的目的。

Params

param alias desc reqiured default
api-prefix ap rest数据接口前缀 true
port p 本地服务器启动端口号 false 3000
host h 本地服务器启动host false 0.0.0.0
static s 静态服务器根路径 false public
source 本地mock数据源(若配置需在第一项) undefined
proxy-host ph 代理服务器地址(ip/域名,因为可能存在虚IP所以建议使用域名)
proxy-port pp 代理服务器端口号
limit l 请求体大小限制

Specification

  1. **如果api设计的不够restful,可能本工具并不适合你的项目。**但是作为一个合格的前端工程师,是有义务去协同后端设计出符合标准的接口的。当然前提是你得熟悉restful接口设计规范。
  2. 如果上面一条没法做到,我相信本地调用远程接口这一特性你也是需要的,如果你的项目是前后端分离的开发模式的话。

How To Use

Install

$ npm install json-mock-kuitos -g

创建 db.json 文件

{
  "users": [
    { "id": 1, "name": "kuitos", "location": "China"},
    { "id": 2, "name": "visiting-user", "location": "UK"}
  ],
  "posts": [
    { "id": 1, "title": "json-mock", "body":"The internet is cool!", "author": "therebelrobot", "userId": 1 }
  ],
  "comments": [
    { "id": 1, "body": "some comment from author", "votes": 20, "postId": 1, "userId": 1 },
    { "id": 2, "body": "some comment from visitor", "votes": 15, "postId": 1, "userId": 2 }
  ]
}

启动服务器

# 本机mock
$ json-mock-kuitos db.json -s / --apiPrefix /rest/bi

# 如果后端接口已经开发好,使用代理直接连其他机器调用api作前后端联调
$ json-mock-kuitos -s / --proxy-host 10.200.187.10 --proxy-port 3000 --api-prefix /rest/bi

当你访问 http://localhost:3000/posts/1, 返回值为

{ "id": 1, "title": "json-mock", "author": "therebelrobot", "userId": 1 }

当你访问 http://localhost:3000/users?name=kuitos, 返回值为

{ "id": 1, "name": "kuitos", "location": "China" }

同样的,所有的 PUT/POST/DELETE 操作都会被持久化到 db.json

更多路由设计及调用方式,参见json-mock

Design Mock Data

points

  1. 从url的后面往前面思考,资源的主体永远是url中最后一个复数单词。
    /users/1/comments表示的是comments集合中所有userId=1的资源(数组),/users/1/comments/1表示的roles集合中commentId=1而且userId=1的comment实体(对象)

  2. 想象自己是后端开发者,/users/1/comments/1 对应的sql应该是

     select * from tb_user_roles where userId=1 and roleId=1;

examples

  1. /users/1/comments return

    [
    	{ "id": 1, "body": "some comment from author", "votes": 20, "postId": 1, "userId": 1 }

] 2./users/1/comments/2``` return

```json
{ "id": 2, "body": "some comment from visitor", "votes": 15, "postId": 1, "userId": 1 }
```

Todo

  1. 目前只支持mock单文件数据,后续需支持指定文件夹下所有json文件(通过concat文件夹下所有json文件生成单一db.json的方式)
  2. hotloader:watch(dir)-->server.restart()
  3. /users/1/name 不支持对单个属性的 get/put
  4. 不支持资源ID映射配置。/users/1/roles/2必须是{id:2,userId:1}才能匹配到, {roleId:2,userId:1}不会匹配。解决方案就是,多加一个名字不一样但是值一 样的属性。{id:2,roleId:2,userId:2}
  5. 只支持两级资源嵌套。但是依照规范restful应该只支持两级。目前当配置多级时也只有前两级生效。如 /users/1/posts/1/comments/ 表示postId == 1 的所有comment实体。要不要修复看心情吧😄

欢迎各路英雄提交PR帮助作者改善此工具

Thanks To

  1. json-mock
  2. json-server

License

MIT