目录
[1 前言](#1 前言)
[2 开发准备](#2 开发准备)
[3 自定义函数核心实现](#3 自定义函数核心实现)
[3.1 新建项目](#3.1 新建项目)
[3.2 继承实现 AbstractFunction 类](#3.2 继承实现 AbstractFunction 类)
[3.3 最终项目结构](#3.3 最终项目结构)
[4 Jmeter 加载扩展包](#4 Jmeter 加载扩展包)
[4.1 maven 构建配置](#4.1 maven 构建配置)
[4.2 项目打包](#4.2 项目打包)
[4.3 Jmeter 加载扩展包](#4.3 Jmeter 加载扩展包)
[5 自定义函数调用调试](#5 自定义函数调用调试)
[5.1 打开 Jmeter 函数助手,选择自定义函数](#5.1 打开 Jmeter 函数助手,选择自定义函数)
[5.2 京东宙斯接口验证](#5.2 京东宙斯接口验证)
1 前言
JMeter 是一个开源性能测试工具,可以帮助开发者对 Web 应用程序进行压力测试。在 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;
}
- 配置入参,jmeter函数助手入参
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



作为一位过来人也是希望大家少走一些弯路
在这里我给大家分享一些自动化测试前进之路的必须品,希望能对你带来帮助。
(软件测试相关资料,自动化测试相关资料,技术问题答疑等等)
相信能使你更好的进步!
点击下方小卡片
