JMeter36個內置函數及11個新增函數介紹
JMeter內置了36個函數,這些函數可以通過函數助手進行編輯和測試。了解這些函數,不僅能提高JMeter的使用熟練度,也有助於知曉測試工具或測試框架通用的函數有哪些,在自主設計時,作為參考借鑒。
JMeter函數調用的寫法是${__function()}
,注意函數名前面需要添加雙下劃線前綴。
__BeanShell
腳本語言
執行BeanShell腳本。BeanShell是Java編寫的Java源碼解釋器,小型、免費、可嵌入,可以像寫腳本語言一樣寫Java,無需編譯,立即運行。
示例,字元串拼接:
輸入表達式後,點擊Generate & Copy to clipboard
按鈕,會生成函數語法並複製到粘貼板,同時輸出函數運行結果。
__char
把數字轉化成Unicode字元。
示例,數字65轉化成字元A:
__counter
統計執行緒的迭代次數。它有兩個參數:
- 第一個參數,如果為true,那麼每個執行緒單獨統計;如果為false,那麼所有執行緒合在一起統計。
- 第二個參數,變數名。
示例:
__CSVRead
從CSV文件中讀取數據。
固定取值
始終取第n列第一行的值。
示例:
動態取值
使用next每次迭代取下一行數據。注意必須先取列,再取行。
示例:
文件別名
給文件名起個別名。
示例:
__escapeHtml
HTML轉義。
示例:
__escapeOroRegrexChars
把一些Java正則表達式引擎不識別的正則表達式轉換一下,這樣就可以識別了。轉換過程中使用了ORO正則表達式庫。
示例:
__eval
計算表達式。
示例:
__evalVar
把表達式的結果存入變數。
示例:
__FileToString
讀取文件全部內容,以字元串形式保存到變數中。
示例:
__intSum
int型求和。
示例:
__longSum
跟上個一樣,只是換成了long型。
__javaScript
執行JavaScript腳本。
示例:
__jexl
JEXL全稱是Jakarta Commons Jexl,它是一種表達式語言解釋器。jexl能直接訪問JMeter中的部分變數:
- log:直接調用logger函數
- ctx:獲取JMeterContent對象
- vars:獲取JMeter定義的變數
- props:獲取JMeter配置屬性
- threadName:獲取JMeter執行緒名
- sampler:獲取Sampler實例
- sampleResult:獲取SamplerResult實例
- OUT:OUT.println(),類似System.out.println
示例:
__log
記錄日誌,並返回輸入的字元串。
日誌級別包括:
控制台指JMeter GUI的感嘆號打開的控制台;標準輸出窗口指打開JMeter時的CMD窗口。
- OUT:列印到控制台和標準輸出窗口,相當於System.out.print()
- ERR:列印到控制台和標準輸出窗口,相當於System.err
- DEBUG:列印到控制台,DEBUG級別以上
- INFO:列印到控制台,INFO及ERROR級別
- WARN:列印到控制台,WARN、INFO、ERROR級別
- ERROR:列印到控制台,僅ERROR級別
後四種級別DEBUG、INFO、WARN、ERROR是否寫入JMeter的運行時日誌,需要通過jmeter.property文件進行配置。
示例:
__logn
與上一個類似,區別是它只記錄日誌,不返回值。
__machineIP
本機的IP。
__machineName
本機的電腦名。
__P
獲取命令行中定義的屬性,默認值為1。
示例:
在非GUI方式運行測試計劃時,可以用這個函數來做參數化,由運行命令動態指定參數值,方便跟Jenkins、Maven或者Ant集成。
__property
獲取jmeter.properties文件中設置的JMeter屬性。
示例:
__Random
隨機值。
示例:
__RandomString
隨機字元串。
示例:
__regexFunction
跟後置處理器的正則表達式提取器用法一樣。
示例:
__samplerName
獲取當前sampler名稱。
__setProperty
動態設置JMeter屬性。
示例:
__split
拆分字元串。
__StringFromFile
不如使用CSV Data Set Config。
__TestPlanName
獲取測試計劃的名字。
__threadNum
返回當前執行緒號,從1開始遞增。
示例:
__time
返回當前時間,由SimpleDateFormat類來處理函數格式。
- 年:yyyy
- 月:MM
- 日:dd
- 時:hh
- 分:mm
- 秒:ss
示例:
__unescape
返轉escape字元,如\r\n
轉成CRLF。
__unescapeHtml
反轉HTML,如
轉成空格。
__urldecode
反轉URL中的Unicode編碼字元,如word%22school%22
轉成word"school"
。
__urlencode
轉成Unicode編碼字元,如word"school"
轉成word%22school%22
。
__UUID
生成唯一字元串。
__V
執行變數表達式並返回結果,如果需要嵌套的使用變數時,就可以用到它。
比如定義變數a1=2, b1=1
,${a1}``${b1}
都可以調用成功。
但是如果想通過${a${b1}}
來調用${a1}
就不能成功。
使用${__V(a${b1})}
等價於${__V(a1)}
等價於${a1}
就可以了。
__XPath
匹配XML文件內容。
示例:
<?xml version="1.0" encoding="utf-8"?>
<company>
<name>
<address>
shanghai
</address>
</name>
</company>
XPath表達式/company/name/address/text()
取值shanghai。
XPath可以參考//www.w3school.com.cn/xpath/index.asp
最近新增
除了上述36個內置函數,JMeter最近還新增了以下函數:
changeCase
改變大小寫
dateTimeConvert
日期格式轉換
digest
加密演算法,如SHA-1, SHA-256, MD5等
escapeXml
轉義XML
groovy
groovy表達式
isPropDefined
屬性是否定義
isVarDefined
變數是否定義
RandomDate
隨機日期
RandomFromMultipleVars
從多個變數中取隨機值
StringToFile
把字元串寫入文件中
timeShift
時間偏移,比如計算某一天的前三天
小結
本文對36個內置函數,以及11個新增函數進行了介紹,靈活選擇使用這些函數,能起到事半功倍的效果。函數助手可以很方便的對函數進行預覽和測試。最新最全的函數及其使用介紹可以到官網查閱://jmeter.apache.org/usermanual/functions.html
參考資料:
《全棧性能測試修鍊寶典JMeter實戰》