robotframework(后续简称为robot)是一款自动化测试框架,可能做各种类型的自动化测试。
本文介绍通过robotframework来做接口测试。
第一步:安装第三方库,提供接口测试的关键字。
在robot当中,python语言的接口测试库名称为RequestsLibrary
安装语法如下:
pip install -U requests
pip install -U robotframework-requests
第二步:在robot当中,引入RequestsLibrary。
在robot编辑工具eclipse当中,创建test suites,并在Settings区域当中引入:
*** Settings ***
Library RequestsLibrary
第三步:认识RequestsLibrary中的关键字。
如下图所示,RequestsLibrary当中,有22个关键字。
其中,get、post、head、options、patch、put、delete这7个关键字不建议用,将被废弃。
用get request、post request、head request、options request、patch request、put request、delete request这7个关键字来代替他们。
所以一共有15个关键字可用。分为三个类别:
第一类:与服务端的会话。
包含 Create Session创建会话相关的5个关键字、
update session更新会话关键字、Delete all session删除会话
第二类:请求类型。get requests等发送请求的关键字。
第三类:响应结果转json:To json关键字。将json字符串转换成python对象。
关键字1:Create Session
关键字功能:创建与服务端的会话。
参数1:alias 会话别名。在此会话之上的http请求都需要带上此别名。
参数2:url 服务器base url。此处并不是指具体某个接口的地址。而服务器根地址。比如域名或者ip地址+端口。
参数3:headers 请求头。与服务器会话过程中,通过的请求头。参数类型为字典 。
参数4:verify SSL证书将被验证。默认为False,表示不验证。
参数5:auth 参数类型为列表。用户名和密码的列表形式。用来作http基本认证。
其它参数略过,可参考网上其它资料。
关键字2:Post Reqeust
关键字功能:发送post请求并得到响应结果。
此处的响应结果为python requests库当中的Response对象。
参数1:alias 会话别名。来自Create Session关键字中的别名。表示在某个会话上进行请求。
参数2:uri 接口地址。但是不包含服务器的base url。
参数3:data 请求数据。参数类型为字典 。
参数4:json 请求数据。请求数据类型为application/json。参数类型为字典 。
参数5:params 查询参数。直接组合在接口地址后面,并不放在请求体当中。
参数6:headers 请求头。
其它的get请求/put请求等请参看网上其它资料。
第四步:使用RequestsLibrary编写接口请求用例。
步骤如下:
1)创建与服务端的会话(create session类的关键字)
2)在1)的基础上,发送请求。
3)获取响应结果,可后续对响应结果进行解析和断言(robot标准库中的断言关键字使用)。
演示案例:
注册链接:http://test.lemonban.com/ningmengban/app/register/register.html
注册接口:http://test.lemonban.com/ningmengban/mvc/user/register.json
请求类型:POST
请求数据格式:application/x-www-form-urlencoded
请求数据:
key | value |
---|---|
username | 11位手机号码 |
password | 经过md5加密后的6位以上的密码(32位) |
发送post请求示例(注意:post请求必须在请求头当中指明数据格式):
执行后的结果为:
脚本源文件内容如下:
*** Settings ***
Library RequestsLibrary
*** Test Cases ***
注册接口-post
# 设置请求头 .
&{header}= Create Dictionary Content-Type=application/x-www-form-urlencoded
# 会话别名为 nmb 接口所在服务器域名地址为:test.lemonban.com
Create Session nmb http://test.lemonban.com headers=${header}
# 准备请求数据
&{data}= Create Dictionary username=18688710213 passwd=fe7ead29e825e0463d9d8fca37ee42f5
# 发送post请求,并用变量接收响应结果
${resp} Post Request nmb ningmengban/mvc/user/register.json
# ${resp} = 是一个python requests库当中的Response对象。我们需要从这个对象当中,拿到响应的具体数据。
# 从python对象当中拿数据的方法:${python中Request的表达式}
# 获取http请求的状态码
Log ${resp.status_code}
# 获取本次的响应数据
Log ${resp.text}
# 将响应数据从字符串转换成python的字典对象
Log ${resp.json()}
# 断言 - 字符串相等
Should Be Equal As Strings ${resp.text} {"success":true,"message":"注册成功","content":null,"object":null}
# 断言 - 从字典当中取出message的值,与 注册成功 是否相等。
Should Be Equal As Strings 注册成功 ${resp.json()["message"]}