开源软件名称：restful-tester

开源软件地址：https://gitee.com/zzq0324/restful-tester

开源软件介绍：

#restful-tester

##项目说明目前大部分的restful接口测试工具，仅仅停留在验证接口响应是否正常，具体的业务是否正确需要靠人工来分析。人工分析势必比较耗时，而且随着项目的迭代，重复工作量的浪费比较严重。因此，考虑到接口的变动会较少，自动化接口测试将很有必要。

##项目技术实现

采用HttpClient实现接口的调用，支持GET/PUT/POST/DELETE方式，支持目前Restful接口规范常用的Http方法；
自动化脚本的编写采用Cucumber来实现，脚本编写的时候分为Feature、Scenario以及Step。每个Feature下可以包含N个场景，每个场景下有M个步骤，和实际测试中的测试用例场景贴近；
结果验证采用Javascript Engine，由于Javascript支持弱语言，因此在处理上兼容性会更好，具体代码如下：

public class ExecuteEngine {    private static ScriptEngineManager ENGIEN_FACTORY = new ScriptEngineManager();    private static ScriptEngine        JS_ENGINE      = ENGIEN_FACTORY            .getEngineByName("JavaScript");    public static Boolean execute(String expression) throws Exception {        String parseExpression = ExpressionParser.parse(expression).toString();        Boolean result = (Boolean) JS_ENGINE.eval(parseExpression);        return result;    }}

##脚本编写说明

在src/main/resources目录下增加org/simplestudio/restful/模块名称的目录，其中模块名称为具体要测试的业务模块，比如备忘模块，审批模块；
在新增的目录下，以模块名称为文件名称，增加.properties文件，里面配置好测试的接口url以及变量（如果有需要的话）；
在新增的目录下，增加.feature的文件，文件的规范参照Cucumber官方的说明。具体本框架支持的Step详见Step说明；

##支持的Step说明

Given 使用用户名=[xxx]登录系统
采用[POST]方式请求URL[http://www.baidu.com],不传参数,不记录返回值
采用[PUT]方式请求URL[xxx],不记录返回值
采用[GET]方式请求URL[xxx],不传参数,并记录返回值为[xxx]
采用[PUT]方式请求URL[xxx],并记录返回值为[xxx]
打印结果,打印的记录值为[xxx]
进行结果校验,表达式为[xxx]

##例子###common.properties

#模块名称,名称需要和feature的文件目录结构保持一致moduleName=kuaidi100#要执行的feature顺序，同个feature可以多次执行，多个以逗号隔开。不配置按照cucumber默认的解析顺序执行run.feature.orderlist=快递100接口测试#增加的plugin列表，多个以逗号隔开.默认会强制生成excel的报告add.plugin.list=html:target/html

###kuaidi01.properties快递ID=700259627563 快递类型=yuantong 查询存在的快递=http://www.kuaidi100.com/query?type=${快递类型}&postid=${快递ID}&id=1&valicode=&temp=0.7655106628875419 查询不存在的快递=http://www.kuaidi100.com/query?type=${快递类型}&postid=100259627562&id=1&valicode=&temp=0.7655106628875419

####kuaidi01.feature`Feature: 快递100接口测试

Scenario: 查询-正常情况	When 采用[GET]方式请求URL[${查询存在的快递}],不传参数,并记录返回值为[快递信息]	Then 进行结果校验,表达式为[${快递信息.status} == 200]	Then 进行结果校验,表达式为[${快递信息.message} == 'ok']	Then 进行结果校验,表达式为[${快递信息.nu} == 700259627563]	Scenario: 查询-异常情况	When 采用[GET]方式请求URL[${查询不存在的快递}],不传参数,并记录返回值为[快递信息]	Then 进行结果校验,表达式为[${快递信息.status} == 201]	Then 进行结果校验,表达式为[${快递信息.message} == '快递公司参数异常：单号不存在或者已经过期']

##运行结果