一、使用jmeter函數助手
啟動jmeter后,可以在JMeter的選項菜單中找到函數助手對話框(快捷鍵:Ctrl+Shift+F1),如下圖所示:
打開函數助手,可以從下拉列表中選擇一個函數,并為其參數設定值,不同函數要求的參數也不同;表格的左邊一列是函數參數的簡要描述,右邊一列是供用戶填充參數的值。
二、常用JMeter函數
1、__regexFunction
正則表達式函數可以使用正則表達式(用戶提供的)來解析前面的服務器響應(或者是某個變量值),函數會返回一個有模板的字符串,其中攜帶有可變的值。
__regexFunction還可以被用來保存值,以便供后續使用。
在函數的第6個參數中,可以指定一個引用名;在函數執行以后,可以使用用戶定義值的語法來獲取同樣的值。例如,如果輸入"refName"作為第6個參數,那么可以使用:
${refName}來引用第2個參數(Template for the replacement string)的計算結果,這依賴于函數的解析結果;
${refName_g0}來引用函數解析后發現的所有匹配結果;
${refName_g1}來引用函數解析后發現的第一個匹配組合;
${refName_g#}來引用函數解析后發現的第n個匹配組合;
${refName_matchNr}來引用函數總共發現的匹配組合數目;
參數如下表所示:
函數參數描述是否必需
第1個參數第1個參數是用于解析服務器響應數據的正則表達式,它會找到所有匹配項;如果希望將表達式中的
某部分應用在模板字符串中,一定記得為其加上圓括號。例如,<a href="(.*)">,這樣就會將鏈
接的值存放到第一個匹配組合中(這里只有一個匹配組合)。又如,<input type="hidden"
name="(.*)"value="(.*)">,在這個例子中,鏈接的name作為第一個匹配組合,鏈接的value會
作為第二個匹配組合,這些組合可以用在測試人員的模板字符串中。
是
第2個參數這是一個模板字符串,函數會動態填寫字符串的部分內容。要在字符串中引用正則表達式捕獲的匹配組
合,請使用語法:[groupnumber][groupnumber]。例如11或者22,模板可以是任何字符串。
是
第3個參數第3個參數告訴JMeter使用第幾次匹配;測試人員的正則表達式可能會找到多個匹配項,對此,
有4種選擇:
n ? ? 整數,直接告訴JMeter使用第幾個匹配項;
n ? ? “1”對應第一個匹配,“2”對應第二個匹配,以此類推;
n ? ? RAND,告訴JMeter隨機選擇一個匹配項;
n ? ? ALL,告訴JMeter使用所有匹配項,為每個匹配項創建一個模板字符串,并將它們連接在一起
n ? ??浮點值0到1之間,根據公式(找到的總匹配數目*指定浮點值)計算使用第幾個匹配項,計算值
? ? ? 向最近的整數取整
否,默認值為1
第4個參數如果在上一個參數中選擇了“ALL”,那么這第4個參數會被插入到重復的模板值之間否
第5個參數如果沒有找到匹配項返回的默認值否
第6個參數重用函數解析值的引用名,參見上面內容否
第7個參數輸入變量名稱。如果指定了這一參數,那么該變量的值就會作為函數的輸入,而不再使用前面的采樣結
果作為搜索對象
否
2、__counter
每次調用計數器函數都會產生一個新值,從1開始每次加1。計數器既可以被配置成針對每個虛擬用戶是獨立的,也可以被配置成所有虛擬用戶公用的。如果每個虛擬用戶的計數器
是獨立增長的,那么通常被用于記錄測試計劃運行了多少遍。全局計數器通常被用于記錄發送了多少次請求,計數器使用一個整數值來記錄,允許的最大值為2,147,483,647。
目前計數器函數實例是獨立實現的(JMeter 2.1.1及其以前版本,使用一個固定的線程變量來跟蹤每個用戶的計數器,因此多個計數器函數會操作同一個值)。
全局計數器(FALSE)每個計數器實例都是獨立維護的。
參數如下表所示: ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?
函數參數描述是否必需
第1個參數True,如果希望每個虛擬用戶的計數器保持獨立,與其他用戶的計數器相區別;
false,全局計數器;
是
第2個參數重用計數器函數創建值的引用名。可以這樣引用計數器的值:${refName}。這樣一來,就可以創建一個
計數器后,在多個地方引用它的值(JMeter?2.1.1及其以前版本,這個參數是必需的)
否
3、__threadNum
函數__threadNum只是簡單地返回當前線程的編號。線程編號不依賴于線程組,這就意味著從函數的角度看來,某個線程組的線程#1和另一個線程組的線程#1是沒有區別的。
另外,該函數沒有參數。這一函數不能用在任何配置元件中(如用戶定義的變量),原因在于配置元件是由一個獨立線程運行的。另外在測試計劃中使用也是沒有意義的。
4)__intSum
函數__intSum可以被用來計算兩個或者更多整數值的合。
參數如下表所示:
函數參數描述是否必需
第1個參數第1個整數值是
第2個參數第2個整數值是
第n個參數第n個整數值否
最后一個參數重用函數計算值的引用名。如果用戶指定了這一參數,那么引用名中必須包含一個非數字字母,否則它會被當成另
一個整數值,而被函數用于計算
否
JMeter 2.3.1及其以前版本,要求必須有引用名參數。后續JMeter版本中,引用名是可選的參數,但是引用名不能是整數值。
5、__longSum
函數__ longSum可以被用來計算兩個或者更多長整型值的合。
參數如下表所示:
函數參數描述是否必需
第1個參數第1個長整型值是
第2個參數第2個長整型值是
第n個參數第n個長整型值否
最后一個參數重用函數計算值的引用名。如果用戶指定了這一參數,那么引用名中必須包含一個非數字字母,否則它會被當成
另一個長整型值,而被函數用于計算
否
6、__StringFromFile
__StringFromFile可以被用來從文本文件中讀取字符串,這對需要大量可變數據的測試很有用。例如,當測試一個銀行系統時,測試人員可能需要100條甚至1000條賬戶信息。
使用配置元件CSV Data Set Config ,也能達到相同的目的,而且方法更簡單,但是該配置元件目前不支持多輸入文件。
每次調用函數,都會從文件中讀取下一行。當到達文件末尾時,函數又會從文件開始處重新讀取,直到最大循環次數。如果在一個測試腳本中對該函數有多次引用,那么每一次引用
都會獨立打開文件,即使文件名是相同的(如果函數讀取的值,在腳本其他地方也有使用,那么就需要為每一次函數調用指定不同的變量名)。
如果在打開或者讀取文件時發生錯誤,那么函數就會返回字符串"**ERR**"。
參數如下表所示:
函數參數描述是否必需
文件名文件名(可以使用相對于JMeter啟動目錄的相對路徑)。如果要在文件名中使用可選的序列號,那么文件名
必須適合轉成十進制格式。參考下面的例子
是
變量名一個引用名(refName)的目的是復用這一函數創建的值。可以使用語法${refName}來引用函數創建的
值。默認值為“StringFromFile_”
否
初始序列號初始序列號(如果省略這一參數,終止序列號會作為一個循環計數器)否
終止序列號終止序列號(如果省略這一參數,序列號會一直增加下去,不會受到限制)否
當打開或者重新打開文件時,文件名參數將會被解析;每次執行函數時,引用名參數(如果支持)將會被解析。
使用序列號:當使用可選的序列號時,文件名需要使用格式字符串Java.text.DecimalFormat;當前的序列號會作為唯一的參數,如果不指明可選的初始序列號,
就使用文件名作為起始值。一些有用的格式序列如下:
#:插入數字,不從零開始,不包含空格。
000:插入數字,包含3個數字組合,不從零開始。
例如:
①pin#'.'dat?->?pin1.dat,?...?pin9.dat,?pin10.dat,?...?pin9999.dat ??
②pin000'.'dat?->?pin001.dat?...?pin099.dat?...?pin999.dat?...?pin9999.dat ??
③pin'.'dat#?->?pin.dat1,?...?pin.dat9?...?pin.dat999 ?
如果不希望某個格式字符被翻譯,測試人員需要為它加上單引號;注意"."是格式字符,必須被單引號所包含。
如果省略了初始序列號,而終止序列號參數將會作為循環計數器,文件將會被使用指定的次數。例如:
${_StringFromFile(PIN#'.'DAT,,1,2)}:讀取 PIN1.DAT, PIN2.DAT。
${_StringFromFile(PIN.DAT,,,2)}:讀取 PIN.DAT 兩次。
7、__machineName
函數__machineName返回本機的主機名。
參數如下表所示:
函數參數描述是否必需
變量名重用函數計算值的引用名否
8、__javaScript
函數__javaScript可以用來執行JavaScript代碼片段(非Java),并返回結果值。JMeter的_javaScript函數會調用標準的JavaScript解釋器;
JavaScript會作為腳本語言使用,因此測試人員可以做相應的計算;在腳本中可以訪問如下一些變量:
Log:該函數的日志記錄器;
Ctx:JmeterContext對象;
Vars:JmeterVariables對象;
threadName:字符串包含當前線程名稱 (在2.3.2 版本中它被誤寫為"theadName");
sampler:當前采樣器對象(如果存在);
sampleResult:前面的采樣結果對象(如果存在);
props:JMeter屬性對象;
Rhinoscript允許通過它的包對象來訪問靜態方法;例如,用戶可以使用如下方法訪問JMeterContextService靜態方法:
Packages.org.apache.jmeter.threads.JMeterContextService.getTotalThreads()
JMeter不是一款瀏覽器,它不會執行從頁面下載的JavaScript;
參數如下表所示:
函數參數描述是否必需
JavaScript代碼片段待執行的JavaScript代碼片段;例如:
n ? new Date():返回當前日期和時間
n ? Math.floor(Math.random()*(${maxRandom}+1)):在0和變量maxRandom之間的隨機數
n ? ${minRandom}+Math.floor(Math.random()*(maxRandom?maxRandom?{minRandom}+1)):
n ? 在變量?minRandom和maxRandom之間的隨機數
n ? "${VAR}"=="abcd"
是
變量名重用函數計算值的引用名否
請記得為文本字符串添加必要的引號。另外,如果表達式中有逗號,請確保對其轉義。例如,{__javaScript('{__javaScript('{sp}'.slice(7\,99999))},對7之后的逗號進行了轉義。
9、__Random
函數__Random會返回指定最大值和最小值之間的隨機數。
參數如下表所示:
函數參數描述是否必需
最小值最小數值是
最大值最大數值是
變量名重用函數計算值的引用名否
10、__CSVRead
函數__CSVRead會從CSV文件讀取一個字符串(請注意與StringFromFile 的區別)。
JMeter 1.9.1以前的版本僅支持從單個文件中讀取,JMeter 1.9.1及其以后版本支持從多個文件中讀取。在大多數情況下,新配置元件CSV Data Set更好用一些。
當對某文件進行第一次讀取時,文件將被打開并讀取到一個內部數組中;如果在讀取過程中找到了空行,函數就認為到達文件末尾了,即允許拖尾注釋(JMeter 1.9.1版本引入);
后續所有對同一個文件名的引用,都使用相同的內部數組。另外,文件名大小寫對函數調用很重要,哪怕操作系統不區分大小寫,CSVRead(abc.txt,0)和CSVRead(aBc.txt,0)
會引用不同的內部數組;使用*ALIAS特性可以多次打開同一個文件,另外還能縮減文件名稱。
每一個線程都有獨立的內部指針指向文件數組中的當前行;當某個線程第一次引用文件時,函數會為線程在數組中分配下一個空閑行。如此一來,任何一個線程訪問的文件行,
都與其他線程不同(除非線程數大于數組包含的行數)。
默認下,函數會在遇到每一個逗號處斷行;如果希望在輸入列中使用逗號,那么需要換一個分隔符(設置屬性csvread.delimiter實現),且該符號沒有在CSV文件任何列中出現。
參數如下表所示:
函數參數描述是否必需
文件名設置從哪個文件讀取(或者*ALIAS)是
列數從文件的哪一列讀取。0=第一列,?1=第二列,依此類推。“next”為走到文件的下一行。*ALIAS為打開
一個文件,并給它分配一個別名
是
例如,可以用如下參數來設置某些變量:
①COL1a?${__CSVRead(random.txt,0)} ??
②COL2a{__CSVRead(random.txt,1)}{__CSVRead(random.txt,1)}{__CSVRead(random.txt,next)}
③COL1b?${__CSVRead(random.txt,0)} ??
④COL2b{__CSVRead(random.txt,1)}{__CSVRead(random.txt,1)}{__CSVRead(random.txt,next)}
上面例子會從一行中讀取兩列,接著從下一行中讀取兩列。如果所有變量都在同一個前置處理器中(用戶參數上定義),那么行都是順序讀取的。否則,不同線程可能會讀取不同的行。
這一函數并不適合于讀取很大的文件,因為整個文件都會被存儲到內存之中。對于較大的文件,請使用配置元件CSV Data Set或者StringFromFile 。
11、__property
函數__property會返回一個JMeter屬性的值。如果函數找不到屬性值,而又沒有提供默認值,則它會返回屬性的名稱。
例如:
${__property(user.dir)}:返回屬性user.dir的值;
${__property(user.dir,UDIR)}:返回屬性user.dir的值,并保存在變量UDIR中;
${__property(abcd,ABCD,atod)}:返回屬性abcd的值 (如果屬性沒有定義,返回"atod"),并保存在變量ABCD 中;
${__property(abcd,,atod)}:返回屬性abcd 的值(如果屬性沒有定義,返回"atod"),但是并不保存函數的返回值;
參數如下表所示:
函數參數描述是否必需
屬性名獲取屬性值、所需的屬性名是
變量名重用函數計算值的引用名否
默認值屬性未定義時的默認值否
12、_P
函數_P是一個簡化版的屬性函數,目的是使用在命令行中定義的屬性。不同于函數_property,本函數沒有提供選項用于設置保存屬性值的變量。
另外,如果沒有設置默認值,默認值自動設為1。之所以選擇1,原因在于它對于很多常見測試變量都是一個合理值,例如,循環次數、線程數、啟動線程耗時間等。
例如:定義屬性值:
jmeter -Jgroup1.threads=7 -Jhostname1=www.realhost.edu
獲取值如下:
${__P(group1.threads)}:返回屬性group1.threads的值;
${__P(group1.loops)}:返回屬性group1.loops 的值;
${__P(hostname,www.dummy.org)}:返回屬性hostname的值,如果沒有定義該屬性則返回值www.dummy.org;
在上面的例子中,第一個函數調用返回7,第二個函數調用返回1,而最后一個函數調用返回www.dummy.org(除非這些屬性在其他地方有定義);
參數如下表所示:
函數參數描述是否必需
屬性名獲取屬性值、所需的屬性名是
默認值屬性未定義時的默認值。如果省略此參數,默認值自動設為1否
13、__log
函數__log會記錄一條日志,并返回函數的輸入字符串。
參數如下表所示:
函數參數描述是否必需
待記錄字符串一個字符串是
日志級別OUT、ERR、DEBUG、INFO(默認)、WARN或者ERROR否
可拋棄的文本如果非空,會創建一個可拋棄的文本傳遞給記錄器否
注釋如果存在,注釋會在字符串中展示,用于標識日志記錄了什么否
OUT 和ERR的日志級別,將會分別導致輸出記錄到System.out和System.err中。在這種情況下,輸出總是會被打印(它不依賴于當前的日志設置)。
例如:
${__log(Message)}:寫入日志文件,形如"...thread Name : Message";
${__log(Message,OUT)}:寫到控制臺窗口;
{__log({__log({VAR},,,VAR=)}:寫入日志文件,形如"...thread Name VAR=value";
14、__logn
函數__logn會記錄一條日志,并返回空字符串。
參數如下表所示:
函數參數描述是否必需
待記錄字符串一個字符串是
日志級別OUT,ERR,DEBUG,?INFO(默認),WARN?或者ERROR否
可拋棄的文本如果非空,會創建一個可拋棄的文本傳遞給記錄器否
OUT和ERR的日志級別,將會分別導致輸出記錄到System.out和System.err中。在這種情況下,輸出總是會被打印(它不依賴于當前的日志設置)。
例如:{__logn(VAR1={__logn(VAR1={VAR1},OUT)}:將變量值寫到控制臺窗口中。
15、__BeanShell
函數__BeanShell會執行傳遞給它的腳本,并返回結果。關于BeanShell的詳細資料,請參考BeanShell的Web站點:http://www.beanshell.org/。
需要注意,測試腳本中每一個獨立出現的函數調用,都會使用不同的解釋器,但是后續對函數調用的援引會使用相同的解釋器;這就意味著變量會持續存在,并跨越函數調用。
單個函數實例可以從多個線程調用。另外,該函數的execute()方法是同步的。如果定義了屬性"beanshell.function.init",那么它會作為一個源文件傳遞給解釋器。
這樣就可以定義一些通用方法和變量。在bin目錄中有一個初始化文件的例子:BeanShellFunction.bshrc。
如下變量在腳本執行前就已經設置:
log:函數BeanShell(*)的記錄器;
ctx:目前的JMeter Context變量;
vars:目前的JMeter變量;
props:JMeter屬性對象;
threadName:線程名(字符串);
sampler:當前采樣器(如果存在);
sampleResult:當前采樣器(如果存在);
"*"意味著該變量在JMeter使用初始化文件之前就已經設置了。其他變量在不同調用之間可能會發生變化;
參數如下表所示:
函數參數描述是否必需
BeanShell腳本一個BeanShell腳本(不是文件名)是
變量名重用函數計算值的引用名否
例如:
${__BeanShell(123*456)}:回56088;
${__BeanShell(source("function.bsh"))}:行在function.bsh中的腳本;
請記得為文本字符串及代表文本字符串的JMeter變量添加必要的引號;
16、__plit
函數__split會通過分隔符來拆分傳遞給它的字符串,并返回原始的字符串。如果分隔符緊挨在一起,那么函數就會以變量值的形式返回"?"。
拆分出來的字符串,以變量${VAR_1}、{VAR_2}…以此類推的形式加以返回。JMeter 2.1.2及其以后版本,拖尾的分隔符會被認為缺少一個變量,會返回"?"。
另外,為了更好地配合ForEach控制器,現在__split會刪除第一個不用的變量(由前一次分隔符所設置)。
在測試計劃中定義變量VAR="a||c|":{__split({__split({VAR},VAR),|} ,該函數調用會返回VAR變量的值,例如"a||c|",并設定VAR_n=4(3 ,JMeter 2.1.1及以前版本)、
VAR_1=a、VAR_2=?、VAR_3=c、VAR_4=?(null,JMeter 2.1.1及其以前版本)、VAR_5=null(JMeter 2.1.2及其以后版本)變量的值。
參數如下表所示:
函數參數描述是否必需
待拆分字符串一個待拆分字符串,例如“a|b|c”是
變量名重用函數計算值的引用名否
分隔符分隔符,例如“|”。如果省略了此參數,函數會使用逗號做分隔符。需要注意的是,假如
要多此一舉,明確指定使用逗號,需要對逗號轉義,如“\,”
否
17、__XPath
函數__XPath讀取XML文件,并在文件中尋找與指定XPath相匹配的地方。每調用函數一次,就會返回下一個匹配項。到達文件末尾后,會從頭開始。
如果沒有匹配的節點,那么函數會返回空字符串,另外,還會向JMeter日志文件寫一條警告信息;整個節點列表都會被保存在內存之中。
例如:
${__XPath(/path/to/build.xml,?//target/@name)}?
這會找到build.xml文件中的所有目標節點,并返回下一個name屬性的內容。
參數如下表所示:
函數參數描述是否必需
XML文件名一個待解析的XML文件名是
XPath一個XPath表達式,用于在XML文件中尋找目標節點是
18、__setProperty
函數__setProperty用于設置JMeter屬性的值。函數的默認返回值是空字符串,因此該函數可以被用在任何地方,只要對函數本身調用是正確的。
通過將函數可選的第3個參數設置為"true",函數就會返回屬性的原始值。屬性對于JMeter是全局的,因此可以被用來在線程和線程組之間通信。
參數如下表所示:
函數參數描述是否必需
屬性名待設置屬性名是
屬性值屬性的值是
True/False是否返回屬性原始值否
19、__time
函數__time可以通過多種格式返回當前時間。
參數如下表所示:
函數參數描述是否必需
格式設置時間所采用的格式否
變量名待設置變量名否
如果省略了格式字符串,那么函數會以毫秒的形式返回當前時間。其他情況下,當前時間會被轉成簡單日期格式。包含如下形式:
YMD = yyyyMMdd;
HMS = HHmmss;
YMDHMS = yyyyMMdd-HHmmss;
USER1 = JMeter屬性time.USER1;
USER2 = JMeter屬性time.USER2;
用戶可以通過修改JMeter屬性來改變默認格式,例如:time.YMD=yyMMdd。
20、_jexl
函數_jexl可以用于執行通用JEXL表達式,并返回執行結果。感興趣的讀者可以從下面這兩個網頁鏈接獲取更多關于JEXL的信息。
http://commons.apache.org/jexl/reference/syntax.html。
http://commons.apache.org/jexl/reference/examples.html#Example_Expressions。
參數如下表所示:
函數參數描述是否必需
表達式待執行的表達式。例如,6*(5+2)是
變量名待設置變量名否
如下變量可以通過腳本進行訪問:
log:函數記錄器;
ctx:JMeterContext對象;
vars:JMeterVariables對象;
props:JMeter屬性對象;
threadName:字符串包含當前線程名稱 (在2.3.2 版本中它被誤寫為"theadName");
sampler:當前的采樣器對象(如果存在);
sampleResult:前面的采樣結果對象(如果存在);
OUT - System.out,例如 OUT.println("message");
JEXL可以基于它們來創建類,或者調用方法,例如:
①Systemclass=log.class.forName("java.lang.System"); ?
②now=Systemclass.currentTimeMillis();?
需要注意的是,Web站點上的JEXL文檔錯誤地建議使用"div"做整數除法。事實上"div"和"/"都執行普通除法。
JMeter 2.3.2以后的版本允許在表達式中包含多個聲明。JMeter 2.3.2及其以前的版本只處理第一個聲明(如果存在多個聲明,就會記錄一條警告日志)。
21、__V
函數__V可以用于執行變量名表達式,并返回執行結果。它可以被用于執行嵌套函數引用(目前JMeter不支持)。
例如,如果存在變量A1、A2和N=1,則:
${A1}:能正常工作;
{A{A{N}}:無法正常工作(嵌套變量引用);
{__V(A${N})}:可以正常工作。A{__V(A${N})}:可以正常工作。A{N}變為A1,函數 __V返回變量值A1;
參數如下表所示:
函數參數描述是否必需
變量名表達式待執行變量名表達式是
22、__evalVar
函數__evalVar可以用來執行保存在變量中的表達式,并返回執行結果。
如此一來,用戶可以從文件中讀取一行字符串,并處理字符串中引用的變量。例如,假設變量"query"中包含有"select?columnfromcolumnfrom{table}",
而"column"和"table"中分別包含有"name"和"customers",那么${__evalVar(query)}將會執行"select name from customers"。
參數如下表所示:
函數參數描述是否必需
變量名待執行變量名是
23、__eval
函數__eval可以用來執行一個字符串表達式,并返回執行結果。如此一來,用戶就可以對字符串(存儲在變量中)中的變量和函數引用做出修改。
例如,給定變量name=Smith、column=age、table=birthdays、SQL=select?columnfromcolumnfrom{table} where name='${name}',
那么通過{__eval({__eval({SQL})},就能執行"select age from birthdays where name='Smith'"。這樣一來,就可以與CSV數據集相互配合;
例如:將SQL語句和值都定義在數據文件中。
參數如下表所示:
函數參數描述是否必需
變量名待執行變量是
24、__char
函數__char會將一串數字翻譯成Unicode字符,另外還請參考下面__unescape()函數。
參數如下表所示:
函數參數描述是否必需
Unicode字符編碼(十進制數或者十六進制數)待轉換的Unicode字符編碼,可以是十進制數或者十六進制數是
Unicode字符編碼(十進制數或者十六進制數)?待轉換的Unicode字符編碼,可以是十進制數或者十六進制數;
例如:
①${__char(0xC,0xA)}?=?CRLF ?
②${__char(165)}?=?????(yen) ?
25、__unescape
函數__unescape用于反轉義Java-escaped字符串,另外還請參考上面的__char函數。
參數如下表所示:
函數參數描述是否必需
待反轉義字符串待反轉義字符串是
例如:
①${__unescape(\r\n)}?=?CRLF ?
②${__unescape(1\t2)}?=?1[tab]2
26、__unescapeHtml
函數__unescapeHtml用于反轉義一個包含HTML實體的字符串,將其變為包含實際Unicode字符的字符串。支持HTML 4.0實體。
例如,字符串"<Français>"變為"<Fran?ais>"。
如果函數不認識某個實體,就會將實體保留下來,并一字不差地插入結果字符串中。例如,">&zzzz;x"會變為">&zzzz;x"。
參數如下表所示:
函數參數描述是否必需
待反轉義字符串待反轉義字符串是
27、__escapeHtml
函數__escapeHtml用于轉義字符串中的字符(使用HTML實體)。支持HTML 4.0實體。
例如,"bread" & "butter"變為"bread" & "butter"。
參數如下表所示:
函數參數描述是否必需
待轉義字符串待轉義字符串是
28、__FileToString
函數__FileToString可以被用來讀取整個文件。每次對該函數的調用,都會讀取整個文件。
如果在打開或者讀取文件時發生錯誤,那么函數就會返回字符串"**ERR**"。
參數如下表所示:
函數參數描述是否必需
文件名包含路徑的文件名(路徑可以是相對于JMeter啟動目錄的相對路徑)是
文件編碼方式(如果不采
用平臺默認的編碼方式)
讀取文件需要用到的文件編碼方式。如果沒有指明就使用平臺默認的編碼方式否
變量名引用名(refName)用于重用函數創建的值否
三、變量
1、預定義變量
大多數變量都是通過函數調用和測試元件(如用戶定義變量)來設置的;在這種情況下用戶擁有對變量名的完整控制權。但是有些變量是JMeter內置的。例如:
Cookiename:包含Cookie值。
JMeterThread.last_sample_ok:最近的采樣是否可以(true/false)。
2、預定義變量屬性
JMeter屬性集是在JMeter啟動時通過系統屬性初始化的;其他補充JMeter屬性來自于jmeter.properties、user.properties或者命令行。
JMeter還另外定義了一些內置屬性。下面是具體列表。從方便的角度考慮,屬性START的值會被復制到同名變量中去。
START.MS:以毫秒為單位的JMeter啟動時間;
START.YMD:JMeter啟動日期格式yyyyMMdd;
START.HMS:JMeter啟動時間格式HHmmss;
TESTSTART.MS:以毫秒為單位的測試啟動時間;
請注意:START變量/屬性表征的是JMeter啟動時間,而非測試的啟動時間。它們主要用于文件名之中。