JMeter中的BeanShell斷言,可以使用BeanShell腳本來執行斷言檢查,可以用於更復雜的個性化需求,使用更靈活,功能更強大,但是要能夠熟練使用BeanShell語。
1、BeanShell簡介
Beanshell是一種類似JAVA的腳本語言,通過BeanShell可以對請求數據、響應數據或環境變量進行更加靈活的處理和判斷。還可以直接調用外部的JAR包,例如:可以直接引入現成的第三方JSON解析包來使用。
在JMeter的多種組件中都有BeanShell的身影,如下:
- 定時器:
BeanShell Timer
- 前置處理器:
BeanShell PreProcessor
- 采樣器:
BeanShell Sampler
- 后置處理器:
BeanShell PostProcessor
- 斷言:
BeanShell Assert
- 監聽器:
BeanShell Listener
在JMeter運行的流程控制中,BeanShell出現的位置,如下圖所示:
2、Beanshell的內置變量和方法
Beanshell有一些默認的內置變量和方法,用戶可以通過這些變量與JMeter進行交互,
例如:
prInt
:非GUI模式下打印信息(輸出信息到stdout
,標准輸出控制台)。log
:輸出信息到日志(文件)log.debu("調試信息")
log.info("響應狀態碼" + ResponseCode)
log.warn("警告信息")
log.error("出錯信息")
ResponseCode
:響應狀態碼(String類型)。ResponseHeaders
:響應頭(String類型)。prev
:獲取當前請求結果prew.getResponseDataAsString()
:獲取響應體數據(String類型)。prew.getResponseCode()
:獲取狀態碼(同ResponseCode,String類型)。
vars
:操作JMeter變量String var1 = vars.get("變量名")
:獲取變量的值(假設為String類型)。vars.put("變量名", 變量值)
:設置變量值。
props
:操作JMeter屬性props.get(String,String)
可以獲取JMeter中已經生成的屬性。props.put(String,String)
可以創建和更新JMeter屬性。
ctx
:獲取當前線程上下文數據(可獲取所有信息)ctx.getVariables("變量名")
:獲取變量值(同vars.get()
)。ctx.setVariables("變量名", "變量值")
:設置變量(同vars.put()
)。ctx.getProperties("屬性名")
:獲取屬性值(同props.get()
)。ctx.setProperties("屬性名","屬性值")
:設置屬性(同props.put()
)。ctx.getPreviousResult()
:獲取當前請求結果同(prev
)。ctx.getCurrentSampler()
:獲取當前采樣器。ctx.getPreviousSampler()
:獲取前一采樣器。ctx.getThreadNum()
:獲取線程數。ctx.getThreadGroup()
:獲取線程組。ctx. getThread()
:獲取當前線程。ctx.getEngine()
:獲取引擎。ctx.isSamplingStarted()
:判斷采樣器是否啟動。ctx.isRecording()
:判斷是否開啟錄制。ctx.getSamplerContext()
:獲取采樣器山下文數據。
提示:ctx詳細API可參考:JMeter上下文
3、BeanShell斷言界面詳解
添加BeanShell斷言組件操作:選中“取樣器”右鍵 —> 添加 —> 斷言 —> BeanShell斷言
。
界面如下圖所示:
BeanShell斷言組件的詳細說明:
- 名稱:BeanShell斷言組件的自定義名稱,見名知意最好。
- 注釋:即添加一些備注信息,對該BeanShell斷言組件的簡短說明,以便后期回顧時查看。
Reset bsh.Interpreter before each call
:每個BeanShell測試元素都有自己的解釋器副本(對於每個線程)。如果重復調用測試元素,例如在循環內,除非選擇在每次調用之前重置bsh.Interpreter
選項,否則解釋器將保留在調用之間。一些長時間運行的測試可能會導致解釋器使用大量內存。
由於BeanShell的bsh.Interpreter
存在內存泄露,常規方法無法支持長時間的壓力測試。JMeter官網推薦,在使用BeanShell進行長時間測試時,打開選項Reset bsh.Interpreterbefore each call
,則在每次調用BeanShell程序前,都把解釋器重置,以釋放解釋器之前占用的內存。參數 (-> String Parameters和String[]bsh.args)
:輸入String參數。String []bsh.args
是主類main函數的形式參數,是一個String 對象數組,可以用來獲取命令行用戶輸入進去的參數。- 腳本文件:腳本文件(可以填入腳本文件路徑),可以點擊后邊的瀏覽選擇腳本文件。
Script (see below for variables that are defined)
:編寫腳本,參照下文定義的變量(使腳本文件參照定義的變量來運行)
4、BeanShell斷言的使用
BeanShell斷言中可以通過ResponseCode
、ResponseHeaders
及pre.getResponseDataAsString()
來分別獲得String格式的響應狀態碼、響應頭、響應體數據。結合if
判斷,通過變量Failure=false
或Failure=true
來設置斷言是否通過。當設置Failure=true
時,還可以設置FailureMessage
來設置失敗原因。
我們以一個登陸接口,來演示BeanShell斷言組件的應用。
(1)測試計划內包含的元件
添加元件操作步驟:
- 創建測試計划。
- 創建線程組:
選中“測試計划”右鍵 —> 添加 —> 線程(用戶) —> 線程組
。 - 在線程組里面,添加取樣器“HTTP請求”組件:
選中“線程組”右鍵 —> 添加 —> 取樣器 —> HTTP請求
。 - 在取樣器下,添加斷言“BeanShell斷言”組件:
選中“取樣器”右鍵 —> 添加 —> 斷言 —> BeanShell斷言
。 - 在取樣器下,添加監聽器“斷言結果”組件:
選中“取樣器”右鍵 —> 添加 —> 監聽器 —> 斷言結果
。 - 在線程組里面,添加監聽器“察看結果樹”組件:查看結果,
選中“線程組”右鍵 —> 添加 —> 監聽器 —> 察看結果樹
。
最終測試計划中的元件如下:
點擊運行按鈕,會提示你先保存該腳本,腳本保存完成后會直接自動運行該腳本。
(2)登陸接口請求界面內容
標准的Post請求,填寫請求的基本信息和參數即可。
編寫內容如下:
(3)BeanShell斷言界面內容
我把只要把自己編寫的BeanShell代碼,復制到Script (see below for variables that are defined)
下的輸入框即可。
如果需要進行模擬壓力測試的時候,可以勾選上Reset bsh.Interpreter before each call
選項。我們這里不用。
編輯好的界面,如下圖所示:
說明:
1)狀態碼斷言代碼:
//狀態碼斷言
log.info("狀態碼:" + ResponseCode);
if(ResponseCode.equals("200")){
Failure=false; // 表示斷言成功
}
else{
Failure=true; // 表示斷言失敗
FailureMessage="響應狀態碼非200"; // 自定義的失敗信息
}
注:字符串只能使用雙引號,字符串相等要使用
" ".equals(" ")
表達式。
2)響應體包含特定內容斷言代碼:
//獲取響應數據
String response = prev.getResponseDataAsString();
log.info("響應體:" + response);
//響應數據包含
if(response.contains("登錄成功")){
Failure=false; // 表示斷言成功
}
else{
Failure=true; // 表示斷言失敗
FailureMessage="響應數據不包含登錄成功";
}
(4)查看運行結果
我們在察看結果樹組件中,觀察腳本運行之后的結果。
如果斷言正確,和正常發送請求一樣,如下圖:
如果斷言失敗,則會出現斷言失敗的提示,如下圖所示:
(5)斷言結果組件說明
也添加斷言結果監聽器,通過斷言結果組件來判斷斷言是否通過。
如下圖所示:
說明:
- 已通過的斷言僅顯示取樣器名稱。
- 未通過的,除了顯示取樣器的名稱,還顯示錯誤原因。
5、補充知識點
(1)JSON響應體字段提取及斷言
將String類型的響應體轉為JSON對象並操作需要額外的JAR包,可以使用org.json.jar
或gson.jar
。
以json.jar
為例,下載后將其放入JMeter/lib
目錄下,重啟JMeter,添加BeanShell斷言代碼,如下:
//JSON響應斷言
import org.json.*; //導入org.json包
String response = prev.getResponseDataAsString(); //獲取響應數據
JSONObject responseJson = new JSONObject(response); //轉為JSON對象
String message = responseJson.getString("message");
log.info("響應message字段:" + message);
if(message.equals("成功")){
Failure=false;
}
else{
Failure=true;
FailureMessage="響應message字段非成功";
}
JSONObject對象除了getString()
方法外,還支持:
getBoolean("字段名")
:獲取布爾類型字段值。getInt("字段名")
:獲取整型字段值。getLong("字段名")
:獲取長整型字段值。getDouble("字段名")
:獲取雙精型字段值。getJSONObject("字段名")
:獲取嵌套Object類型字段值,JSONObject類型。getJSONArray("字段名")
:獲取嵌套Array類型,JSONArray類型。
(2)響應頭解析
響應頭原本為String類型,可以通過分割遍歷組裝成Map類型來提取響應頭中的項
Copyimport java.util.HashMap;
import java.util.Map;
//將字符串用換行符 截取為adc數組
String [] headersList = ResponseHeaders.split("\n");
Map headersMap = new HashMap(); //創建HashMap來從新組裝headers
for(int i=1;i<headersList.length;i++){
String [] itemList=headersList[i].split(": "); // 將每一條Headerr項按冒號分割
headersMap.put((itemList[0]), itemList[1]); // 分鍵值放入HashMap
}
String contentType = headersMap.get("Content-Type"); // 提取相應項
log.info("響應Content-Type:" + contentType)