1 前言
Jmeter 是 Apache 基金会下的一款利用场景十分广的压力测试工具,具备轻量、高扩展性、分布式等个性。Jmeter 已反对实现随机数、计数器、工夫戳、大小写转换、属性校验等多种函数,方便使用人员应用。如果在应用过程中存在和业务强耦合的罕用性能函数,在 Jmeter 不反对的状况下,那就须要独自开发自定义函数实现特定性能。
本文介绍如何开发 Jmeter 自定义函数实现疾速生成京东宙斯下单规范 sign,同时深刻理解 Jmeter 的插件化机制及高扩展性个性。
2 开发筹备
- Java 根底开发
- Maven 根本应用
- 开发依赖版本
JDK 1.8.0Maven 3.6.3Jmeter 5.4.3
3 自定义函数外围实现
3.1 新建我的项目
- 新建 maven 我的项目,这里我的项目名为:JSF_Sampler
- 因为是基于 Jmeter 的扩大,须要依赖包 Jmeter 两个外围包,别离是:
- ApacheJMeter_core
- ApacheJMeter_java
- ApacehJMeter_functions
pom.xml 文件外围配置如下
<groupId>com.jd.jmeter.jsf</groupId>
<artifactId>JSF_Sampler</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<jmeter-version>5.4.3</jmeter-version>
</properties>
<dependencies>
<dependency>
<groupId>org.apache.jmeter</groupId>
<artifactId>ApacheJMeter_core</artifactId>
<version>${jmeter-version}</version>
</dependency>
<dependency>
<groupId>org.apache.jmeter</groupId>
<artifactId>ApacheJMeter_java</artifactId>
<version>${jmeter-version}</version>
</dependency>
<dependency>
<groupId>org.apache.jmeter</groupId>
<artifactId>ApacheJMeter_functions</artifactId>
<version>${jmeter-version}</version>
</dependency>
</dependencies>
3.2 继承实现 AbstractFunction 类
实现类顺次实现以下几个步骤
1)新建实现类并继承 AbstractFunction
- 留神:实现类的包名必须蕴含 xxx.functions.xxx,Jmeter 应用命名规定实现实现类的加载。
2)重写以下办法,每个办法的用处见下方代码正文
- execute()
- setParameters()
- getReferenceKey()
- getArgumentDesc()
/**
* 京东宙斯 下单规范字段常量
*/
private static final String APP_KEY = "app_key";
private static final String APP_SECRET = "app_secret";
private static final String ACCESS_TOKEN = "access_token";
private static final String TIMESTAMP = "timestamp";
private static final String V = "v";
private static final String METHOD = "method";
private static final String BUY_PARAM_JSON = "360buy_param_json";
/**
* Jmeter 中自定义的函数名,在 Jmeter 的函数助手中能够看到
*/
private static final String FUNC_NAME = "__GenSignFunction";
/**
* 自定义函数的形容,入参,出参,方便使用人员参考应用
*/
private static final List<String> desc = new ArrayList<>();
static {desc.add("This function is used to generate the JD's JOS sign value");
}
/**
* 此为自定义函数外围实现类,其中,入参 SampleResult 为上次运行的后果,Sampler 为以后的采集器;* 返回值为该函数的返回值
* @param sampleResult
* @param sampler
* @return
* @throws InvalidVariableException
*/
@Override
public String execute(SampleResult sampleResult, Sampler sampler) throws InvalidVariableException {
// 入参解决
String param = String.valueOf((CompoundVariable)paramValues[0]);
String signResult = paramHandler(param);
return signResult;
}
/**
* 按京东宙斯 sign 加密规定生成规范 sign
* @param param
* @return
*/
public String paramHandler(String param){Map<String,String> valueMap = new HashMap();
// 按 & 符号宰割
String[] paramArray = param.split("&");
for (int i = 0; i < paramArray.length-1; i++) {String key = paramArray[i].split("=")[0];
String value = paramArray[i].split("=")[1];
valueMap.put(key,value);
};
// 京东宙斯规范 sign
String josGign = EncryptUtil.getSignature(valueMap.get("app_secret")+BUY_PARAM_JSON+valueMap.get("360buy_param_json")
+ACCESS_TOKEN+valueMap.get("access_token")
+APP_KEY+valueMap.get("app_key")
+METHOD+valueMap.get("method")
+TIMESTAMP+valueMap.get("timestamp")
+V+valueMap.get("v")
+valueMap.get("app_secret"));
return josGign;
}
/**
* 配置入参,jmeter 函数助手入参
*/
@Override
public void setParameters(Collection<CompoundVariable> collection) throws InvalidVariableException {paramValues = collection.toArray();
}
/**
* 此办法返回自定义的函数名称
*/
@Override
public String getReferenceKey() {return FUNC_NAME;}
/**
* 此办法返回函数形容信息
*/
@Override
public List<String> getArgumentDesc() {return desc;}
3.3 最终我的项目构造
4 Jmeter 加载扩大包
以上开发实现,打包此我的项目,留神这里的打包要蕴含依赖包。
4.1 maven 构建配置
<build>
<finalName>${project.artifactId}</finalName>
<defaultGoal>install</defaultGoal>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
<executions>
<execution>
<id>assemble-all</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
4.2 我的项目打包
打包指令如下
mvn package -Dmaven.test.skip=true
4.3 Jmeter 加载扩大包
将打包后的扩大包搁置到 Jmeter 的 ext 目录:apache-jmeter-5.4.3/lib/ext/
启动 Jmeter 后,Jmeter 会主动加载 ext 目录中的扩大包
关上 Jmeter 函数助手后,能够看到本次实现类中打印的相干日志
5 自定义函数调用调试
5.1 关上 Jmeter 函数助手,抉择自定义函数
5.2 京东宙斯接口验证
这里应用京东快递获取预制运单号接口,输出 GET 申请后,间接点击运行函数【Generate & Copy to clipboard】,出参返回 32 位 sign 值。
GET 申请入参
method=jingdong.etms.waybillcode.get&app_key=349559FAE87E66826499890862E40A44&access_token=c8c2bdc8d1684630bb771a503d5b5a7fkyzh×tamp=2022-01-28 15:10:00&360buy_param_json={"preNum":"1","customerCode":"10K43816","orderType":"0"}&v=2.0&sign=EBB52C6CEDA34703ADE72D4AA4D8F316&app_secret=29959e4cadc14ff4998d4fc26d1e5063
6 总结
本文通过自定义函数实现了京东宙斯下单规范 sign 的生成,心愿通过本我的项目大家能够学习到:
- 如何二次开发 Jmeter,实现本人特有的自定义函数。
- 了解为何官网介绍 Jmeter 是插件化的,高扩展性个性。
- 更好的了解 Jmeter 外部解决机制。
作者:京东物流 苗浩冲
起源:京东云开发者社区