jmeter常用函数整理

1、__BeanShell:beanshell函数
https://jmeter.apache.org/usermanual/functions.html#__BeanShell
它有两个参数,第一个参数是要执行的语句,可以是beanshell语句或者是文件地址,是必选参数;第二个参数是保存结果的变量名称,非必选参数。
与beanshell元件比较:该函数与beanshell元件(beanshell sampler、beanshell preprocess等)作用是一样的,只是beanshell函数更常用于一些简单的判断或计算等,可以把少量的脚本放在函数中直接赋值给一个变量,而不用总是添加beanshell元件


2、__intSum:整数求和函数
https://jmeter.apache.org/usermanual/functions.html#__intSum
(1、函数__intSum可以被用来计算两个或者更多整数值的合。至少需要两个整数,如果指定变量名则名称中必须包含一个非数字字母,否则它会被当成另一个整数值,而被函数用于计算。
(2、当有多个整数时点击添加按钮来增加参数,但是需要注意的是,添加完参数后,点击”生成”的函数默认是把手动添加的函数放在后面,这时需要手动调整变量名的位置,把它放到最后,否则会报错。

3、__longSum:长整型求和函数
该函数用来计算两个或更多长整型值的和,使用方法跟上面的__intSum函数一样
https://jmeter.apache.org/usermanual/functions.html#__longSum
4、__StringFromFile:读取文件中的字符串函数
https://jmeter.apache.org/usermanual/functions.html#__StringFromFile
(1、该函数用来从文本文件中读取字符串。支持读取多个文件。
(2、使用配置元件CSV Data Set Config ,也能达到相同的目的,而且方法更简单,但是它目前不支持多个输入文件。
(3、每次调用函数,都会从文件中读取下一行。当到达文件末尾时,函数又会从文件开始处重新读取,直到最大循环次数。如果在一个测试脚本中对该函数有多次引用,那么每一次引用都会独立打开文件,即使文件名是相同的(如果函数读取的值,在脚本其他地方也有使用,那么就需要为每一次函数调用指定不同的变量名)。
(4、如果在打开或者读取文件时发生错误,那么函数就会返回字符串"**ERR**"。
示例:
${_StringFromFile(demo.txt,,,)} 读取demo.txt
${_StringFromFile(PIN#'.'DAT,,1,2)} 读取demo1.txt, demo2.txt
${_StringFromFile(PIN.DAT,,,2)} 读取demo.txt两次
(5、函数的第三个参数:初始的序列号,如果省略,那么结束序列号就代表文件的循环读取次数。
(6、函数的第四个参数:结束序列号,如果省略,那么序列号会无限增长。
(7、读取多个文件示例:
需要在文件名中使用序列号:当使用序列号时,文件名需要使用格式字符串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
如果不希望某个格式字符被翻译,需要为它加上单引号。注意上面的"."是格式字符,必须被单引号所包含。
比如现在要同时读取两个文件,分别是PIN1.DAT, PIN2.DAT:
${_StringFromFile(PIN#'.'DAT,,1,2)}:同时读取 PIN1.DAT, PIN2.DAT。
${_StringFromFile(PIN.DAT,,,2)}:读取 PIN.DAT 两次。
${_StringFromFile(test#'.'txt,,1,2)}:同时读取test1.txt,test2.txt
5、__property 属性函数
https://jmeter.apache.org/usermanual/functions.html#__property
(1、函数__property会返回一个JMeter属性的值。如果函数找不到属性值,而又没有提供默认值,则它会返回属性的名称。
(2、例如,
${__property(user.dir)}:返回属性user.dir的值。
${__property(user.dir,UDIR)}:返回属性user.dir的值,并保存在变量UDIR中。
${__property(abcd,ABCD,atod)}:返回属性abcd的值 (如果属性没有定义,返回"atod"),并保存在变量ABCD 中。
${__property(abcd,,atod)}:返回属性abcd 的值(如果属性没有定义,返回"atod"),但是并不保存函数的返回值。
6、__P 简化版属性函数
(1、函数_P是一个简化版的属性函数,目的是使用在命令行中定义的属性。
(2、不同于函数_property,本函数没有提供选项用于设置保存属性值的变量。另外,如果没有设置默认值,默认值自动设为1。
(3、例如:定义属性值:
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.baidu.com。
在上面的例子中,第一个函数调用返回7,第二个函数调用返回1,而最后一个函数调用返回www.baidu.com(除非这些属性在其他地方有定义)。
7、__log 日志函数
(1、函数__log会记录一条日志,并返回函数的输入字符串。
(2、OUT 和ERR的日志级别,将会分别导致输出记录到System.out和System.err中。在这种情况下,输出总是会被打印(它不依赖于当前的日志设置)。
例如:
${__log(Message)}:写入日志文件,形如"...thread Name : Message"。
${__log(Message,OUT)}:写到控制台窗口。
${__log(${VAR},,,VAR=)}:写入日志文件,形如"...thread Name VAR=value"。
8、__split:字符串分割函数
(1、函数__split会通过分隔符来拆分传递给它的字符串,并返回原始的字符串。如果分隔符紧挨在一起,那么函数就会以变量值的形式返回"?"。拆分出来的字符串,以变量${VAR_1}、{VAR_2}…以此类推的形式加以返回。
(2、分隔符默认是逗号,如果你想要多此一举,明确指定使用逗号,需要对逗号转义,如“,”
(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变量的值。
9、__setProperty 可全局被调用的属性函数
(1、函数__setProperty用于设置JMeter属性的值。函数的默认返回值是空字符串,因此该函数可以被用在任何地方,只要对函数本身调用是正确的。
(2、通过将函数可选的第3个参数设置为"true",函数就会返回属性的原始值。
(3、属性对于JMeter是全局的,因此可以被用来在线程和线程组之间通信。
10、__time 时间
(1、函数__time可以通过多种格式返回当前时间。
(2、如果省略了格式字符串,那么函数会以毫秒的形式返回当前时间。其他情况下,当前时间会被转成简单日期格式。包含如下形式:
YMD = yyyyMMdd
HMS = HHmmss
YMDHMS = yyyyMMdd-HHmmss
USER1 = JMeter属性time.USER1
USER2 = JMeter属性time.USER2
用户可以通过修改JMeter属性文件来改变默认格式,或者自定义格式,例如修改YMD格式: time.YMD=yyMMdd。
11、__timeShift 指定时间偏移前后的时间值
3.3版本开始才内置该函数,类似__time函数,不同之处在于它可以返回按指定时间单位和时间数量偏移后的值。
${__timeShift(Format, DateToShift, valueToShift, LocaleToUseForFormat, variableName)}
说明:
Format 同__time()函数,参数可选
DateToShift 日期(时间)值,格式同Format参数匹配,如果不匹配、未提供该参数值,则默认使用当前日期。偏移是基于该日期(时间)的。参数可选
valueToShift 指要偏移的秒数、分钟数、小时数、天数。参数可选
书写语法参考:
https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html#parse-java.lang.CharSequence-
例子:
PT20.345S 被解析为 20.345 秒,意为在DateToShift 的基础上增加20.345秒
PT15M 被解析为 15分钟,意为在DateToShift 的基础上增加15分钟秒
PT10H 被解析为 10小时,意为在DateToShift 的基础上增加10小时
P2D 被解析为 2 天,意为在DateToShift 的基础上增加2天
-P6H3M 被解析为 -6 小时又-3小时,,意为在DateToShift 的基础上增加6小时3分钟
LocaleToUseForFormat 表示日期(时间)的语言环境,即用于格式化日期(时间)的语言. 语言代码必须小写。国家代码必须大写。分隔符必须为下划线。比如en_EN。参数可选,如果未提供,则模式使用ApacheJMeter 的locale.
12、__V 嵌套函数引用
(1、函数__V可以用于执行变量名表达式,并返回执行结果。它可以被用于执行嵌套函数引用(目前JMeter不支持)。
(2、例如,如果存在变量A1、A2和N=1,则:
${A1}:能正常工作。
${A${N}}:无法正常工作(嵌套变量引用)。
${__V(A${N})}:可以正常工作。A${N}变为A1,函数 __V返回变量值A1。
13、__evalVar
(1、函数__evalVar可以用来执行保存在变量中的表达式,并返回执行结果。
如此一来,用户可以从文件中读取一行字符串,并处理字符串中引用的变量。
(2、例如:
假设变量"query"中包含有"select ${column} from ${table}",
而 "column"和"table" 中分别包含有 "name"和"customers",
那么${__evalVar(query)}将会执行"select name from customers"。
14、__eval
(1、函数__eval可以用来执行一个字符串表达式,并返回执行结果。
如此一来,用户就可以对字符串(存储在变量中)中的变量和函数引用做出修改。
(2、例如:
给定变量 name=Smith、column=age、table=birthdays、
SQL=select ${column} from ${table} where name='${name}',
那么通过 ${__eval(${SQL})},就能执行 "select age from birthdays where name='Smith'"
这样一来,就可以与CSV数据集相互配合,例如,将SQL语句和值都定义在数据文件中。

 

posted @ 2020-04-12 20:19  喵精灵  阅读(820)  评论(0)    收藏  举报