接口功能测试之jmeter+Ant测试结果优化

写在前面：

jmeter的自带的测试报告格式偏向于性能测试形式，那如果进行接口功能测试，想去查问题并追溯每一个接口的请求、响应呢？
那就需要对jmeter默认的结果进行优化，这里使用的原始结果采用xml格式（因为csv格式不支持显示响应结果）。

首先需要配置jmeter报告的属性，打开bin目录的jmeter.properties
修改如下的一行(去掉注释标识符#)

jmeter.save.saveservice.output_format=xml

然后执行jmeter NoGUIDriver:命令如下：

./jmeter -n -t /test.jmx -l ./result_jtl/test_result.jtl -e -o ./test_report

执行命令后报错了：

Error in NonGUIDriver java.lang.IllegalArgumentException: Report generation requires csv output format, check 'jmeter.save.saveservice.output_format' property

查了下报错的原因，原因是如果命令行执行必须要csv格式。
但是对于需要查看接口的响应结果，必须使用xml格式（jmeter.properties注释中说明了response_data is not currently supported for CSV output），那么怎么使结果生成为xml格式呢？

这就需要用到Ant，就是我们的重头戏咯～～～

二、配置Ant

1、mac上如果安装了brew，可以直接用“brew install ant”来安装ant,安装完成后安装文件在目录/usr/local/Cellar/ant/

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

3、修改bin目录的jmeter.properties，修改如下的一行(去掉注释标识符#)
jmeter.save.saveservice.output_format=xml

4、配置ant的环境变量，首先“cd ～”回到home目录，然后输入命令“open -e .bash_profile”，打开了配置用户环境变量的文件，增加如下配置保存

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_77.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export ANT_HOME=/usr/local/Cellar/ant/1.10.0
export PATH=${PATH}:${ANT_HOME}/bin

5、配置ant的build.xml文件，新建一个build文件，可以放到任意目录，到时候执行的时候，先切换工作目录到build.xml文件所在目录，再使用“ant -buildfile build.xml”命令执行jmeter

需要修改的地方下面有详细注释

<?xml version="1.0" encoding="utf-8"?>
<project name="ant-jmeter-test" default="run" basedir=".">
    <!-- 需要改成自己本地的 Jmeter 目录-->  
    <property name="jmeter.home" value="/Users/fish/gf/08.autotest/apache-jmeter-4.0" />
    <property name="report.title" value="wjs-test"/>
    <!-- jmeter生成jtl格式的结果报告的路径--> 
    <property name="jmeter.result.jtl.dir" value="/Users/fish/gf/autotest接口用例/ant-build/jmeter_result" />
    <!-- jmeter生成html格式的结果报告的路径-->
    <property name="jmeter.result.html.dir" value="/Users/fish/gf/autotest接口用例/ant-build/jmeter_result" />
    <!-- 生成的报告的前缀-->  
    <property name="ReportName" value="wjs-test" />
    <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}.jtl" />
    <property name="jmeter.result.htmlNamedetail" value="${jmeter.result.html.dir}/${ReportName}detail.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/fish/gf/autotest接口用例/" 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.htmlNamedetail}"
              <!-- 生成报告的模板文件，需要拷贝到jmeter安装文件extras目录下-->
              style="${jmeter.home}/extras/jmeter.results.shanhe.me3.xsl">
              <param name="dateReport" expression="${report.datestamp}"/>
              <param name="titleReport" expression="${report.title}:${detailreport.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>

6、修改jmeter安装目录bin下面的jmeter.properties文件，将输出内容格式改成xml，将其他修改为true

三、执行测试

切换工作目录到build.xml文件所在目录，再使用“ant -buildfile build.xml”命令执行jmeter

执行成功后，会生成2个结果，一个为jtl文件，一个为html的报告（报告的内容为样式文件jmeter.results.shanhe.me3.xsl定义的格式，可以自行修改）