Java单元测试 Http Server Mock框架选型

Wesley13
• 阅读 387

背景动机

某期优化需要针对通用的HttpClient封装组件--HttpExecutor在保证上层暴露API不动的前提做较多改动,大致包括以下几点:

  • apache http client 版本升级
  • HttpClientBuilder代码重构
  • RequestBuilder代码重构
  • 自定义RetryHandler
  • HttpContext扩展
  • 自定义HttpRequestInterceptor/HttpResponseInterceptor

代码很快修改完了,但是如何保证HttpExecutor的行为和以前是一致的呢?很容易就想到是单元测试。因为以前的代码并未提供组件的单元测试,都是依赖QA同学的黑盒测试完成,现有的单元测试又都是在更上层的HttpDao上,重点是对返回数据的解析逻辑代码验证,直接Mock了HttpExecutor的返回结果,完全无法覆盖底层组件的请求逻辑,因此配合本期优化需要提供HttpExecutor组件的单元测试。

需求分析

先大致分析一下HttpExecutor组件提供的功能:

  • 注册apache http client实例的初始化和销毁,包含ConnectionManager等apache http client子功能组件;
  • 上层入参的转封装,以及HttpResponse结果的初步解析封装(response header、status code、response data);
  • 依赖Interceptor对Http请求进行简单的统计;
  • 指定IO异常时的重试功能;

从功能上来分析,我需要的框架/组件需要满足以下功能:

  1. 响应延时;
  2. 异常模拟;
  3. Response Mock;
  4. request verify(请求验证);
  5. 必须是通过server simulate的方式,而非client stub,即必须真实的发起Http请求;
  6. 足够轻量,不必通过独立进程部署;

作为加分项,最好可以提供以下功能:

  1. Record & Replay(记录真实请求自动生成回放配置,生写代码有点痛苦);
  2. 支持json或yaml等非代码的DSL配置方式;
  3. 和Junit等单元测试框架集成良好;
  4. 支持maven plugin;
  5. 支持版本控制;

选型

从需求分析中必须真实发起请求来看,我的目标就是类似前后端分离开发中常用的API管理平台,这种平台很多,国内的类似小幺鸡YApiRap2Eolinker。但这些平台都必须是作为独立进程部署,而作为单元测试场景,我需要的足够轻量的部署方式。 照例先google、baidu、stackoverflow、github、mvnrepository上转一圈,找到了以下几篇关联性较强的文章(仓库):

微服务下的契约测试(CDC)解读中对契约测试、单元测试、接口测试区别描述中可以发现,契约测试完全能满足甚至超出我的需求,因此下面的框架选型也从契约测试的方向来出发。

根据文章推荐,筛选出mock-serverokhttp/mockwebserverWireMock

Framework

部署方式

抓取回放请求

代理服务模式

Https/SSL

Http2

故障模拟

多语言支持

非代码配置

生态(其他框架集成)

Http Log

Response模板

mock-server

jar包集成/独立war包部署/Maven Plugin/Node.js Module/Grunt Plugin/Docker/Kubernetes/Homebrew 等,详见Running Mock Server

支持

支持

支持

支持

支持响应延时以及500等错误响应模拟

支持多语言client(java、ruby、node)

json文件配置

-

支持

支持

okhttp/mockwebserver

jar包集成

不支持

不支持

-

支持

支持模拟慢速网络环境以及500等错误响应模拟

支持

json文件配置

OKHttp

不支持

不支持

WireMock

jar包集成/独立war包部署

支持

支持

支持

jre8版本支持

支持响应延时以及500等错误响应模拟

Node.js

json文件配置

spring-cloud-contract

支持

支持

功能特性对比

就支持的功能集来看,okhttp/mockwebserver最弱,WireMockmock-server两者支持的特性大体相同,但是mock-server支持更多种语言和更多的部署环境,而WireMock则有Spring Cloud Contract的光环加持。

架构依赖对比

okhttp/mockwebserver本身就是OKHttp的mock组件,完全是原生的实现,除了Junit几乎没有其他依赖,是3个框架里最轻量的,详见mockwebserver/4.2.2

mock-server使用netty作为http server,最大的依赖项就是netty,其他还有一些guava、commons-collection4、jackson等依赖,详见mockserver-core/5.6.1

WireMock使用jetty作为http server,是典型的servlet架构,其他还依赖guava、jackson、httpclient等,详见wiremock-jre8/2.25.0

流行度对比

google trends结果显示WireMock更流行,而npm trends的结果正好相反,npm trends上mock-server的流行度可谓完全碾压WireMock,可能和mock-server对多语言的支持以及丰富的部署环境支持有关。

总结

我们知道框架选型永远都是根据选型人员、代码现状、需求场景来决定的,因此我这里只做推荐,不说结论。

如果你只是需要简单的HTTP Server Simulator辅助业务逻辑测试,无需SSL协议支持,那我推荐你使用okhttp/mockwebserver,功能够用,十分轻量,而且是OKHttp的组件,如果是Android开发那使用正好(Android上OKHttp使用率碾压HttpClient)。

如果你已经有很多Http API在运行,希望使用Record & Replay简化Mock DSL的编写,那么mock-serverWireMock都能满足你。

如果你的测试场景包含UI/UX测试,那支持node.js的mock-server对前端开发更为友好。又或者你的真实server是netty,不想引入servlet架构。

如果你是单纯的Java API测试,并且你还使用了Spring Cloud技术栈,那么WireMockSpring Cloud Contract是很合适的选择。

最后,附上一篇自己实现Mock Server的参考文档Using Sun Java 6 HttpServer to write a functional HTTP test

点赞
收藏
评论区
推荐文章
技术小男生 技术小男生
2个月前
linux环境jdk环境变量配置
1:编辑系统配置文件vi/etc/profile2:按字母键i进入编辑模式,在最底部添加内容:JAVAHOME/opt/jdk1.8.0152CLASSPATH.:$JAVAHOME/lib/dt.jar:$JAVAHOME/lib/tools.jarPATH$JAVAHOME/bin:$PATH3:生效配置
光头强的博客 光头强的博客
2个月前
Java面向对象试题
1、请创建一个Animal动物类,要求有方法eat()方法,方法输出一条语句“吃东西”。创建一个接口A,接口里有一个抽象方法fly()。创建一个Bird类继承Animal类并实现接口A里的方法输出一条有语句“鸟儿飞翔”,重写eat()方法输出一条语句“鸟儿吃虫”。在Test类中向上转型创建b对象,调用eat方法。然后向下转型调用eat()方
Jacquelyn38 Jacquelyn38
1年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
blmius blmius
1年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
小森森 小森森
2个月前
校园表白墙微信小程序V1.0 SayLove -基于微信云开发-一键快速搭建,开箱即用
后续会继续更新,敬请期待2.0全新版本欢迎添加左边的微信一起探讨!项目地址:(https://www.aliyun.com/activity/daily/bestoffer?userCodesskuuw5n)\2.Bug修复更新日历2.情侣脸功能大家不要使用了,现在阿里云的接口已经要收费了(土豪请随意),\\和注意
Wesley13 Wesley13
1年前
Java爬虫之JSoup使用教程
title:Java爬虫之JSoup使用教程date:201812248:00:000800update:201812248:00:000800author:mecover:https://imgblog.csdnimg.cn/20181224144920712(https://www.oschin
Wesley13 Wesley13
1年前
MySQL查询按照指定规则排序
1.按照指定(单个)字段排序selectfromtable_nameorderiddesc;2.按照指定(多个)字段排序selectfromtable_nameorderiddesc,statusdesc;3.按照指定字段和规则排序selec
Stella981 Stella981
1年前
Angular material mat
IconIconNamematiconcode_add\_comment_addcommenticon<maticonadd\_comment</maticon_attach\_file_attachfileicon<maticonattach\_file</maticon_attach\
Wesley13 Wesley13
1年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
helloworld_34035044 helloworld_34035044
5个月前
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为