Mockserver之Moco框架搭建使用
- 客户要求进行完整的产品展示，人员和时间都有限，来不及开发后端服务。。。
- 工期比较紧的项目，前端已开发完成，需要调试，后端接口还未开发完成。。。
- 公司某个项目依赖于第三方服务，但是第三方服务不方便频繁调用。。。
实际的工作当中，从商务到开发再到测试，经常会遇到上述所说的情况，如此的反复就造成了项目
的进度受限，这被称为短板效应。此时，Moco框架可以很好的解决这些问题。
一、Moco简介
Moco是基于Java开发的开源项目，是一个简单搭建模拟服务器的框架，可以模拟http、https、
socket等协议。其运行原理是Moco会根据一些配置，启动一个真正的HTTP服务（会监听本地的某
个端口）。当发起的请求满足配置中的条件时，会返回指定的响应数据。
Moco有两种使用模式：API模式和独立运行模式，如果是编写Java应用或者以其它JVM上的语
言编写的应用，可以采用直接调用API的模式；独立运行模式就是下载moco服务jar包，然后根据实
际需要编写配置文件或者进行二次开发。
二、环境配置
1.安装JDK并配置好环境变量，这个不再细说，大家自行百度。
2.下载服务jar包：Moco下载
下载完成的jar包是这样的 moco-runner-1.1.0-standalone.jar ，本文采用的是最新版本。
三、运行Moco
我们新建一个文件夹，命名为Moco，把jar包放在这里，新建test.json文件，内容如下：
[ { "response": { "text": "Hello world!" } } ]
在Moco文件夹中点击鼠标右键打开终端，输入以下命令：
java -jar moco-runner-1.1.0-standalone.jar start -p 8080 -c test.json
<path-to-moco-runner>：jar包存放路径，我这里在同一个文件夹，直接输入jar包名字
<monitor-port>：服务监听的端口，设置一个未被占用的端口
<configuration-file>：配置文件存放路径
如下图中所示，表示启动成功：
此时，在浏览器中输入： http://localhost:8080 可以看到Hello word！，说明我们搭建的模拟
服务器可以正常使用了。
四、Moco常用配置参数
Moco主要致力于服务器的配置，目前只有两种API：Request 和 Response。两种API都有
各自的属性，在配置使用的过程中，一定要遵循这些方法。
Request 请求
有14个固定属性： method, headers, json, factory, uri, text, cookies, xpaths,json_paths,
version, file, queries,path_resource,forms 。
Response 响应
有12个固定属性： status, attachment, headers, version, factory, file,text, proxy, cookies,
json, latency, path_resource 。
1.普通的GET请求
{
"description": "查找书籍", "request" : { "method" : "get", "uri" : "/article/book/" }, "response" : { "text" : "响应内容" } }
2.GET方法带参数
{
"description": "查找具体书籍", "request": {
"method": "get"
"uri": "/article/book", "queries": { "name": "kaka", "id": "75" } }, "response": { "text": "响应内容" } }
3.POST方法定义请求头和JSON请求体
[ { "description": "登录", "request": { "uri": "/login", "method": "post", "headers": { "Content-Type": "application/json" }, "json": { "username": "13812345678", "password": "123456" } }, "response": { "text": "login success" } } ]
4.定义响应结果为JSON格式
[ { "description": "登录", "request": { "uri": "/login" }, "response": { "headers": { "Content-Type": "application/json;charset=UTF-8" }, "json": { "code": "00", "msg": "登录成功", "data": { "userId": 5, "token": "jvuRbbA5EKPzJTfZbDAY9SMzq40YBfws" } } } } ]
五、Moco实战应用
1.单体配置
将所有的接口请求和返回数据写入到同一个json文件中，这种配置适用于请求报文和响应结果
内容不大的情况，如下图所示将整个配置写入到 config.json 中：
[ { "description": "登录", "request": { "uri": "/login", "method": "post", "headers": { "Content-Type": "application/json" }, "json": { "username": "13312345678", "password": "123456" } }, "response": { "headers": { "Content-Type": "application/json;charset=UTF-8" }, "json": { "retCode": "00", "retMsg": "success", "data": { "userId": 6, "token": "ked6jsdXkjdwm37dy6" } } } } ]
在终端中运行启动命令： java -jar D:\Moco\moco-runner-1.1.0-standalone.jar start -p 8080 -c config.json
服务启动后，使用接口测试工具调用该配置中的接口。
2.全局配置
Moco支持在全局的配置文件中引入其他配置文件，我们可以根据实际需要分别定义配置文件，然后在全局
文件中引用。这样，既便于管理，又轻松的解决了接口请求报文或响应数据太大不方便查看的问题。
a.在Moco文件夹中创建login文件夹，在login文件夹中创建 local_login_req.json 和 local_login_res.json 两个
文件；
b.在Moco文件夹中创建 global_settings.json 文件
在 local_login_req.json 中写入：
[ { "description": "登录", "request": { "uri": "/login", "method": "post", "headers": { "Content-Type": "application/json" }, "json": { "username": "13300001122", "password": "123456" } }, "response": { "headers": { "Content-Type": "application/json;charset=UTF-8" }, "file": "./login/local_login_res.json" } } ]
在 local_login_res.json 中写入：
[ { "retCode":"00", "retMsg":"登录成功", "data":{ "userId":2, "token":"ked6jsdXkjdwm37dy6xm" } } ]
在 global_settings.json 中写入：
[ { "include":"login/local_login_req.json" } ]
准备完成后，在当前目录的终端中输入： java -jar moco-runner-1.1.0-standalone.jar start -p 8080 -g global_settings.json
注意：在启动服务的命令中， -c 是加载单体配置文件， -g 是加载全局配置文件。两者不可以混淆，否则
配置文件解析会报错。
Moco开源链接：https://github.com/dreamhead/moco