七、Jmeter 基础-常用内置函数
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 （除非这些属性在别处有定义！）
总结
能熟练运用函数库，在写脚本过程中能起到事半功倍的效果。
本节介绍了作者在工作中用的比较多的函数，以后工作中遇到好用的随时添加进来。
