Jmeter（十一）函数助手

﹏ヽ暗。殇╰゛Y 2021-12-16 03:55 294阅读 0赞

可以在JMeter的选项菜单中找到函数助手对话框

![1407275-20190225195859870-422896589.png][]

我们可以从下拉列表中选择一个函数，并为其参数设定值。如图，表格的左边一列是函数参数的简要描述，右边一列是供用户填充参数的值。不同函数要求的参数也不同。

当完成以上设置后，单击"生成"按钮，函数助手会[生成函数][Link 1]调用所需的字符串，我们所要做的只是将它复制-粘贴到测试计划中去。

### 常用JMeter函数 ###

**1、\_\_regexFunction**

![983980-20170504003649820-174663599.png][]

正则表达式函数可以使用正则表达式（用户提供的）来解析前面的服务器响应（或者是某个变量值），函数会返回一个有模板的字符串，其中携带有可变的值。

\_\_regexFunction还可以被用来保存值，以便供后续使用。

在函数的第6个参数中，可以指定一个引用名；在函数执行以后，可以使用用户定义值的语法来获取同样的值。例如，如果输入"refName"作为第6个参数，那么可以使用：

$\{refName\}来引用第2个参数（Template for the replacement string）的计算结果，这依赖于函数的解析结果；

$\{refName\_g0\}来引用函数解析后发现的所有匹配结果；

$\{refName\_g1\}来引用函数解析后发现的第一个匹配组合；

$\{refName\_g\#\}来引用函数解析后发现的第n个匹配组合；

$\{refName\_matchNr\}来引用函数总共发现的匹配组合数目；

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td align="left"> 函数参数 </td> 
 <td align="left"> 描述 </td> 
 <td align="left"> 是否必需 </td> 
 </tr> 
 <tr> 
 <td align="left"> 第1个参数 </td> 
 <td align="left"> 第1个参数是用于解析服务器响应数据的正则表达式，它会找到所有匹配项；如果希望将表达式中的 某部分应用在模板字符串中，一定记得为其加上圆括号。例如，&lt;a href="(.*)"&gt;，这样就会将链 接的值存放到第一个匹配组合中（这里只有一个匹配组合）。又如，&lt;input type="hidden" name="(.*)"value="(.*)"&gt;，在这个例子中，链接的name作为第一个匹配组合，链接的value会 作为第二个匹配组合，这些组合可以用在测试人员的模板字符串中。 </td> 
 <td align="left"> 是 </td> 
 </tr> 
 <tr> 
 <td align="left"> 第2个参数 </td> 
 <td align="left"> 这是一个模板字符串，函数会动态填写字符串的部分内容。要在字符串中引用正则表达式捕获的匹配组 合，请使用语法：[groupnumber][groupnumber]。例如11或者&nbsp;22，模板可以是任何字符串。 </td> 
 <td align="left"> 是 </td> 
 </tr> 
 <tr> 
 <td align="left"> 第3个参数 </td> 
 <td align="left"> 第3个参数告诉JMeter使用第几次匹配；测试人员的正则表达式可能会找到多个匹配项，对此， 有4种选择： n &nbsp; &nbsp; 整数，直接告诉JMeter使用第几个匹配项； n &nbsp; &nbsp; “1”对应第一个匹配，“2”对应第二个匹配，以此类推； n &nbsp; &nbsp; RAND，告诉JMeter随机选择一个匹配项； n &nbsp; &nbsp; ALL，告诉JMeter使用所有匹配项，为每个匹配项创建一个模板字符串，并将它们连接在一起 n &nbsp; &nbsp;&nbsp;浮点值0到1之间，根据公式（找到的总匹配数目*指定浮点值）计算使用第几个匹配项，计算值 &nbsp; &nbsp; &nbsp; 向最近的整数取整 </td> 
 <td align="left"> 否，默认值为1 </td> 
 </tr> 
 <tr> 
 <td align="left"> 第4个参数 </td> 
 <td align="left"> 如果在上一个参数中选择了“ALL”，那么这第4个参数会被插入到重复的模板值之间 </td> 
 <td align="left"> 否 </td> 
 </tr> 
 <tr> 
 <td align="left"> 第5个参数 </td> 
 <td align="left"> 如果没有找到匹配项返回的默认值 </td> 
 <td align="left"> 否 </td> 
 </tr> 
 <tr> 
 <td align="left"> 第6个参数 </td> 
 <td align="left"> 重用函数解析值的引用名，参见上面内容 </td> 
 <td align="left"> 否 </td> 
 </tr> 
 <tr> 
 <td align="left"> 第7个参数 </td> 
 <td align="left"> 输入变量名称。如果指定了这一参数，那么该变量的值就会作为函数的输入，而不再使用前面的采样结 果作为搜索对象 </td> 
 <td align="left"> 否 </td> 
 </tr> 
 </tbody> 
</table>

**2、\_\_counter**

每次调用计数器函数都会产生一个新值，从1开始每次加1。计数器既可以被配置成针对每个虚拟用户是独立的，也可以被配置成所有虚拟用户公用的。如果每个虚拟用户的计数器

是独立增长的，那么通常被用于记录测试计划运行了多少遍。全局计数器通常被用于记录发送了多少次请求，计数器使用一个整数值来记录，允许的最大值为2,147,483,647。

目前计数器函数实例是独立实现的（JMeter 2.1.1及其以前版本，使用一个固定的线程变量来跟踪每个用户的计数器，因此多个计数器函数会操作同一个值）。

全局计数器（FALSE）每个计数器实例都是独立维护的。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 第1个参数 </td> 
 <td> True，如果希望每个虚拟用户的计数器保持独立，与其他用户的计数器相区别； false，全局计数器； </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 第2个参数 </td> 
 <td> 重用计数器函数创建值的引用名。可以这样引用计数器的值：${refName}。这样一来，就可以创建一个 计数器后，在多个地方引用它的值（JMeter&nbsp;2.1.1及其以前版本，这个参数是必需的） </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**3、\_\_threadNum**

函数\_\_threadNum只是简单地返回当前线程的编号。线程编号不依赖于线程组，这就意味着从函数的角度看来，某个线程组的线程\#1和另一个线程组的线程\#1是没有区别的。

另外，该函数没有参数。这一函数不能用在任何配置元件中（如用户定义的变量），原因在于配置元件是由一个独立线程运行的。另外在测试计划中使用也是没有意义的。

**4）\_\_intSum**

函数\_\_intSum可以被用来计算两个或者更多整数值的合。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 第1个参数 </td> 
 <td> 第1个整数值 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 第2个参数 </td> 
 <td> 第2个整数值 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 第n个参数 </td> 
 <td> 第n个整数值 </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 最后一个参数 </td> 
 <td> 重用函数计算值的引用名。如果用户指定了这一参数，那么引用名中必须包含一个非数字字母，否则它会被当成另 一个整数值，而被函数用于计算 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

JMeter 2.3.1及其以前版本，要求必须有引用名参数。后续JMeter版本中，引用名是可选的参数，但是引用名不能是整数值。

**5、\_\_longSum**

函数\_\_ longSum可以被用来计算两个或者更多长整型值的合。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 第1个参数 </td> 
 <td> 第1个长整型值 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 第2个参数 </td> 
 <td> 第2个长整型值 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 第n个参数 </td> 
 <td> 第n个长整型值 </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 最后一个参数 </td> 
 <td> 重用函数计算值的引用名。如果用户指定了这一参数，那么引用名中必须包含一个非数字字母，否则它会被当成 另一个长整型值，而被函数用于计算 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**6、\_\_StringFromFile**

\_\_StringFromFile可以被用来从文本文件中读取字符串，这对需要大量可变数据的测试很有用。例如，当测试一个银行系统时，测试人员可能需要100条甚至1000条账户信息。

使用配置元件CSV Data Set Config ，也能达到相同的目的，而且方法更简单，但是该配置元件目前不支持多输入文件。

每次调用函数，都会从文件中读取下一行。当到达文件末尾时，函数又会从文件开始处重新读取，直到最大循环次数。如果在一个测试脚本中对该函数有多次引用，那么每一次引用

都会独立打开文件，即使文件名是相同的（如果函数读取的值，在脚本其他地方也有使用，那么就需要为每一次函数调用指定不同的变量名）。

如果在打开或者读取文件时发生错误，那么函数就会返回字符串"\*\*ERR\*\*"。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 文件名 </td> 
 <td> 文件名（可以使用相对于JMeter启动目录的相对路径）。如果要在文件名中使用可选的序列号，那么文件名 必须适合转成十进制格式。参考下面的例子 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 一个引用名（refName）的目的是复用这一函数创建的值。可以使用语法${refName}来引用函数创建的 值。默认值为“StringFromFile_” </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 初始序列号 </td> 
 <td> 初始序列号（如果省略这一参数，终止序列号会作为一个循环计数器） </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 终止序列号 </td> 
 <td> 终止序列号（如果省略这一参数，序列号会一直增加下去，不会受到限制） </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

当打开或者重新打开文件时，文件名参数将会被解析；每次执行函数时，引用名参数（如果支持）将会被解析。

使用序列号：当使用可选的序列号时，文件名需要使用格式字符串[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返回本机的主机名。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 重用函数计算值的引用名 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**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;

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> JavaScript代码片段 </td> 
 <td> 待执行的JavaScript代码片段；例如： n &nbsp; new Date()：返回当前日期和时间 n &nbsp; Math.floor(Math.random()*(${maxRandom}+1))：在0和变量maxRandom之间的随机数 n &nbsp; ${minRandom}+Math.floor(Math.random()*(maxRandom−maxRandom−{minRandom}+1))： n &nbsp; 在变量&nbsp;minRandom和maxRandom之间的随机数 n &nbsp; "${VAR}"=="abcd" </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 重用函数计算值的引用名 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

请记得为文本字符串添加必要的引号。另外，如果表达式中有逗号，请确保对其转义。例如，\{\_\_javaScript('\{\_\_javaScript('\{sp\}'.slice(7\\,99999))\}，对7之后的逗号进行了转义。

**9、\_\_Random**

函数\_\_Random会返回指定最大值和最小值之间的随机数。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 最小值 </td> 
 <td> 最小数值 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 最大值 </td> 
 <td> 最大数值 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 重用函数计算值的引用名 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**10、\_\_CSVRead**

函数\_\_CSVRead会从CSV文件读取一个字符串（请注意与StringFromFile 的区别）。

JMeter 1.9.1以前的版本仅支持从单个文件中读取，JMeter 1.9.1及其以后版本支持从多个文件中读取。在大多数情况下，新配置元件CSV Data Set更好用一些。

当对某文件进行第一次读取时，文件将被打开并读取到一个内部数组中；如果在读取过程中找到了空行，函数就认为到达文件末尾了，即允许拖尾注释（JMeter 1.9.1版本引入）；

后续所有对同一个文件名的引用，都使用相同的内部数组。另外，文件名大小写对函数调用很重要，哪怕[操作系统][Link 2]不区分大小写，CSVRead(abc.txt,0)和CSVRead(aBc.txt,0)

会引用不同的内部数组；使用\*ALIAS特性可以多次打开同一个文件，另外还能缩减文件名称。

每一个线程都有独立的内部指针指向文件数组中的当前行；当某个线程第一次引用文件时，函数会为线程在数组中分配下一个空闲行。如此一来，任何一个线程访问的文件行，

都与其他线程不同（除非线程数大于数组包含的行数）。

默认下，函数会在遇到每一个逗号处断行；如果希望在输入列中使用逗号，那么需要换一个分隔符（设置属性csvread.delimiter实现），且该符号没有在CSV文件任何列中出现。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 文件名 </td> 
 <td> 设置从哪个文件读取（或者*ALIAS） </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 列数 </td> 
 <td> 从文件的哪一列读取。0=第一列，&nbsp;1=第二列，依此类推。“next”为走到文件的下一行。*ALIAS为打开 一个文件，并给它分配一个别名 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

例如，可以用如下参数来设置某些变量：

①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"），但是并不保存函数的返回值；

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 属性名 </td> 
 <td> 获取属性值、所需的属性名 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 重用函数计算值的引用名 </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 默认值 </td> 
 <td> 属性未定义时的默认值 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**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][]（除非这些属性在其他地方有定义）；

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 属性名 </td> 
 <td> 获取属性值、所需的属性名 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 默认值 </td> 
 <td> 属性未定义时的默认值。如果省略此参数，默认值自动设为1 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**13、\_\_log**

函数\_\_log会记录一条日志，并返回函数的输入字符串。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 待记录字符串 </td> 
 <td> 一个字符串 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 日志级别 </td> 
 <td> OUT、ERR、DEBUG、INFO（默认）、WARN或者ERROR </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 可抛弃的文本 </td> 
 <td> 如果非空，会创建一个可抛弃的文本传递给记录器 </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 注释 </td> 
 <td> 如果存在，注释会在字符串中展示，用于标识日志记录了什么 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

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会记录一条日志，并返回空字符串。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 待记录字符串 </td> 
 <td> 一个字符串 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 日志级别 </td> 
 <td> OUT，ERR，DEBUG，&nbsp;INFO（默认），WARN&nbsp;或者ERROR </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 可抛弃的文本 </td> 
 <td> 如果非空，会创建一个可抛弃的文本传递给记录器 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

OUT和ERR的日志级别，将会分别导致输出记录到System.out和System.err中。在这种情况下，输出总是会被打印（它不依赖于当前的日志设置）。

例如：\{\_\_logn(VAR1=\{\_\_logn(VAR1=\{VAR1\},OUT)\}：将变量值写到控制台窗口中。

**15、\_\_BeanShell**

函数\_\_BeanShell会执行传递给它的脚本，并返回结果。关于BeanShell的详细资料，请参考BeanShell的Web站点：[http://www.beanshell.org/][http_www.beanshell.org] 。

需要注意，测试脚本中每一个独立出现的函数调用，都会使用不同的解释器，但是后续对函数调用的援引会使用相同的解释器；这就意味着变量会持续存在，并跨越函数调用。

单个函数实例可以从多个线程调用。另外，该函数的execute()方法是同步的。如果定义了属性"beanshell.function.init"，那么它会作为一个源文件传递给解释器。

这样就可以定义一些通用方法和变量。在bin目录中有一个初始化文件的例子：BeanShellFunction.bshrc。

如下变量在脚本执行前就已经设置：

log：函数BeanShell(\*)的记录器；

ctx：目前的JMeter Context变量；

vars：目前的JMeter变量；

props：JMeter属性对象；

threadName：线程名（字符串）；

sampler：当前采样器（如果存在）；

sampleResult：当前采样器（如果存在）；

"\*"意味着该变量在JMeter使用初始化文件之前就已经设置了。其他变量在不同调用之间可能会发生变化；

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> BeanShell脚本 </td> 
 <td> 一个BeanShell脚本（不是文件名） </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 重用函数计算值的引用名 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

例如：

$\{\_\_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及其以后版本）变量的值。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 待拆分字符串 </td> 
 <td> 一个待拆分字符串，例如“a|b|c” </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 重用函数计算值的引用名 </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 分隔符 </td> 
 <td> 分隔符，例如“|”。如果省略了此参数，函数会使用逗号做分隔符。需要注意的是，假如 要多此一举，明确指定使用逗号，需要对逗号转义，如“\,” </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**17、\_\_XPath**

函数\_\_XPath读取XML文件，并在文件中寻找与指定XPath相匹配的地方。每调用函数一次，就会返回下一个匹配项。到达文件末尾后，会从头开始。

如果没有匹配的节点，那么函数会返回空字符串，另外，还会向JMeter日志文件写一条警告信息；整个节点列表都会被保存在内存之中。

例如：

$\{\_\_XPath(/path/to/build.xml, //target/@name)\}

这会找到build.xml文件中的所有目标节点，并返回下一个name属性的内容。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> XML文件名 </td> 
 <td> 一个待解析的XML文件名 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> XPath </td> 
 <td> 一个XPath表达式，用于在XML文件中寻找目标节点 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

**18、\_\_setProperty**

函数\_\_setProperty用于设置JMeter属性的值。函数的默认返回值是空字符串，因此该函数可以被用在任何地方，只要对函数本身调用是正确的。

通过将函数可选的第3个参数设置为"true"，函数就会返回属性的原始值。属性对于JMeter是全局的，因此可以被用来在线程和线程组之间通信。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 属性名 </td> 
 <td> 待设置属性名 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 属性值 </td> 
 <td> 属性的值 </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> True/False </td> 
 <td> 是否返回属性原始值 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

**19、\_\_time**

函数\_\_time可以通过多种格式返回当前时间。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 格式 </td> 
 <td> 设置时间所采用的格式 </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 待设置变量名 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

如果省略了格式字符串，那么函数会以毫秒的形式返回当前时间。其他情况下，当前时间会被转成简单日期格式。包含如下形式：

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_syntax.html]。

[http://commons.apache.org/jexl/reference/examples.html\#Example\_Expressions][http_commons.apache.org_jexl_reference_examples.html_Example_Expressions]。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 表达式 </td> 
 <td> 待执行的表达式。例如，6*(5+2) </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 待设置变量名 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

如下变量可以通过脚本进行访问：

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；

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 变量名表达式 </td> 
 <td> 待执行变量名表达式 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

**22、\_\_evalVar**

函数\_\_evalVar可以用来执行保存在变量中的表达式，并返回执行结果。

如此一来，用户可以从文件中读取一行字符串，并处理字符串中引用的变量。例如，假设变量"query"中包含有"select columnfromcolumnfrom\{table\}"，

而"column"和"table"中分别包含有"name"和"customers"，那么$\{\_\_evalVar(query)\}将会执行"select name from customers"。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 待执行变量名 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

**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语句和值都定义在数据文件中。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 待执行变量 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

**24、\_\_char**

函数\_\_char会将一串数字翻译成Unicode字符，另外还请参考下面\_\_unescape()函数。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> Unicode字符编码（十进制数或者十六进制数） </td> 
 <td> 待转换的Unicode字符编码，可以是十进制数或者十六进制数 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

Unicode字符编码（十进制数或者十六进制数） 待转换的Unicode字符编码，可以是十进制数或者十六进制数；

例如：

①$\{\_\_char(0xC,0xA)\} = CRLF

②$\{\_\_char(165)\} = ï¿½ (yen)

**25、\_\_unescape**

函数\_\_unescape用于反转义Java-escaped字符串，另外还请参考上面的\_\_char函数。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 待反转义字符串 </td> 
 <td> 待反转义字符串 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

例如：

①$\{\_\_unescape(\\r\\n)\} = CRLF

②$\{\_\_unescape(1\\t2)\} = 1\[tab\]2

**26、\_\_unescapeHtml**

函数\_\_unescapeHtml用于反转义一个包含HTML实体的字符串，将其变为包含实际Unicode字符的字符串。支持HTML 4.0实体。

例如，字符串"<Fran&ccedil;ais>"变为"<Fran?ais>"。

如果函数不认识某个实体，就会将实体保留下来，并一字不差地插入结果字符串中。例如，">&zzzz;x"会变为">&zzzz;x"。

参数如下表所示：

**27、\_\_escapeHtml**

函数\_\_escapeHtml用于转义字符串中的字符（使用HTML实体）。支持HTML 4.0实体。

例如，"bread" & "butter"变为"bread" & "butter"。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 待转义字符串 </td> 
 <td> 待转义字符串 </td> 
 <td> 是 </td> 
 </tr> 
 </tbody> 
</table>

**28、\_\_FileToString**

函数\_\_FileToString可以被用来读取整个文件。每次对该函数的调用，都会读取整个文件。

如果在打开或者读取文件时发生错误，那么函数就会返回字符串"\*\*ERR\*\*"。

参数如下表所示：

<table> 
 <tbody> 
 <tr> 
 <td> 函数参数 </td> 
 <td> 描述 </td> 
 <td> 是否必需 </td> 
 </tr> 
 <tr> 
 <td> 文件名 </td> 
 <td> 包含路径的文件名（路径可以是相对于JMeter启动目录的相对路径） </td> 
 <td> 是 </td> 
 </tr> 
 <tr> 
 <td> 文件编码方式（如果不采 用平台默认的编码方式） </td> 
 <td> 读取文件需要用到的文件编码方式。如果没有指明就使用平台默认的编码方式 </td> 
 <td> 否 </td> 
 </tr> 
 <tr> 
 <td> 变量名 </td> 
 <td> 引用名（refName）用于重用函数创建的值 </td> 
 <td> 否 </td> 
 </tr> 
 </tbody> 
</table>

转载于:https://www.cnblogs.com/eastonliu/p/10433029.html

[1407275-20190225195859870-422896589.png]: /images/20211214/0b823368dd4b42feb4703b6ca6ee5b74.png
[Link 1]: https://www.baidu.com/s?wd=%E7%94%9F%E6%88%90%E5%87%BD%E6%95%B0&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[983980-20170504003649820-174663599.png]: /images/20211214/c72078e5bf094921b79aff69e6973e9a.png
[Java]: http://lib.csdn.net/base/javase
[JavaScript]: http://lib.csdn.net/base/javascript
[Link 2]: http://lib.csdn.net/base/operatingsystem
[www.dummy.org]: http://www.dummy.org/
[http_www.beanshell.org]: http://www.beanshell.org/
[http_commons.apache.org_jexl_reference_syntax.html]: http://commons.apache.org/jexl/reference/syntax.html
[http_commons.apache.org_jexl_reference_examples.html_Example_Expressions]: http://commons.apache.org/jexl/reference/examples.html#Example_Expressions