总体思路
扩展Jmeter自定义函数 执行以下步骤:
在
Eclipse
中新建Maven
项目,引入扩展Jmeter function
所需的依赖包编码实现自定义
function
,并编译打包将编译好的包拷贝至
Jmeter
扩展目录下运行
Jmeter
查看自定义function
是否正确
新建项目
在Eclipse
中新建一个Maven
项目
File > New > Project,选择Maven Project
导入扩展Jmeter function的2个依赖包,如图所示
编写JMeter function代码
要实现扩展JMeter function,主要有两点:
- 实现
function
的类的package
声明必须包含".functions
"
JMeter设计让一些核心的类可以在非UI的方式下运行的时候能被加载进来,这些类会被优先加载。加载这些类的时候是通过命名规则来实现的。所有实现function的类必需包含".functions",所以自定义实现的类里必须包含".functions",如下图申明的包名为:"jmeter.test.functions"。
需要继承AbstractFunction,并且实现相应的方法。
AbstractFunction
类提供了4个抽象方法,在扩展时需全部实现
-
setParameters
这个方法在用于传递用户在执行过程当中传入的实际参数值。该方法在function没有参数情况下也会被调用。一般该方法传入的参数会被保存在类内全局变量里,并被后面调用的execute方法中使用到
public void setParameters(Collection<CompoundVariable> parameters) throws InvalidVariableException {
checkParameterCount(parameters, MIN_PARA_COUNT, MAX_PARA_COUNT); //检查参数的个数是否正确
values = parameters.toArray(); //将值存入类变量中
-
execute
JMeter会将上次运行的SampleResult和当前的Sampler作为参数传入到该方法里,返回值就是在运行该function后得到的值,以String类型返回.该方法如果操作了非线程安全的对象(比如文件),则需要将对该方法进行线程同步保护.
public String execute(SampleResult previousResult, Sampler currentSampler) throws InvalidVariableException {
try {
int max = new Integer(((CompoundVariable) values[0]).execute().trim());
int val = r.nextInt(max);
return String.valueOf(val);
} catch(Exception ex) {
throw new InvalidVariableException(ex);
}
}
-
getReferenceKey
这个就是function
的名字。Jmeter
的命名规则是在方法名前面加入双下划线"__"。比如"__MyRandomFunc
",function
的名字跟实现该类的类名应该一致,而且该名字应该以static final
的方式在实现类中定义好,避免在运行的时候更改它。
public String getReferenceKey() {
return KEY;
}
-
getArgumentDesc
最后在你的实现类中还需要提供一个方法来告诉Jmeter
关于你实现的function
的描述
public List<String> getArgumentDesc() {
return desc;
}
测试function正确性
右击项目,弹出菜单export->jar file
,如下图打包成一个jar包
把这个JAR拷贝至$JMETER__HOME/lib/ext
目录下,重新启动Jmeter
.
打开选项中的函数助手对话框,如果配置正确的话就能出现自己定义的function.
完整的源码
packagejmeter.test.functions;
importjava.util.Collection;
importjava.util.LinkedList;
importjava.util.List;
importjava.util.Random;
importorg.apache.jmeter.engine.util.CompoundVariable;
importorg.apache.jmeter.functions.AbstractFunction;
importorg.apache.jmeter.functions.InvalidVariableException;
importorg.apache.jmeter.samplers.SampleResult;
importorg.apache.jmeter.samplers.Sampler;
publicclassMyRandomFuncextendsAbstractFunction{
// 自定义function的描述
privatestaticfinalList desc =newLinkedList();
static{
desc.add("Get a random int within specified parameter value.");
}
// function名称
privatestaticfinalString KEY ="__MyRandomFunc";
privatestaticfinalintMAX_PARA_COUNT =1;
privatestaticfinalintMIN_PARA_COUNT =1;
// 传入参数的值
privateObject[] values;
privateRandom r =newRandom();
@Override
publicListgetArgumentDesc(){
returndesc;
}
@Override
publicStringexecute(SampleResult previousResult, Sampler currentSampler)throwsInvalidVariableException{
try{
intmax =newInteger(((CompoundVariable) values[0]).execute().trim());
intval = r.nextInt(max);
returnString.valueOf(val);
}catch(Exception ex) {
thrownewInvalidVariableException(ex);
}
}
@Override
publicStringgetReferenceKey(){
returnKEY;
}
@Override
publicvoidsetParameters(Collection<CompoundVariable> parameters)throwsInvalidVariableException{
checkParameterCount(parameters, MIN_PARA_COUNT, MAX_PARA_COUNT);// 检查参数的个数是否正确
values = parameters.toArray();// 将值存入类变量中。
}
}