robotframework框架 - 利用RequestsLibrary關鍵字輕鬆實現接口自動化！

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} = <Response [200]>   是一個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"]}