# jmeter-ExtraFunc-plugins

**Repository Path**: smooth00/jmeter-ExtraFunc-plugins

## Basic Information

- **Project Name**: jmeter-ExtraFunc-plugins
- **Description**: jmeter自定义扩展函数开发，本次开发的插件包以五个函数为例，可以按照这个套路继续扩展开发。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://smooth.blog.csdn.net
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 4
- **Created**: 2019-12-04
- **Last Updated**: 2024-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# jmeter-ExtraFunc-plugins

#### 介绍
jmeter扩展函数插件

#### 软件架构
软件架构说明
<pre>
jmeter-ExtraFunc-plugins
├─src
│  └─main
│     ├─java
│     └─resources
├─pom.xml
</pre>

#### 开发说明
- 1、Jmeter插件必须在包含```.functions```包下
- 2、创建一个类，继承```org.apache.jmeter.functions.AbstractFunction```，重写下面方法：
```java
/** 函数执行逻辑，并返回值 */
public String execute(SampleResult sampleResult, Sampler sampler);
/** 接受处理入参 */
public void setParameters(Collection<CompoundVariable> collection);
/** 定义返回函数名称 */
public String getReferenceKey();
/** 定义函数入参说明 */
public List<String> getArgumentDesc();
```

#### 安装教程

- 1、clone到本地
```bash
git clone https://gitee.com/smooth00/jmeter-ExtraFunc-plugins.git
```

- 2、编译打包
```bash
cd jmeter-ExtraFunc-plugins
mvn clean install
```

- 3、拷贝jar到Jmeter中

复制 ```jmeter-ExtraFunc-plugins/target/jmeter-ExtraFunc-plugins-1.0.jar```到```%JMETER_HOME%/lib/ext```目录下，并重启Jmeter

#### 使用说明

| 函数名 | 使用例子 | 解释说明 | 
| ---- | ---- | ---- |
| __RandomChineseName | ```${__RandomChineseName}```| 生成随机中文姓名 |
| __RandomMobile | ```${__RandomMobile}```| 生成随机手机号码 |
| __RandomEmail | ```${__RandomEmail}```| 生成随机电子邮箱 |
| __RandomIP | ```${__RandomIP}```| 生成随机IPv4地址 |
| __RandomIdCardNo | ```${__RandomIdCardNo}```| 生成随机身份证号（满足标准校验规则） |