当前位置： 首页 > news >正文

Jmeter+ant+Jenkins 接口自动化框架-利用ant工具批量跑指定目录下的Jmeter 脚本

news 2025/11/7 7:25:16

本文为Jmeter接口自动化测试-全流程，第三部分（1）
https://blog.csdn.net/nanixiaowai/article/details/134641603?spm=1001.2014.3001.5501

利用ant工具批量跑指定目录下的Jmeter 脚本

一、环境准备：

1）下载安装ant
下载地址 http://ant.apache.org/bindownload.cgi，下载后解压到指定位置即可
2）配置环境变量
vi /etc/profile
export ANT_HOME=/usr/local/apache-ant-1.9.9
export PATH=/usr/local/apache-ant-1.9.9/bin:$PATH
3）安装验证
验证安装结果,命令行输入ant -v，出现版本信息则安装成功
在这里插入图片描述

二、配置报告模板和ant build

1、将jmeter extras目录下的ant-jmeter-1.1.1.jar 文件拷贝到ant安装目录下的lib文件夹中

在这里插入图片描述
2、将测试报告模板jmeter-results-shanhe-me.xsl和jmeter-results-detail-report_31.xsl拷贝到jmeter的extras目录中

3、jmeter默认保存的是.csv格式的文件，我们先要设置一下配置jmeter.properties 文件目录 /apache-jmeter-3.1/bin/jmeter.properties
jmeter.properties文件中修改jmeter.save.saveservice.output_format=csv 为 jmeter.save.saveservice.output_format=xml，并去掉前面的注释符号#

4、build.xml 实现功能：
1）批量运行指定目录下的jmx文件，顺序执行
2）生成HTML格式的测试报告

具体如下：

整体结构

<?xml version="1.0" encoding="UTF-8"?>  
<project name="ant-jmeter-test" default="run" basedir=".">

定义了Ant项目名称为"ant-jmeter-test"
默认执行的目标(target)是"run"
基于当前目录(basedir=“.”)

时间戳设置
xml

<tstamp><format property="time" pattern="_yyyy_MMdd_HHmmss" />
</tstamp>

创建一个时间戳属性，格式为"_年_月日_时分秒"
用于在报告文件名中添加时间标识，避免覆盖之前的报告

属性定义
xml

<property name="basedirectory" value="/usr/local/jmeter/apache-jmeter-5.1.1/extras" /> 
<property name="jmeter.home" value="/usr/local/jmeter/apache-jmeter-5.1.1" />
<property name="report.title" value="接口测试"/>
<property name="jmeter.result.jtl.dir" value="/usr/local/jmeter/apache-jmeter-5.1.1/bin/Jmeter-script/core/report/jtl"/>
<property name="jmeter.result.html.dir" value="/usr/local/jmeter/apache-jmeter-5.1.1/bin/Jmeter-script/core/report/html"/>
<property name="detail" value="_detail" />
<property name="ReportName" value="TestReport" />
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}.jtl" />
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}.html" />
<property name="jmeter.result.jtlNamedetail" value="${jmeter.result.jtl.dir}/${ReportName}.jtl" />
<property name="jmeter.result.htmlNamedetail" value="${jmeter.result.html.dir}/${ReportName}${detail}.html" />

定义了各种路径和名称属性
需要根据实际环境修改这些路径值
设置了JTL结果文件和HTML报告的存储路径

默认运行目标
xml

<target name="run"><antcall target="test" /><antcall target="report" />
</target>

默认执行"run"目标时，会依次调用"test"和"report"两个目标
先执行测试，然后生成报告

测试执行目标
xml

<target name="test"><taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" /><jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}"><!-- 声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本--><testplans dir="/usr/local/jmeter/apache-jmeter-5.1.1/bin/Jmeter-script/core/testmain" includes="*.jmx" /><property name="jmeter.save.saveservice.output_format" value="xml"/></jmeter>
</target>

定义了"test"目标，用于执行JMeter测试
使用JMeter的Ant任务(需要ant-jmeter.jar)
指定了JMeter脚本目录和文件模式(*.jmx)
设置结果输出格式为XML

XSLT类路径设置
xml

<path id="xslt.classpath"><fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/><fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>
</path>

定义了XSLT转换所需的类路径
包含Xalan和Serializer库，用于将JTL结果转换为HTML报告

报告生成目标
xml

<target name="report"><tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /></tstamp><xslt classpathref="xslt.classpath"force="true"in="${jmeter.result.jtlName}"out="${jmeter.result.htmlName}"style="${jmeter.home}/extras/jmeter-results-detail-report_31.xsl"><param name="dateReport" expression="${report.datestamp}"/></xslt><xslt classpathref="xslt.classpath"force="true"in="${jmeter.result.jtlNamedetail}"out="${jmeter.result.htmlNamedetail}"style="${jmeter.home}/extras/jmeter-results-shanhe-me.xsl"><param name="dateReport" expression="${report.datestamp}"/></xslt><!-- 因为上面生成报告的时候，不会将相关的图片也一起拷贝至目标目录，所以，需要手动拷贝 --> <copy todir="${jmeter.result.html.dir}"><fileset dir="${jmeter.home}/extras"><include name="collapse.png" /><include name="expand.png" /></fileset></copy>
</target>

生成HTML格式的测试报告
使用两个不同的XSL模板生成报告：
jmeter-results-detail-report_31.xsl - 标准详细报告
jmeter-results-shanhe-me.xsl - 自定义报告(可能是项目特定的)
拷贝报告所需的图片资源(collapse.png和expand.png)

三、运行脚本

1、cd进入脚本目录

2、输入：ant 或 ant run(run为build.xml中的task名)，执行结果：

在这里插入图片描述
在这里插入图片描述
3、HTML测试报告

1）生成接口运行报告
使用 Jmeter(extras 目录下) 自带的jmeter-results-detail-report_21.xsl样式文件
在这里插入图片描述
从此报告中可以看到统计数据：总的和每一个接口的执行的样本数，成功、失败的样本数，响应时间和QPS。
对于看总体结果很方便清晰，但是定位不到对应jmx脚本中具体场景。所以下面介绍第二个报告样式

2）定位报错接口
使用扩展的jmeter-results-shanhe-me.xsl 样式文件，输出的信息比自带的jmeter-results-detail-report_21.xsl多。

在这里插入图片描述
此报告中的样式跟我们编写的jmx测试脚本的样式一样，可以点击每一个样本查看入参和返参，定位具体问题

4、脚本优化

以上运行结果是把所有jmx脚本的场景都生成到一个HTML测试报告里，如果想要分开执行，生成不同的HTML测试报告，可以使用for循环来批量执行jmx脚本，如下：

    <!-- 运行所有JMX脚本 --><target name="run-all-tests" depends="init"><echo message="Starting JMeter batch execution"/><!-- 获取所有JMX文件 --><fileset id="jmeter.testfiles" dir="${test.dir}" includes="**/*.jmx"/><pathconvert refid="jmeter.testfiles" property="testfiles" pathsep=","/><!-- 循环执行每个JMX文件 --><for param="file" list="${testfiles}"><sequential><basename property="testname" file="@{file}" suffix=".jmx"/><echo message="Executing test: ${testname}"/><!-- 执行JMeter测试 --><exec executable="${jmeter.home}/bin/jmeter" failonerror="false"><arg value="-n"/><arg value="-t"/><arg value="@{file}"/><arg value="-l"/><arg value="${result.dir}/${testname}_${time.stamp}.jtl"/><arg value="-j"/><arg value="${result.dir}/${testname}_${time.stamp}.log"/></exec><!-- 生成HTML报告 --><exec executable="${jmeter.home}/bin/jmeter" failonerror="false"><arg value="-g"/><arg value="${result.dir}/${testname}_${time.stamp}.jtl"/><arg value="-o"/><arg value="${report.dir}/${testname}_${time.stamp}"/></exec></sequential></for><echo message="All tests completed. Results are in ${result.dir}"/></target>

要使用循环，需要下载并安装Ant-Contrib扩展：
从 http://ant-contrib.sourceforge.net/ 下载ant-contrib-1.0b3.jar
将jar文件放置到Ant的lib目录中
如果你不想使用Ant-Contrib扩展，可以使用另一种方法实现批量执行：

<!-- 替代方案：使用apply任务执行所有JMX文件 -->
<target name="run-all-tests-alternative" depends="init"><apply executable="${jmeter.home}/bin/jmeter" parallel="false" failonerror="false" dest="${result.dir}"><arg value="-n"/><arg value="-t"/><srcfile/><arg value="-l"/><targetfile/><arg value="-j"/><mapper type="glob" from="*.jmx" to="*.jtl"/><fileset dir="${test.dir}" includes="**/*.jmx"/></apply>
</target>

方法很多，都可以尝试一下。

http://www.dtcms.com/a/577003.html

相关文章：

  • 网站建设制作 企业站开发哪家好兰州又发现一例
  • LeetCode 刷题【146. LRU 缓存】
  • 网站建设 招标公告c2c的代表性的电商平台
  • RedisCluster客户端路由智能缓存
  • K8s从Docker到Containerd的迁移全流程实践
  • Rust语言高级技巧 - RefCell 是另外一个提供了内部可变性的类型，Cell 类型没办法制造出直接指向内部数据的指针，为什么RefCell可以呢？
  • 【Python后端API开发对比】FastAPI、主流框架Flask、Django REST Framework（DRF）及高性能框架Tornado
  • 计算机外设与CPU通信
  • 玩转Rust高级应用 如何编译器对于省略掉的生命周期，不使用“自动推理”策略呢？
  • Python全栈项目：基于Django的电子商务平台开发
  • 网站建设怎么开票网站设计网页设计公司
  • Python实现GPT自动问答与保存
  • 深度强化学习，用神经网络代替 Q-table
  • seo网站建设技巧电线电缆技术支持中山网站建设
  • supabase外键查询语句
  • 【linux端cursor CLI常用命令】
  • 表的增删改查
  • Git 工作区、暂存区和版本库
  • MIT-矩阵链相乘
  • Go语言实战：入门篇-5：函数、服务接口和Swagger UI
  • 国产化Excel处理控件Spire.XLS教程：使用Java将CSV转换为PDF（含格式设置）
  • 【Hot100｜3 LeetCode 128. 最长连续序列】
  • 一键搭建 Coze 智能体对话页面：支持流式输出 + 图片直显，开发效率拉满！
  • 十大免费ae模板网站短视频素材下载网站
  • 那里做直播网站网页打不开是什么问题
  • 论文分享 | AirRoom：物体是关键！革新室内房间重识别的新范式
  • 游戏 IPA 如何防修改，面向开发者的多工具实战（IPA 加固/无源码混淆/Ipa Guard CLI）
  • 从0到1做一个“字母拼词”Unity小游戏（含源码/GIF）- 项目的创建及准备
  • 在扣子上搭建测试用例自动编写智能体
  • 2023年第二十届五一数学建模竞赛-A题 无人机定点投放问题-基于抛体运动的无人机定点投放问题研究