七Jmeter 基础-常用内置函数

Posted 2021-03-16 easy-test

JMeter 的函数是一些特殊值，函数调用的语法如下：

${__functionName(var1,var2,var3)}

解释：
“_functionName” 匹配函数的名称，圆括号内为函数参数，如 ${time(YMD)}。无参数的函数可以不需要圆括号，如${_threadNum}。
如果参数包含逗号，那么一定要使用“”来转义，否则JMeter会把它当作一个参数分隔符
例如：
${__javascript(Math.max(2,5))}，“Math.max(2,5)”被当__javascript 函数的两个参数：`Math.max(2` 和 `5)`

Tips：一般我们可以打开函数库，填入参数后点击生成，自动转义

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

• YMD = yyyyMMdd。
• HMS = HHmmss。
• YMDHMS = yyyyMMdd-HHmmss。
• USER1 = JMeter属性time.USER1。
• USER2 = JMeter属性time.USER2。

默认值可以通过设置适当的 JMeter 属性来改变，例如 time.YMD=yyMMdd

__timeShift

• 第一个参数 :将显示创建日期的格式。如yyyy-MM-dd hh:mm:ss 返回2020-01-13 11:30:36
• 第二个参数：这是日期值。默认当前时间
• 第三个参数：移位 - 表示要从日期参数的值中添加或减去多少天，几小时或几分钟。如果该值未被传递，则不会将任何值减去或添加到日期参数的值中。

移位表达式如下所述：

• “PT20.345S”解析为“20.345秒”
• “PT15M”解析为“15分钟”
• “PT10H”解析为“10小时”
• “P2D”解析为“2天”
• “P2DT3H4M”解析为“2天，3小时和4分钟”
• “P-6H3M”解析为“-6小时+3分钟”
• “-P6H3M”解析为“-6小时-3分钟”
• “-P-6H + 3M”解析为“+6小时和-3分钟”

这个函数一般用来创建有开始时间和结束时间的时候特别好用，免去了自己写BeanShell的烦恼

__Random

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

例子：
${__Random(0,10)}，返回一个 0 到 10 之间的随机数

Tips：一般在新增的时候，固定字符串后加个随机数，避免重复

__split
split 函数根据分隔符拆分传递给它的字符串，并返回原始字符串。如果分隔符与分隔符是相邻的(例如,,)，分割后返回“？”作为值。拆分出来的字符串将返回到 ${VAR_1}，${VAR_2}…以此类推。变量的计数将返回到 ${VAR_n} 中（分割出来有3个值，VAR_n=3）
例子：
在测试计划中定义 VAR="a||c|"，${__split(${VAR},VAR,|)}
这将返回 VAR 的内容，即“a||c|”并设置以下变量：

• VAR_n=4
• VAR_1=a
• VAR_2=?
• VAR_3=c
• VAR_4=?
• VAR_5=null

__setProperty
setProperty 函数用来设置 JMeter 属性的值。函数的默认返回值是空字符串，因此在函数有效处都可以调用此函数。
可以通过设置第 3 个可选参数为“true”返回原始值。
属性对 JMeter 来说是全局的，所以可以用在线程和线程组之间的通信上。

__BeanShell

• 第一个参数：此处写要执行的BeanShell语句或者文件地址，必填
• 第二个参数：用于保存变量，非必填

用法举例：
1.${__BeanShell(100*100,)，结果是10000
2. ${__BeanShell(source("function.bsh"))} 在 function.bsh 中处理脚本，并返回结果

Tips：BeanShell函数和BeanShell元器件（BeanShell预处理程序，BeanShell后置处理程序，BeanShell 取样器）效果差不多，只不过多用于简单的语句处理

__base64Decode和__base64Encode

__base64Decode用于解密，__base64Encode用于加密（第六节有用到过）

• 第一个参数：被加密/解密的字符串
• 第二个参数：用于存储的变量名，不必填

Tips：多用于需要加密的情况，例如正好密码是base64

__counter

• 每次调用计数器函数都会产生一个新值，从1开始每次加1
• 第一个参数设置为TRUE,针对每个虚拟用户是独立的,反之所有虚拟用户公用的
• 计数器使用一个整数值来记录，允许的最大值为2,147,483,647。
• 计数器函数实例是完全独立的。全局计数器 - “FALSE” - 的每个实例都是独立维护的。
• 如果每个虚拟用户的计数器是独立增长的，那么通常被用于记录测试计划运行了多少遍。全局计数器通常被用于记录发送了多少次请求。

__intSum

存储结果的变量名不能为有效整数，否则会被当成整数用于计算
intSum用于计算两个或更多个整数值之和
举例：

• ${__intSum(2,5,)}，返回7
• ${__intSum(2,5,7)}，返回14

__log

• 第一个参数：要记录的字符串
• 第二个参数：日志级别，OUT，ERR，DEBUG，INFO（默认），WARN或ERROR

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

• ${__log(Message)}：写入日志文件，形如"...thread Name : Message"。
• ${__log(Message,OUT)}：写到控制台窗口。
• ${__log(${VAR},,,VAR=)}：写入日志文件，形如"...thread Name VAR=value"。

__property
property 函数返回 JMeter 属性的值。如果找不到属性值，并且没有提供默认值，则返回属性名称。当提供默认值时，可以不需要函数名称——参数可以设置为 null，并且将被忽略。
例如：

• ${__property(user.dir)} - 返回 user.dir 的值
• ${__property(user.dir,UDIR)} - 返回 user.dir 的值并保存在 UDIR 中 * ${__property(abcd,ABCD,atod)} - 返回属性 abcd 的值（如果没有定义，则返回“atod”）并保存在 ABCD 中
• ${__property(abcd,,atod)} - 返回属性 abcd的值（如果未定义，则返回“atod”）但不保存

__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.baidu.com)} - 返回属性的值的 hostname（主机名）或 www.dummy.org 。

在上面的例子中没有定义，第一个函数调用将返回7，第二个返回 1，最后一个将返回www.baidu.com （除非这些属性在别处有定义！）

总结

能熟练运用函数库，在写脚本过程中能起到事半功倍的效果。
本节介绍了作者在工作中用的比较多的函数，以后工作中遇到好用的随时添加进来。