使用Robot Framework进行接口测试

在robot当中，python语言的接口测试库名称为RequestsLibrary，它依赖于requests测试框架。使用pip命令：

pip install -U requests
pip install robotframework-requests

一、新建一个接口测试工程

 注意，工程名称只能是英文。如果含有中文，那么在跑用例时会报错。

二、创建测试套和测试用例

测试套相当于一个测试集合。

右击工程，选择New Suite:

点击OK即可。

接着在测试套下右击，选择New Test Case创建测试用例：

 点击OK：

测试套、测试用例都可以是中文

三、导入接口测试库

为方便用例共同使用，建议在测试套一层导入测试库。值得一提的时，在项目那层导入测试库，对测试用例来说是无效的，所在在测试套那里导入就好。点击测试套，在settings区域点击Library：

在弹出框的Name字段中输入RequestsLibrary，点击OK：

 如果导入的库正常，则是黑色字体，否则是红色字体。

四、认识RequestsLibrary中的关键字

在ride上按F5可以显示关键字的使用说明：

 RF关键字分为三个类别：
第一类：与服务端的会话。
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请求等请参看网上其它资料

五、编写接口请求用例

注册链接：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位)

步骤如下：
1）创建与服务端的会话(create session类的关键字)
2）在1）的基础上，发送请求。
3）获取响应结果，可后续对响应结果进行解析和断言(robot标准库中的断言关键字使用)。

用例的文本格式如下：

*** Settings ***
Library           RequestsLibrary

*** Test Cases ***


示例
    #设置请求头
    &{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
    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"]}

 执行结果：

 

本文部分参考了robotframework框架 - 利用RequestsLibrary关键字轻松实现接口自动化！