REST风格接口测试利器Wisdom rest-client

前言

偶然间接触到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文档

目前我对工具的研究基本上就这么多，感兴趣的同学可以试试这款工具