前言
偶然间接触到Wisdom rest-client这款测试工具,后来经过尝试体验,感觉还不错,现在分享给大家,如何使用这款测试利器
Wisdom rest-client是什么?
Wisdom rest-client 一款自动化测试REST API的工具,它可以自动化测试REST API并生成精美的测试报告,同时基于测试过的历史数据,可以生成精美的REST API文档。
安装
1. Download JAR: restclient.jar
;
下载JAR包restclient.jar
;
2. Install Java 1.7
or higher version;
使用前请先安装Java 1.7
或者更高版本;
3. Double click restclient.jar
to launch GUI.
双击restclient.jar
即可运行工具。
使用介绍
一、菜单说明
1、File菜单介绍,“import”为导入工程(个人理解的),“export”为导出工程,导出的形式为json,“exit”这个不用我多说了
export导出的工程实例:
为无扩展名的文件,打开如下:
2、Edit处的菜单,点击“Reset Request”,将清空request选项卡内容,点击“Reset Response”,将清空response选项卡下内容,点击“Reset All”,将清空request、response选项卡下内容,“Remove All”将清空所有内容
3、Test处菜单,点击“Start Test”,将运行“History”中所有请求过的接口,并自动打开浏览器生成测试报告,点击“StopTest”,将停止测试(具体没看出来效果,也许接口较多的时候会有效果吧),点击“Test Report”,并自动打开浏览器生成测试报告
4、Apidoc处菜单,点击“Create”,将生成当前请求接口RESTful API,点击“open”,打开所有请求接口的RESTful API
create操作
open操作
5、Help处菜单,点击“help content”,将生成帮助文档,点击“Report issure”,将跳转至github页面,后面两个,第一个是打赏,第二个是关于工具介绍
二、准备
1、rest风格接口准备
示例如下:
/**
* 获取商品列表
*
* @param start
* @param end
* @return
*/
@RequestMapping(value = "/api/restDemo/{start}/{end}", method = RequestMethod.GET)
@ApiOperation(value = "get请求形式", httpMethod = "GET")
public Map getList(@PathVariable Integer start,
@PathVariable Integer end) {
Map<String, Integer> myList = new HashMap<>();
myList.put("康师傅牛肉面", start);
myList.put("王力宏代言矿泉水", end);
return myList;
}
/**
* 登录接口示例
*
* @param response
* @param userName
* @param password
* @return
*/
@RequestMapping(value = "/login/{userName}/{password}", method = RequestMethod.POST)
@ApiOperation(value = "登陆接口,成功后获取cookies信息", httpMethod = "POST")
public String login(HttpServletResponse response, @PathVariable String userName, @PathVariable String password) {
if (userName.equals("rongrong") && password.equals("123456")) {
Cookie cookie = new Cookie("login", "true");
response.addCookie(cookie);
return getMessage("90001", "恭喜你登陆成功了!");
}
return getMessage("90557", "用户名或者是密码错误!");
}
2、启动本地服务
3、双击restclient.jar
即可运行工具
三、如何使用工具测试一个接口
1、Request菜单,地址栏输入接口请求地址如:http://localhost:8888/login/1/1,请求方法选择Post
2、点击右侧>>,完成请求
3、完成Request配置后,点击URL右侧的Start绿色按钮生成结果,界面自动跳转到Response——Raw Text界面。这个界面会显示这次测试输入参数和结果的详细情况。
4、最后,可以到History菜单中查看完成的用例,并进行给用例起名、删除用例或调整用例位置等操作。
5、完成的用例集可以以文件的形式导出,等下次需要执行时导入就行了。
执行测试用例很简单,直接在菜单中选择Test→Start Test就行了。Rest-client工具另一个优点就是可以自动生成网页版的测试报告,包括比较直观的成功率扇形统计图和说明失败原因的表格。
示例:
6、找到apidoc,点击open,则会生成所有请求接口的RESTful API文档
目前我对工具的研究基本上就这么多,感兴趣的同学可以试试这款工具