基于Koa2写个脚手架模拟接口服务的方法

ap-cli 前端模拟接口服务脚手架

我们提供的服务有:网站建设、成都网站建设、微信公众号开发、网站优化、网站认证、新宾ssl等。为成百上千家企事业单位解决了网站和推广的问题。提供周到的售前咨询和贴心的售后服务,是有科学管理、有技术的新宾网站制作公司

项目地址

依据接口定义,帮助你快速的完成接口模拟工作。

主要功能:

  • [x] 通过json、js、swagger文件模拟接口数据
  • [x] 通过正则匹配指定需要mock的文件
  • [x] 生成简单markdown接口文档

开始

下载ap-cli

$ npm install ap-cli -g

创建data.json

[
 {
  "url": "/api/get/index",
  "method": "get",
  "response": {
   "name": "pc",
   "status": "success"
  }
 }
]

运行

$ ap-cli -m data.json

现在打开 http://localhost:3000/api/get/index ,你会得到

{ "name": "pc", "status": "success" }

同时会在当前文件目录生成一个简单的markdown接口文档

使用

1、通过js方式模拟数据

格式查看

data.js

const getUserList = () => {
 const data = {
  "summary": "获取用户列表(get方式)",
  "url": "/api/get/userList",
  "method": "get",
  "parameters": "",
  "response": {
   "count": 100,
   "userList": []
  }
 }
 for (let i = 0; i < 100; i++) {
  data.response.userList.push({ id: i, name: `user${i}` })
 }
 return data
};

module.exports = {
 getUserList
};

运行

$ ap-cli -m data.js

查看接口

http://localhost:3000/api/get/userList

2、通过swagger文件模拟数据

这种方式主要是通过swagger生成一个xx_new.json文件,然后进行模拟数据

# 运行会生成一个swagger_new.json文件
$ ap-cli -s swagger.json
# 模拟数据
$ ap-cli -m swagger_new.json

通过正则匹配指定要模拟的文件

当前目录下有3个文件a1.json、a2.js、b1.js,你可以通过正则只模拟a1.json和a2.js文件的数据。

$ ap-cli -m all -r /^a/

CLI用法

#缩写完整默认说明
1-m--mock [fileName]'all'模拟接口服务,[fileName]当前目录下要mock的文件名,[all]默认当前目录下的所有文件
2-r--regexp [regexp]通过正则匹配需要mock的文件
3-s--swagger [fileName]通过swagger生成json模板文件,[fileName]当前目录下的swagger文件名
4-p--port [port]3000指定mock的端口

完整模板及说明

不管是json、js、swagger文件,最终都是转换成下面的格式进行处理。

示例

[
 {
  "summary": "获取用户信息接口json",
  "url": "/api/get/userinfo",
  "method": "post",
  "parameters": {
   "parsing": true,
   "child": [
    {
     "key": "userid",
     "type": "string",
     "required": true,
     "description": "user id"
    }
   ]
  },
  "response": {
   "body": {
    "id": "0001",
    "status": "success",
    "userinfo": {
     "name": "pc",
     "age": 18,
     "gender": "boy"
    }
   }
  }
 }
]

主要属性说明

#字段类型说明默认是否必须备注
1summarystring接口概述xxx接口
2urlstring接口地址/api
3methodstringhttp请求方式get
4parameters/接口请求参数可显示为表格(详见下1-1.parameters属性说明)
5response/接口响应数据

1-1. parameters属性说明

#字段类型说明默认是否必须备注
1parsingboolean是否解析false
2childobject []子节点子节点属性(详见1-1-1.child属性说明)

1-1-1. child属性说明

#字段类型说明默认是否必须
1keystring字段名称-
2typestring字段类型string
3descriptionstring字段说明
4requiredboolean是否必须false
5childobject []子节点数据

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持创新互联。


分享题目:基于Koa2写个脚手架模拟接口服务的方法
文章链接:http://pwwzsj.com/article/poooci.html