WireMock 团队合作操作指南

1. WireMock 起⻜飞⼿手册
shengxuanwei
2016-11-09
1

2. 我们遇到的问题
• 由于 API 开发限制，开发依赖接⼝口交付
• 由于 API 不不可靠，开发和集成测试频繁失败
• 由于 API 数据限制，测试不不同的数据集⾮非常困难
2

3. 我们的解决⽅方案
WireMock is a library for stubbing and proxying web services.
http://wiremock.org/
3

4. 特点
• 模拟⽹网络请求
• 错误注⼊入和模拟⽹网络异常
• 录制与回放
• 单元测试或独⽴立使⽤用
• 搭建环境简单，容易易上⼿手
4

5. 5

6. 6

7. 7

8. 8

9. 待解决的问题
1. 代理理设计
2. 透明代理理和⽤用
户感知
3. HTTPS 和
MITM
4. 触发条件设计
5. 请求匹配规则
6. GET 接⼝口返回模拟
7. POST / DELETE 接⼝口
返回模拟
8. 情景操作模拟
9. ⽹网络延时模拟
10.分发与部署
11.规范和维护
12.….
9

10. 代理理设计
• Reverse Proxy 1，代理理连接 Charles 或
Fiddler，通过 Map Remote 映射 API 请求
• Reverse Proxy 2，修改 SERVER_HOST，
直接连接 WireMock
10

11. 透明代理理和⽤用户感知
• 如果匹配 Match 规则，就返回 Mock 数据。如果不不
匹配 Match 规则，就请求 API 数据，Mock 数据和
API 数据混⽤用，⽤用户⽆无明显感知
• 通过 Priority 请求匹配规则和 proxyBaseUrl 参数
• 怎么设计前端⽤用户感知，让⽤用户分辨看到是 Mock 数
据还是 API 数据
11

12. HTTPS
• 将 wiremock.jks ⽂文件放到 keystore ⽬目录
• ⼿手机下载安装 wiremovk.p12 证书⽂文件
12

13. 触发条件设计
• 问题是什什么样的条件触发 Mock 数据，既能达到
Mock 效果，也不不影响整体使⽤用？
• 可能的条件，特定⽤用户、城市、品牌、价格等等
• 触发条件的可达性，稳定性，兼容性
13

14. 请求匹配规则
• URL
• HTTP Method
• Query parameters
• Headers
• Request body
14

15. URL 匹配
• url
• urlPath
• urlPattern
• urlPathPattern
15

16. HTTP 头部属性匹配
• equalTo
• contains
• matches
• notMatch
• absent
16
queryParameters
headers/X-RAW-PARAMETERS

17. JSON 或 jsonBody
• GET 请求采⽤用 JSON ⽂文件保存
• POST / DELETE 请求推荐采⽤用 jsonBody
• JSON 使⽤用中⽂文编码保存
• http://www.bejson.com/convert/unicode_chinese/
17

18. 有状态的⾏行行为（场景）
• scenarioName
• requiredScenarioState
• newScenarioState
18

19. ⽹网络延时模拟
• fixedDelayMilliseconds
• delayDistribution : lognormal, uniform
19

20. 分发与部署
• 通过 Git 来管理理和分发配置
• 独⽴立部署
• API 前端部署
20

21. 规范与维护
• mapping_Method_urlPath_statusCode_queryParam
eters_scenarioState.json
• body_Method_urlPath_statusCode_queryParameter
s_scenarioState.json
21

22. API 开发流程重设计
1.API proposal in wiki
2.Discussions
3.Agree
4.Mock it!
5.Profit
22

23. The End.
23