腳本之家服務(wù)器常用軟件

快捷導(dǎo)航

軟件下載

android MAC 驅(qū)動(dòng)下載字體下載 DLL

源碼下載

PHP ASP.NET ASP JSP

軟件編程

C# JAVA C 語(yǔ)言 Delphi Android

網(wǎng)絡(luò)編程

PHP ASP.NET ASP JavaScript

在線工具

CSS格式化 JS格式化 Html轉(zhuǎn)化為Js

數(shù)據(jù)庫(kù)

MYSQL MSSQL oracle DB2 MARIADB

CMS

PHPCMS DEDECMS 帝國(guó)CMS WordPress

常用工具

PHP開(kāi)發(fā)工具 python Photoshop 必備軟件

基于Koa2寫(xiě)個(gè)腳手架模擬接口服務(wù)的方法

更新時(shí)間：2018年11月27日 09:06:46 作者：FlyingWWS

這篇文章主要介紹了基于Koa2寫(xiě)個(gè)腳手架模擬接口服務(wù)的方法，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

ap-cli 前端模擬接口服務(wù)腳手架

項(xiàng)目地址

依據(jù)接口定義，幫助你快速的完成接口模擬工作。

主要功能：

[x] 通過(guò)json、js、swagger文件模擬接口數(shù)據(jù)
[x] 通過(guò)正則匹配指定需要mock的文件
[x] 生成簡(jiǎn)單markdown接口文檔

開(kāi)始

下載ap-cli

$ npm install ap-cli -g

創(chuàng)建data.json

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

運(yùn)行

$ ap-cli -m data.json

現(xiàn)在打開(kāi) http://localhost:3000/api/get/index ，你會(huì)得到

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

同時(shí)會(huì)在當(dāng)前文件目錄生成一個(gè)簡(jiǎn)單的markdown接口文檔

使用

1、通過(guò)js方式模擬數(shù)據(jù)

格式查看

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
};

運(yùn)行

$ ap-cli -m data.js

查看接口

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

2、通過(guò)swagger文件模擬數(shù)據(jù)

這種方式主要是通過(guò)swagger生成一個(gè)xx_new.json文件，然后進(jìn)行模擬數(shù)據(jù)

# 運(yùn)行會(huì)生成一個(gè)swagger_new.json文件
$ ap-cli -s swagger.json
# 模擬數(shù)據(jù)
$ ap-cli -m swagger_new.json

通過(guò)正則匹配指定要模擬的文件

當(dāng)前目錄下有3個(gè)文件a1.json、a2.js、b1.js,你可以通過(guò)正則只模擬a1.json和a2.js文件的數(shù)據(jù)。

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

CLI用法

#	縮寫(xiě)	完整	默認(rèn)	說(shuō)明
1	-m	--mock [fileName]	'all'	模擬接口服務(wù)，[fileName]當(dāng)前目錄下要mock的文件名，[all]默認(rèn)當(dāng)前目錄下的所有文件
2	-r	--regexp [regexp]	無(wú)	通過(guò)正則匹配需要mock的文件
3	-s	--swagger [fileName]	無(wú)	通過(guò)swagger生成json模板文件，[fileName]當(dāng)前目錄下的swagger文件名
4	-p	--port [port]	3000	指定mock的端口

完整模板及說(shuō)明

不管是json、js、swagger文件，最終都是轉(zhuǎn)換成下面的格式進(jìn)行處理。

示例

[
 {
  "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"
    }
   }
  }
 }
]

主要屬性說(shuō)明

#	字段	類型	說(shuō)明	默認(rèn)	是否必須	備注
1	summary	string	接口概述	xxx接口	否	無(wú)
2	url	string	接口地址	/api	是	無(wú)
3	method	string	http請(qǐng)求方式	get	是	無(wú)
4	parameters	/	接口請(qǐng)求參數(shù)	無(wú)	否	可顯示為表格（詳見(jiàn)下1-1.parameters屬性說(shuō)明）
5	response	/	接口響應(yīng)數(shù)據(jù)	無(wú)	是	無(wú)

1-1. parameters屬性說(shuō)明

#	字段	類型	說(shuō)明	默認(rèn)	是否必須	備注
1	parsing	boolean	是否解析	false	否	無(wú)
2	child	object []	子節(jié)點(diǎn)	無(wú)	否	子節(jié)點(diǎn)屬性（詳見(jiàn)1-1-1.child屬性說(shuō)明）

1-1-1. child屬性說(shuō)明

#	字段	類型	說(shuō)明	默認(rèn)	是否必須
1	key	string	字段名稱	-	是
2	type	string	字段類型	string	是
3	description	string	字段說(shuō)明	無(wú)	否
4	required	boolean	是否必須	false	否
5	child	object []	子節(jié)點(diǎn)數(shù)據(jù)	無(wú)	否