Mock Server实践

时间 2019-11-10

标签 mock server 实践繁體版

原文原文链接

转载自：《Mock Server实践》闫帅：http://tech.meituan.com/mock-server-in-action.htmlphp

背景

在美团服务端测试中，被测服务一般依赖于一系列的外部模块，被测服务与外部模块间经过REST API或是Thrift调用来进行通讯。要对被测服务进行系统测试，通常作法是，部署好全部外部依赖模块，由被测服务直接调用。然而有时被调用模块还没有开发完成，或者调用返回很差构造，这将影响被测系统的测试进度。为此咱们须要开发桩模块，用来模拟被调用模块的行为。最简单的方式是，对于每一个外部模块依赖，都建立一套桩模块。然而这样的话，桩模块服务将很是零散，不便于管理。Mock Server为解决这些问题而生，其提供配置request及相应response方式来实现通用桩服务。本文将专门针对REST API来进行介绍Mock Server的总体结构及应用案例。html

名词解释

Mock规则：定义REST API请求及相应模拟响应的一份描述。
Mock环境：根据请求来源IP来区分的Mock规则分组。Mock Server能够定义多套Mock环境，各套环境间相互隔离。同一个IP只能对应一个Mock环境，不一样的IP能够对应同一个Mock环境。

总体结构

Mock Server由web配置页面Mock Admin及通用Mock Stub组成：Mock Admin提供了web UI配置页面，能够增长/删除请求来源IP到Mock环境的映射，能够对各套环境中的Mock规则进行CRUD操做；Mock Stub提供通用桩服务，对被测系统的各种REST API请求调用，返回预先定义好的模拟响应。为了提升桩服务的通吐，使得桩服务能在被测系统压力测试中获得好的表现，咱们开启了5个桩服务，经过Nginx作负载均衡。Mock Server的总体结构以下图所示。java

数据存储

将请求来源IP到Mock环境名的映射存储到mock-env.conf中，mock-env.conf的每一行定义了一条映射，如：
192.168.3.68 闫帅的测试机环境
这条映射代表来源是192.168.3.68的请求，使用Mock环境名为闫帅的测试机环境的Mock规则。
将配置的Mock规则存放到<对应Mock环境名>.xml中，下面部分展现了Mock规则的存储格式。

<configuration>
...
  <mock id="716add4f-33f7-49ac-abf3-fc617712ffea" name="test001" author="yanshuai">
    <request>
      <uri>/api/test/.*</uri>
      <method>GET|POST|PUT|DELETE</method>
      <parameters>
        <parameter name="name" value="test.*"/>
        ...
      </parameters>
      <headers>
        <header name="nb_deviceid" value="1E[0-9a-zA-Z]+"/>
        ...
      </headers>
    </request>
    <response delay="1000" real="false">
      <statusCode>200</statusCode>
      <format>application/json;charset=UTF-8</format>
      <customHeaders>
        ...
      </customHeaders>
      <body>{&quot;name&quot;:&quot;闫帅&quot;}</body>
    </response>
  </mock>
...
</configuration>

Mock Stub

当请求发送到Mock Stub时，Mock Stub会根据请求的来源IP找到对应的独立环境名，而后根据独立环境名获取全部预约义的Mock规则，遍历这些Mock规则，若是找到一条规则与接受到的请求匹配，那么返回预约义的模拟响应。若是找不到规则匹配，那么返回404错误。其中，规则匹配是根据请求中的uri/method/headers/parameters/body是否与Mock规则中定义的对应字段正则匹配来定的。android

Mock Admin

打开Mock Admin配置页面，若是还没有映射来源IP地址到环境，则点击环境列表导航连接，进入环境列表页面，点击添加，输入源IP及环境名，点击肯定按钮，实现源IP到所设环境的映射。
点击规则列表，规则列表页面将默认罗列出default环境的全部Mock规则（如“语音登陆code获取”规则）。从新选择环境，能够罗列出所选环境中的Mock规则。每一个Mock规则都处于详细信息展开的状态。点击“所有折叠”按钮，将把全部的规则详细信息给隐藏；点击“所有展开”按钮，将把全部的规则详细信息给展开。点击“只显示本人建立的规则”，将过滤获得mis帐户用户建立的规则。点击“按建立时间排序”的开关按钮，将实现Mock规则的升序/降序显示。
点击导航栏的“新建规则”选项，能够建立一个Mock规则，须要填写规则名称、请求及响应，并选中环境。对于请求，须要填写URL及勾选Method，若是要求对于符合某种规则的请求才被Mock，则填写对应的Headers/Parameters/Body Like，这些数据都是正则匹配的形式。对于响应，若是勾选了“返回真实响应”，则只须要关注延时（延时是指返回请求须要的sleep时间，单位是毫秒）。此时须要将请求的URL地址给写完整了，须要包含host(IP)及port，不能只是path。若是不勾选“返回真实响应”，则将返回模拟响应。Status Code填写返回码，好比200，404；Format选择返回数据的格式，好比json，html等；还能够返回自定义的Headers及响应的Body。点击新建按钮之后，若是建立成功，则提示成功建立，并跳转到规则列表页面。
对于一个建立好的Mock规则，能够点击Action下拉菜单，进行操做。若是点击“克隆”，则跳转到“新建规则”页面，并将克隆的Mock规则信息给填充进去；点击“编辑”，则跳转到更新页面，更新页面填充了要编辑的Mock规则信息；点击“删除”，则弹出确认删除对话框，点击肯定按钮，将删除此规则；点击取消按钮，则取消删除操做。若是此Mock规则处于详细信息展开状态，则可点击折叠来隐藏详细信息；若是处于详细信息折叠状态，则可点击展开选项，将显示详细信息。上移选项，能够将Mock规则上移一位；下移选项，能够将Mock规则下移一位。

使用方式

修改被测服务的HTTP依赖，将依赖的IP和端口分别设置为mock.ep.sankuai.com和80，并重启被测服务；
建立Mock规则；
调用被测服务的API，被测服务将调用Mock服务；
删除Mock规则（可选）。

编程使用

建立/删除Mock规则，除了可经过Mock Admin页面配置外，Mock Server还提供了SDK方式，用户能够经过编码来使用Mock Server。web

在Maven工程pom.xml中添加mock-client依赖

<dependency> <groupId>com.sankuai.meituan.ep.mockserver</groupId> <artifactId>mock-client</artifactId> <version>1.0.6</version> </dependency>

建立/删除Mock规则

// 构造Mock规则 MockRule rule = new MockRule(); rule.setMockName("test-" + System.currentTimeMillis()); // Mock name必须设置 rule.setAuthor("yanshuai"); // author必须设置，设置为代码编写者的mis帐号前缀，好比lining03 MockRequest mockRequest = new MockRequest(); mockRequest.setUri("/api/test/" + System.currentTimeMillis()); // Mock请求的uri必须设置 /** * Mock请求的方法必须设置 * 若是只有GET请求，则写成GET； * 若是有GET请求及PUT请求，则写成GET|PUT； * 即用|分割请求方法，不能有空格。 */ mockRequest.setMethod("POST|GET"); // 必要的话，设置Mock请求的匹配header List<MockRequestHeader> mockRequestHeaders = new ArrayList<MockRequestHeader>(); mockRequestHeaders.add(new MockRequestHeader("device", "android2.3")); mockRequest.setHeaders(mockRequestHeaders); // 必要的话，设置Mock请求的匹配参数 List<MockRequestParameter> mockRequestParameters = new ArrayList<MockRequestParameter>(); mockRequestParameters.add(new MockRequestParameter("wd", "123.*")); mockRequestParameters.add(new MockRequestParameter("version", "v1")); mockRequest.setParameters(mockRequestParameters); rule.setMockRequest(mockRequest); MockResponse mockResponse = new MockResponse(); mockResponse.setDelay(1000L); // 设置Mock响应的延时 mockResponse.setStatusCode(200); // 设置Mock响应的状态码 /** * 设置Mock响应的格式 * 若是是json返回，则为application/json;charset=UTF-8； * 若是是文本返回，则为text/plain:charset=UTF-8； * 若是是xml返回，则为text/xml;charset=UTF-8； * 若是是html返回，则为text/html;charset=UTF-8。 */ mockResponse.setFormat("application/json;charset=UTF-8"); List<MockResponseHeader> mockResponseHeaders = new ArrayList<MockResponseHeader>(); // 设置Mock响应的header mockResponseHeaders.add(new MockResponseHeader("customHeaderName", "customHeaderValue")); mockResponse.setMockResponseHeaders(mockResponseHeaders); mockResponse.setBody("{\"code\":200}"); // 设置Mock响应的body rule.setMockResponse(mockResponse); // 建立Mock规则 final MockClient client = new MockClient(); String id = client.addRule("default", rule); // default为环境名，若是使用别的环境，则填写别的环境名 // 调用被测服务的API，被测服务将调用Mock服务 // 省略调用代码... // 删除Mock规则 client.removeRule("default", id); // default为环境名，若是使用别的环境，则填写别的环境名

典型案例

相同Mock环境，同一接口，不一样参数，能够有不一样的Mock结果
按照下图，依次建立这两条规则（顺序相关），而后在default环境对应的机器上，访问http://mock.ep.sankuai.com/user/v1/info?token=fake，返回{"code":401,"type":"sys_err_auth_fail","message":"invalid token"}；访问http://mock.ep.sankuai.com/user/v1/info?token=other，返回{"user": {"id": 29008301,"mobile": "15001245907","isBindedMobile": 1}}。
真实请求延时Mock
按照下图建立规则，在闫帅的测试机环境对应的机器上，访问http://mock.ep.sankuai.com/api/v1/divisions，将延迟5s返回城市列表json串。
不一样Mock环境，彻底相同的接口参数，能够有不一样的Mock结果
按照下图建立规则，在闫帅的测试机环境对应的机器上，访问http://mock.ep.sankuai.com/cachier/paynotify返回值是failure；在支付php环境对应的机器上，访问http://mock.ep.sankuai.com/cachier/paynotify返回值是success。

http://www.mock-server.com/where/downloads.html