技术栈

主页 > 移动开发 >

使用MyMockServer模拟数据

使用MyMockServer模拟数据


简介

在开发的时候,前端、移动端、后端开发分离,开发流程是先定义好接口API,然后按照接口约定进行开发。所以经常需要根据接口Mock数据,有从代码层进行Mock,也有从网络层进行代理的。

本人使用方式是在网络代理进行Mock,因为在代码层Mock,数据不是很灵活,如果要改变数据,那么需要重新编译再启动(本人是移动开发),浪费不少时间。

在网络层Mock,使用的软件是Charles,然后对需要Mock的数据进行mapping就行了,可以是一个远程接口,也可以是一个本地文件。关于Charles使用,这里有一篇文章介绍

上面的Mcok方式已经足够友好了,基本上可以满足90%的日常开发,但是还有些数据是不能满足的,比如服务器需要返回一个动态的时间戳,这个用刚刚的方式就不行。所以很多开发者自己启动一个服务,然后返回对应的数据,这样也是可以的,但是有几个缺点。

于是世面出现了很多使用脚本实现一个代理服务器,对所有的接口进行过滤,添加一些白名单功能,对特定的接口返回特定的数据。常见的如阿里巴巴开源的anyproxy。MyMockServer也是这样的,作为用代理服务器实现的Mock功能的服务器,以后简称mms,不过相对于使用脚本实现代理服务器,mms主要优势在于:

  • 使用DSL配置,相对于json配置,最大优势,简单易懂,用户体验会更好

  • 在DSL中可以使用Groovy语言修改相关逻辑处理,动态的返回数据

  • 动态监听配置文件,修改文件后,立马生效,不需要重启服务,节省时间

安装

使用Mac HomeBrew安装

// add tap
brew tap LiushuiXiaoxia/mms

// brew install
brew install mms

其他平台直接下载压缩包即可,然后把压缩包中的bin目录添加到系统环境变量中,然后直接调用MyMockServer或者MyMockServer.bat

使用

可以直接使用mms即可启动服务,mms支持参数如下。

$ mms -h
Path: /usr/local/bin/.
Cmd: mms -h
Log level : INFO
usage: mms [options]
 -c,--config <arg>   mock server path, default is current directory
 -h,--help           output usage information
 -i,--init           init some path as mock workspace
 -l,--level <arg>    log level ALL,DEBUG,INFO,WARN,ERROR,FATAL,OFF,TRACE
 -p,--port <arg>     mock server port, default is 9090

首先定义一个工作目录,默认情况下使用当前目录作为工作目录,工作目录用于保存配置文件。

$ mkdir proxy

$ cd proxy

$ mms -i
Path: /Users/xiaqiulei/proxy/.
Cmd: mms -i
Log level : INFO

$ ls
template.groovy

当然了也可以手动指定工作目录,这两种方式一样。

$ mkdir proxy

$ mms -i -c ./proxy
Path: /Users/xiaqiulei/test/.
Cmd: mms -i -c ./proxy
Log level : INFO

$ ls proxy
template.groovy

在工作目录中会自动生成模板文件template.groovy

其实这个代理服务器使用的就是用Groovy实现的DSL功能。

mock {
//    enable true
    desc "template"
    request {
//        scheme "http"
        host "www.google.com"
//        port 80
//        path "/api/login/"
        method "GET"
        params {
//            param "param_key_1", "param_value_1"
//            param "param_key_2", "param_value_2"
        }
        headers {
            header "header_key_1", "header_value_1"
            header "time", new Date().format("yyyy-MM-dd HH:mm:ss")
        }
        body {

        }
    }
    response {
//        version 'HTTP/1.1'
//        code 200
        headers {
            header "header_key_1", "header_value_1"
            header "time", new Date().format("yyyy-MM-dd HH:mm:ss")
        }
        body {
//            text "text"
//            textFile "file.txt"
//
            json """{"key":"value"}"""
//            jsonFile "file.txt"
//
//            xml "<xml/>"
//            xmlFile "file.txt"
//
//            html "<html/>"
//            htmlFile "file.txt"
//
//            file "file.txt"
        }
    }
//    control {
//        delay 3
//    }
}

做Android的同学,看到这个是不是眼熟,跟咱们的gradle是不是很像,没错,gradle也是一种DSL。

下面依次做讲解,mock下面主要分为4部分:描述,请求匹配、响应信息、控制部分。

描述

enable: 是否启用本条mock配置,默认是true,如果需要取消本次配置,可以设置为enable false

desc: 本次mock配置的描述信息

请求匹配

scheme: 请求scheme,如果指定某一种,则只匹配这种,如果不设置,则默认为httphttps都匹配

host: 主机类型,如果设置,则匹配host,否则为null,则认为匹配成功

port: 请求端口,如果设置,则匹配端口,否则为80

path: 请求路径,如果设置,则匹配路径,否则为null,则认为匹配成功

method: 请求方法,如果设置,则匹配方法,否则为null,则认为匹配全部方法

params: 请求参数,如果设置,则匹配参数,否则为null,则认为匹配成功,暂时无用,保留

headers: 请求头部,如果设置,则匹配头部,否则为null,则认为匹配成功,暂时无用,保留

body: 请求实体,如果设置,则匹配实体,否则为null,则认为匹配成功,暂时无用,保留

简单来说,如果设置了,就严格匹配,不设置则认为匹配成功。

响应信息

同上面类似,只不过是返回的数据,如果request完全匹配,则返回response中的信息。

version: http版本协议,默认为'HTTP/1.1'

code: 响应状态吗,默认为200

headers: 所有的头部

header: 添加头部,一共2个参数,第一个为key,第二个为value

body: 响应body

text: 设置body为文本内容,参数为字符串类型

textFile: 设置body为文本文件内容,参数为文本文件对于的路径

json: 设置body为json,参数为json字符串

jsonFile 设置body为json文件中的内容,参数为json文件路径

xml: 设置body为xml,参数为xml字符串

xmlFile 设置body为ml文件中内容,参数为xml文件路径

html: 设置body为hml,参数为hml字符串

htmlFile: 设置body为hml文件中内容,参数为html文件路径

file: 设置body为一个文件的内容,参数为文件路径

因为配置文件使用的是Groovy,所以可以使用三个双引号来设置字符串,比如设置返回为json字符,json是是包含双引号的,如果按照Java中方式,那么就会出现转码,这样不方便阅读和修改。

那么可以这样设置,是不是很方便。

json """
{
    "key":"value",
    "hello":"world"
}
"""

控制信息

delay: 设置响应时间,可以模拟入网环境,如果不设置,那么里面返回数据。

示例

比如我想Mock接口为http://www.baidu.com一条数据,那么首先启动mms服务。

$ mms
Path: /usr/local/bin/.
Cmd: mms
Log level : INFO

          _____                    _____                    _____
         /                      /                      /    
        /::\____                /::\____                /::    
       /::::|   |               /::::|   |               /::::    
      /:::::|   |              /:::::|   |              /::::::    
     /::::::|   |             /::::::|   |             /:::/:::    
    /:::/|::|   |            /:::/|::|   |            /:::/__:::    
   /:::/ |::|   |           /:::/ |::|   |            :::   :::    
  /:::/  |::|___|______    /:::/  |::|___|______    ___:::   :::    
 /:::/   |::::::::      /:::/   |::::::::      /   :::   :::    
/:::/    |:::::::::\____/:::/    |:::::::::\____/::   :::   :::\____
::/    / ~~~~~/:::/    /::/    / ~~~~~/:::/    /:::   :::   ::/    /
 /____/      /:::/    /  /____/      /:::/    /  :::   :::   /____/
             /:::/    /               /:::/    /    :::   :::    
            /:::/    /               /:::/    /      :::   :::\____
           /:::/    /               /:::/    /        :::  /:::/    /
          /:::/    /               /:::/    /          :::/:::/    /
         /:::/    /               /:::/    /            ::::::/    /
        /:::/    /               /:::/    /              ::::/    /
        ::/    /                ::/    /                ::/    /
         /____/                  /____/                  /____/

[2017-09-20 19:39:45 | INFO] >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
[2017-09-20 19:39:45 | INFO] Parse GET : [ [http/https]://www.google.com/[path]/ ]       /Users/xiaqiulei/test/proxy/./template.groovy -> template
[2017-09-20 19:39:45 | INFO] <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
[2017-09-20 19:39:45 | INFO] Starting proxy at address: 0.0.0.0/0.0.0.0:9090
[2017-09-20 19:39:45 | INFO] Proxy listening with TCP transport
[2017-09-20 19:39:46 | INFO] Proxy started at address: /0:0:0:0:0:0:0:0:9090

添加配置文件baidu.groovy,注意文件后缀必须是.groovy结尾。

mock {
    desc "baidu"
    request {
        host "www.baidu.com"
    }
    response {
        code 200
        headers {
            header "header_key_1", "header_value_1"
            header "header_key_2", "header_value_2"
            header "time", new Date().format("yyyy-MM-dd HH:mm:ss")
        }
        body {
            json """{
    "key":"value",
    "hello":"world"
}"""
        }
    }
    control {
        delay 2
    }
}

过一会控制台就会出现文件修改的事件。

[2017-09-20 19:40:25 | INFO] >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
[2017-09-20 19:40:25 | INFO] Parse X : [ [http/https]://baidu.com/[path]/ ]          /Users/xiaqiulei/test/proxy/./baidu.groovy -> baidu
[2017-09-20 19:40:25 | INFO] Parse GET : [ [http/https]://www.google.com/[path]/ ]       /Users/xiaqiulei/test/proxy/./template.groovy -> template
[2017-09-20 19:40:25 | INFO] <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

然后我们用curl来验证下。

curl http://www.baidu.com

curl http://www.baidu.com --proxy localhost:9090 -v

很显然,两次请求返回的数据是不一样的,只不过第二次我们设置了代理,然后代理返回Mock的数据,同样,在移动端,可以设置的网络代理,然后就可以Mock App中的请求数据。

相关资料

利用charles模拟Http请求和响应

Anyproxy Github

MyMockServer Github

责任编辑:admin     二维码分享:
本文标签: header设置mmsINFO匹配body