java接口自动化Excel占位符_基于maven+java+TestNG+httpclient+poi+jsonpath+ExtentReport的接口自动化测试框架...

接口自动化框架

项目说明

本框架是一套基于maven+java+TestNG+httpclient+poi+jsonpath+ExtentReport而设计的数据驱动接口自动化测试框架，TestNG 作为执行器，poi用于读取存放于excel的接口用例，jsonPath用于校验返回值，以及提取返回值。本框架无需你使用代码编写用例，在excel中即可进行接口用例编写，接口依赖关联，接口断言，控制用例的运行。

技术栈

maven

java

TestNG

httpclient

poi

jsonpath

ExtentReport

环境部署

安装jdk8，并配置好环境变量

maven中直接导入项目工程包，导入成功后，maven会自动下载当前项目的所有依赖包

代码设计与功能说明

1、定义运行配置文件 api-config.xml

api请求根路径、请求头及初始化参数值可以在api-config上进行配置。

rootUrl: 必须的配置，api的根路径，在调用api时用于拼接，配置后，会在自动添加到用例中的url的前缀中。

headers: 非必须配置，配置后在调用api时会将对应的name:value值设置到所有请求的请求头中header-name:header-value。

params：非必须配置，公共参数，通常放置初始化配置数据，所有用例执行前，会将params下所有的param配置进行读取并存储到公共参数池中，在用例执行时，使用特定的关键字(${param_name})可以获取。具体如下：

api-config.xml配置信息

http://127.0.0.1:12306

接口自动化测试报告demo

2、测试用例的设计

测试用例以excel格式的文件保存，除表头外，一行代表一个api用例。执行时会依次从左到右，从上到下执行。case/api-data.xls测试用例的数据格式如下：

run：标记为‘Y’时，该行数据会被读取执行；标记为‘N’则不被执行

description：该用例描述，在报告中体现。

method：该api测试用例的请求方法。

url：该api测试用例的请求路径。

说明：

若配置文件(api-config.xml)中rootUrl为：http://127.0.0.1:12306 ，url的值为：/parkinside ，框架执行的时候会根据配置文件中rootUrl进行自动拼接为：http://127.0.0.1:12306/parkinside 。若url填写为http作为前缀的值如：http://127.0.0.1:12306/parkinside 将不会进行拼接。

param：请求方法为post时，body的内容(暂只支持json,不支持xml)

verify：对于api请求response数据的验证(可使用jsonPath进行校验)。校验多个使用“；”进行隔开。

若verify填写值为：$.username=wuya;$.userID=22 ，则会校验返回值中$.username的值为wuya，$.userID的值为22，只要有一个校验错误，后面的其他校验项将停止校验。

save：使用jsonPath对response的数据进行提取存储。

说明：若save值为：id=$.userId;age=$.age ，接口实际返回内容为：{"username":"chenwx","userId":"1000","age":"18"}，则接口执行完成后，会将公共参数userId的值存储为1000，age存储为18。公共参数可在后面的用例中进行使用。

公共关联池中的公共参数使用

测试用例excel表中可以使用‘${param_name}’占位符，在执行过程中如果判断含有占位符，则会将该值替换为公共参数里面的值，如果找不到将会报错。具体使用格式如下：

{

"token":"${g_token}",

"vpl":"AJ3585"

}

3、函数助手

测试用例excel表中可以使用‘__funcName(args)’占位符，在执行过程中如果判断含有该占位符，且funcName存在，则会执行相应的函数后进行替换。部分函数说明如下：

__random(param1,param2):随机生成一个定长的字符串(不含中文)。param1:长度(非必填，默认为6)，param2：纯数字标识(非必填，默认为false)。

__randomText(param1): 随机生成一个定长的字符串(含中文)。param1:长度(非必填，默认为6)

__date(param1)&#x