Jmeter+ant生成html报告教程(4)

此教程属于Jmeter基本操作熟练后，进行提升的项目

主要应用于接口的回归或者性能的简单查看功能。操作为先在jmeter中写好测试计划，保存为jmx文件，在cmd窗口对应路径下执行ant命令，会完成jmx计划的执行和生成jtl文件，并将jtl文件转化为html页面进行查看。后续可扩展为接入jenkins集成，并邮件发送。

一 、安装ant；下载apache-ant，放到对应路径下，然后进行环境变量配置。
下载地址：http://ant.apache.org/bindownload.cgi

（下载你需要的apache-ant版本，在这里是要下载bin的）

二、ant环境配置；（如同jdk配置一样简单，添加你自己的路径）

系统变量的CLASSPATH添加E:\Installation Pack\eclipse\apache-ant-1.9.6\lib;（添加lib绝对路径）
用户变量的PATH添加：E:\Installation Pack\eclipse\apache-ant-1.9.6\bin;（添加bin绝对路径）

打开cmd，执行 ant，提示"Buildfile:build.xml does not exist! Build failed"则配置成功，
ant命令可用。如下图所示。

三、配置文件环境：

（1）将JMeter所在目录下extras子目录里的ant-JMeter-1.1.1.jar复制到Ant所在目录lib子目录之下，这样Ant运行时才能找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类，从而成功触发JMeter脚本     

（2）编写脚本build.xml文件（重要！！！此步骤影响后期html成功与失败，大部分问题出自这里，我编写代码是用Notepad++，记得要用英文输入编写）

build.xml文件代码如下：

<target name="run">
    <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}">
         <!-- 声明要运行的脚本。"*.jmx"指包含此目录下的所有jmeter脚本-->
        <testplans dir="G:\jmeter\JmeterTest\demo" includes="*.jmx" />
		<property name="jmeter.save.saveservice.output_format" value="xml"/>
    </jmeter>
</target>

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

<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_21.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>

（3）文件的位置，影响cmd是否可以成功启动ant（文件夹名称随意起）
生成前：

Jmetertest：jmeter测试，存放结果记录、脚本
Resultlog：结果记录，存放运行ant后生成的jtl、html报告
Script：脚本，jm的执行脚本
Build.xml：运行ant必须的脚本，上面已经给出

（4）当全部文件配置成功，cmd进入Jmetertest文件夹中，运行ant；

如图成功生成html报告：

（5）打开resultlogh中html文件夹中生成出的html文件，就可以看见html报告。如图成功生成

（6）常见问题；

问题1：配置完毕，无法生成；
解决：缺少jmeter-results-detail-report_21.xsl文件

问题2：发现Min Time和Max Time尽然没有显示出来显示的Nan
解决：下载一个xalan.jar，serializer.jar，将这两个jar包入ant的lib包中再次切 换到jemeterTest目录下，输入ant查看运行结果

问题3：就是在执行 最后生成报告的 task 时，一直报下面这个错：
     TransformerException，  Content is not allowed in prolog.
解决：bin/jmeter.properties文件内容，保存
   jmeter.save.saveservice.output_format=xml