ANT批量执行Jmeter脚本

一、环境准备

　　1、安装Jdk1.6或以上：http://www.oracle.com/technetwork/java/javase/downloads/index.html

　　　　命令行输入：java -version，检查是否安装成功

　　2、ANT下载：http://ant.apache.org/bindownload.cgi

　　　　1、新建系统环境变量“ANT_HOME”变量值中输入ant所在路径

　　　　2、在path变量中添加;%ANT_HOME%\bin

　　　　3、在cmd输入框中输入ant -v，如果可以看到ant版本，则环境变量配置成功

　　　　

　　3、Jmeter下载：http://jmeter.apache.org/download_jmeter.cgi

　　4、将 jmeter的extras目录中ant-jmeter-1.1.1.jar包拷贝至ant安装目录下的lib目录中

　　5、修改Jmeter的bin目录下jmeter.properties文件的配置：jmeter.save.saveservice.output_format=xml  

 二、Jmeter脚本

　　************************后续补充　************************

三、build.xml代码

<?xml version="1.0" encoding="UTF-8"?>

<project name="ant-jmeter-test" default="run" basedir=".">
    <tstamp>
        <format property="time" pattern="yyyyMMddhhmm" />
    </tstamp>
    <!-- 需要改成自己本地的 Jmeter 目录-->
    <property name="jmeter.home" value="D:\D:\apache-jmeter-5.2.1" />
    <!-- jmeter生成jtl格式的结果报告的路径-->
    <property name="jmeter.result.jtl.dir" value="D:\apache-jmeter-5.2.1\demo\report\jtl" />
    <!-- jmeter生成html格式的结果报告的路径-->
    <property name="jmeter.result.html.dir" value="D:\apache-jmeter-5.2.1\demo\report\html" />
    <!-- 生成的报告的前缀-->
    <property name="ReportName" value="TestReport" />
    <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${time}.jtl" />
    <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${time}.html" />

    <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="D:\apache-jmeter-5.2.1\demo" includes="*.jmx" />

　　　　　　　<property name="jmeter.save.saveservice.output_format" value="xml"/>

        </jmeter>
    </target>

    <target name="report">
        <xslt in="${jmeter.result.jtlName}"
              out="${jmeter.result.htmlName}"
              style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl" />
                <!-- 因为上面生成报告的时候，不会将相关的图片也一起拷贝至目标目录，所以，需要手动拷贝 -->
        <copy todir="${jmeter.result.html.dir}">
            <fileset dir="${jmeter.home}/extras">
                <include name="collapse.png" />
                <include name="expand.png" />
            </fileset>
        </copy>
    </target>
</project>

四、运行脚本

　　 1、cmd进入脚本目录：D:\apache-jmeter-5.2.1\demo

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

 　　3、测试报告目录：并将apache-jmeter-5.2.1\extras\ant-jmeter-1.1.1.jar拷贝到apache-ant-1.10.8\lib目录下\demo\report\html，其中有一个红色失败的案例是我故意设置失败，以便查看的

 　　4、最后，说一个我在使用过程中碰到一个问题，上面build.xml文件第29行有一句必须要加上：<property name="jmeter.save.saveservice.output_format" value="xml"/>,否则会报如下的错误： 

report:
     [xslt] Processing D:\Tools\apache-jmeter-2.13\demo\report\jtl\TestReport201509210923.jtl to D:\Tools\apache-jmeter-2.13\demo\report\html\TestReport201509210923.html
     [xslt] Loading stylesheet D:\Tools\apache-jmeter-2.13\extras\jmeter-results-detail-report_21.xsl
     [xslt] : Error! 前言中不允许有内容。
     [xslt] : Error! com.sun.org.apache.xml.internal.utils.WrappedRuntimeException: 前言中不允许有内容。
     [xslt] Failed to process D:\Tools\apache-jmeter-2.13\demo\report\jtl\TestReport201509210923.jtl

　　因为不加上这一句，生成的.jtl文件是文本文件不是xml文件，使用xsl去转换.jtl文件时就会报错。

　　注意：执行时会遇到报错的情况，例如：the jmeter type doesn't support nested text data，这个是因为build.xml文件中存在编码不同的字符，解决办法为：

　　使用notpad++打开build.xml保存为与当前系统一致的编码，一般为ANSI 或者utf-8 no BOM这两种，尝试切换，可以看到文件中隐藏的编码，然后删除即可

 

五、报告优化

生成的报告有一点小问题，虽然不影响使用，但总是感觉不够完美，具体问题如下：

　　1、Date report这里的时间没有正确显示出来

　　2、Summary里的字段Min Time和Max Time显示的是NaN，没有显示正确的时间。

这里主要解决上述两个问题，具体报告如何生成可参考上面提到的两篇文章。

1、Jmeter+Ant报告生成原理：

　　在解决问题之前，让我们先弄清楚Jmeter+Ant是生成报告的原理，知道原理后我们就可以很从容的解决问题了。另外，如果后续我们想定制报告也就很容易了。

　　1、在Jmeter的extras目录下，官方已经为我们提供了一个现成的实例，我们只需要在该目录下执行ant命令就可以生成一个数据文件Test.jtl和一个报告Test.html（PS：如果没有安装ant需要先去安装，不会用ant的自行百度）。

　　2、知道了上一步后，接下来我们研究的重点就是extras目录下的build.xml文件了，具体研究细节就不在此细说了，因为这就部分内容属于ant的范围，有需要的可以自行补充下ant的知识。

 

2、解决问题：

　　1、找到extras目录下build.xml文件内容的如下部分：它的作用就是把生成的.jtl数据文件转换为.html格式的报告

　　具体属性的含义：

• in：生成的.jtl文件的路径
• out：生成的.html文件的路径
• style：从.jtl转换成.html所使用的样式，这些文件也在extras目录下，这个是最重要的部分，如果我们想定制报告可以自行定义这个文件或者从网上找一些合适的文件。
• param：参数，这几个参数可以在style中使用，下面会讲到。
• path：添加jar包的路径，在下面的target中有引用到（下面第9行）

<path id="xslt.classpath">//jar的路径
        <fileset dir="${lib.dir}" includes="xalan*.jar"/>
        <fileset dir="${lib.dir}" includes="serializer*.jar"/>
    </path>
　　 ／／把生成的.jtl数据文件转换成.html格式的报告
    <target name="xslt-report" depends="_message_xalan">
        <tstamp><format property="report.datestamp" pattern="yyyy/MM/dd HH:mm"/></tstamp>
        <xslt
            classpathref="xslt.classpath"
            force="true"
            in="${testpath}/${test}.jtl"
            out="${testpath}/${test}.html"
            style="${basedir}/jmeter-results-detail-report${style_version}.xsl">
            <param name="showData" expression="${show-data}"/>
            <param name="titleReport" expression="${report.title}"/>
            <param name="dateReport" expression="${report.datestamp}"/>
        </xslt>
    </target>

　　

　　2、通过上面的分析，style 文件是整成报告转换的关键，那我们就打开jmeter-results-detail-report_21.xsl这个文件看看，找到如下几行，这里也定义了三个参数跟build.xml文件中一样，由此可猜测，我们只要在build.xml文件中定义dateReport这个参数和值，在style中就可以按如下方式使用，经过测试证明猜测是正确的，那么第一个问题就解决了：

1 <xsl:param    name="showData" select="'n'"/>
2 <xsl:param    name="titleReport" select="'Load Test Results'"/>
3 <xsl:param    name="dateReport" select="'date not defined'"/>

　　

　　3、对于第二个问题，其实把第1步中的代码复制到我们自己的build.xml文件中后，可以一并解决这两个问题。解决第二个总是的关键代码是第9行和第10行：

　　classpathref="xslt.classpath"

　　force="true"

　　而第9行又引用了第1~4行

 

　　4、到此，两个问题都解决了，最终修改后的build.xml文件如下，标黄是解决总是添加的代码：

<?xml version="1.0" encoding="UTF-8"?>
<project name="ant-jmeter-test" default="run" basedir=".">
    <!-- 需要改成自己本地的 Jmeter 目录-->  
    <property name="jmeter.home" value="/Users/Tools/Jmeter" />
    <property name="report.title" value="接口测试"/>
    <!-- jmeter生成jtl格式的结果报告的路径--> 
    <property name="jmeter.result.jtl.dir" value="/Users/Desktop/jmx/report" />
    <!-- jmeter生成html格式的结果报告的路径-->
    <property name="jmeter.result.html.dir" value="/Users/Desktop/jmx/report" />
    <!-- 生成的报告的前缀-->  
    <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" />

    <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="/Users/Desktop/jmx" 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>

</project>

　　5、修改后的报告：

　　

 

 

参考：

1、http://rainbow702.iteye.com/blog/2159244

2、http://www.programmerplanet.org/projects/jmeter-ant-task/

▶