Jmeter#3Jmeter+Ant的第一个html测试报告

1. Ant下载

1.1 下载地址

URL：https://ant.apache.org/bindownload.cgi
Binary vs Source: Binary 是编译好后直接可用的安装包；Source是源码包，一般需要安装可用直接选择Binary。

1.2 下载包

解压zip包到目标文件夹。

2. Ant环境变量配置

2.1 拷贝ant-jmeter-1.1.1.jar文件

原始路径：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\extras
目标路径：D:\apache-ant-1.10.14-bin\apache-ant-1.10.14\lib
作用：建立Jmeter和ant的关系，保证ant在运行时找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类，从而成功触发Jmeter脚本。

2.2 执行ant命令（配置环境变量之前）

2.3 配置环境变量

ANT_HOME D:\apache-ant-1.10.14-bin\apache-ant-1.10.14
CLASSPATH %ANT_HOME%\lib
Path %ANT_HOME%\bin

2.4 执行ant命令（配置环境变量之后）

这里提到build.xml不存在，这部分后面在单独章节重点讲解。该结果已验证ant可用。

3. Jmeter文件配置

3.1 修改Jmeter报告输出方式

jmeter默认报告输出方式为csv,手动修改为xml格式。
修改文件：jmeter.properties文件
路径：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\bin
字段：jmeter.save.saveservice.output_format=xml

3.2 TestSuite目录

位置：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3（Jmeter根目录下）
手动创建TestSuite目录。

3.3 build.xml文件

作用：配置ant编译文件build.xml
方法：新建build.txt记事本》修改文件后缀名为build.xml》以记事本方式打开》拷贝内容》保存。
拷贝内容说明：
→原始版本来自：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\extras目录下的build.xml文件，在其基础上进行相应的属性配置修改；
→亦或从网上获取现有的ant编译文件在其基础上，结合本机jmeter安装路径进行修改。
位置：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\TestSuite

参考内容：

<?xml version="1.0" encoding="UTF-8"?>
<project name="ant-jmeter-test" default="all" basedir="D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\TestSuite">
<property name="jmeterPath" value="D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3"/>
<tstamp>
    <format property="time" pattern="yyyyMMddhhmm" />
</tstamp>

    <property name="jmeter.home" value="${jmeterPath}" />
	<property name="jmeter.result.jtl.dir" value="${jmeterPath}\TestSuite\report\jtl" />
	<property name="jmeter.result.html.dir" value="${jmeterPath}\TestSuite\report\html" />
	<property name="ReportName" value="TestReport" />
	<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${time}.html" />
	<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}.jtl" />
	
<target name="all">
<antcall target="test" />
<antcall target="report" />
</target>

<target name="test">
<taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
<jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<testplans dir="${jmeterPath}\TestSuite\script" includes="BaiduTest.jmx" />
</jmeter>
</target>

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

<target name="report">
<xslt classpathref="xslt.classpath" force="true" in="${jmeter.result.jtlName}" out="${jmeter.result.htmlName}" style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl">
<param name="dateReport" expression="${time}"/>
</xslt>
<copy todir="${jmeter.result.html.dir}">
<fileset dir="${jmeter.home}/extras">
<include name="collapse.png" />
<include name="expand.png" />
</fileset>
</copy>
</target>
</project>

3.4 script和report子目录

位置：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\TestSuite
TestSuite目录下手动创建和script子目录。

3.5 html和jtl二级子目录

位置：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\TestSuite\report
report目录下手动创建html和jtl二级子目录。

3.6 拷贝collapse.png和expand.png

原始路径：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\extras
拷贝文件：collapse.png和expand.png
目标路径：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\TestSuite\report\html

4. 准备测试脚本

jmeter》新建测试计划》添加线程组》添加Http请求》输入请求信息（以第一个get请求为例）》保存测试计划到对应的script目录。
请求方式：GET
URL：https://www.baidu.com/

保存jmeter脚本到script目录。

5. ant执行脚本

5.1 第一次执行ant

进入TestSuite目录，命令行输入ant回车即可。

5.2 修改线程属性再次执行ant

操作1：重新保存Jmeter脚本
操作2：删除report\jtl目录下的TestReport.jtl文件
每次修改线程属性设置，重新执行jmeter脚本时，请务必重新保存Jmeter脚本并同时删除report\jtl目录下的TestReport.jtl文件，这样才能保证每次执行ant命令后，看到的html报告是实时生成的最新报告。

5.3 更换被执行的jmeter脚本后再次执行ant
每次脚本文件有变化时，请务必修改build.xml文件中的待执行脚本文件名称。

6. 查看html报告

6.1 如何访问

访问路径：D:\apache-jmeter-5.6.3\apache-jmeter-5.6.3\TestSuite\report\html

6.2 报告内容

7. 常见错误及解决办法

7.1 执行ant时提示build.xml:7: Unexpected text “? ?”

解决思路：打开build.xml文件，检查第7行以及周围行的代码，是否包含不属于XML标准的字符。
解决方法：删除xml标签每个属性前的空格，保存build.xml文件再次重新执行ant,该报错已解决。

7.2 执行ant时提示build.xml:34: 元素类型 “xslt” 必须后跟属性规范 “>” 或 “/>”

解决办法：xslt属性赋值全部调整放到一行，去掉回车，保存后再执行，该问题已解决

7.3 执行ant时提示build.xml:36: The type doesn’t support nested text data ("? ? ? ? … ? ? ? ?").

解决办法：build.xml文件用Notepad++打开，选择使用ANSI编码查看文件，删除显示的多余文字，保存后再执行，该问题已解决。（凡是碰到执行ant失败，原因为xml编码的问题基本都可以通过该方法完美解决，堪称万能解决方法）


此处，删除红色框出来的部分，再次保存后即可正常执行命令。