Jenkins+Jmeter持续集成笔记（二：ANT执行Jmeter脚本）

Jmeter接口测试脚本运行后生成的是jtl（xml）格式的文件，这些文件不具备可读性，所以我们要把他转化为可以阅读的html格式报告。

Ant是一个功能强大的打包编译工具。我们使用他的目的是将xml文件转化为html格式的文件。

1、安装ANT

（1）下载ANT安装包到/usr/ant目录

wget https://mirrors.cnnic.cn/apache/ant/binaries/apache-ant-1.9.9-bin.tar.gz

（上传ant目录不存在时提前创建）

（2）解压安装

tar -xvf apache-ant-1.9.-bin.tar.gz

（3）新建ant环境变量

# vim /etc/profile

在文件末尾添加如下内容

export ANT_HOME=/usr/ant/apache-ant-1.9.9
  export PATH=$PATH:$JAVA_HOME/bin:$ANT_HOME/bin

使添加的内容生效

# source /etc/profile 

（4）检查是否安装成功

# ant -version

重要配置：

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

这一步操作使Ant运行时能够找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类，从而成功触发JMeter脚本

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

这一步操作使Jmeter报告输出文件格式为xml

2、准备Jmeter测试脚本

请参见我关于jmeter脚本编写的其他文章 http://www.cnblogs.com/LiangHu/tag/Jmeter/

我的测试脚本如下图所示：test_token.jmx

3、用Ant执行脚本

（1）在jmeter安装目录下新建两个文件夹

TestReport文件夹：用于保存html的结果报告；

TestScrip文件夹：用于保存jmeter的测试脚本。

（2）ant执行jmeter脚本原理

ant工具主要是根据build.xml文件来进行工作的，官方给出的默认文件在Jmeter的安装目录下extras文件夹中。

你可以在该目录下直接输入命令ant看一下效果：

构建时，ant执行的是该目录下Test.jmx脚本，执行完毕后把输出的报告Test.jtl文件转化为Test.html文件

从图上可以看出生成了这两个测试报告文件。希望可以从这个过程中能够大概了解ant执行jmeter脚本的原理。

测试报告使用默认的样式，如下图所示：

（3）修改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="/usr/jmeter/apache-jmeter-3.3" />
     <!-- jmeter生成jtl格式的结果报告的路径-->
     <property name="jmeter.result.jtl.dir" value="/usr/jmeter/apache-jmeter-3.3/TestReport/testToken/jtl" />
     <!-- jmeter生成html格式的结果报告的路径-->
     <property name="jmeter.result.html.dir" value="/usr/jmeter/apache-jmeter-3.3/TestReport/testToken/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" />
     <!-- 输出生成的报告名称和存放路径-->
     <echo message="${jmeter.result.jtlName}"/>
     <echo message="${jmeter.result.htmlName}"/>
     <echo message="${jmeter.result.html.dir}"/>

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

     <!--加载jar包,解决显示时间问题-->
     <path id="xslt.classpath">
         <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/>
         <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>
     </path> 

     <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/jmeter/apache-jmeter-3.3/TestScrip" includes="test_token.jmx" />

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

     <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.shanhe.me.xsl">
               <!--显示dateReport的时间-->
               <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>

说明：

文件中style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl"指的是测试报告采用的样式。读者可以在jmeter安装目录下extras文件夹里看到前缀类似jmeter-results-report的文件，不妨挨个替换进style的值，执行完测试脚本后看一下输出的测试报告样式。

jmeter.results.shanhe.me.xsl该样式是我从网上下载的，默认的报告样式展示的信息比较少不适合我的项目而已，下载好上传到extras文件夹即可。

（这个build.xml文件基本可以作为模板使用，只要你按照自己当前的环境改一下文件中少量配置即可。）

（4）上传测试脚本test_token.jmx和build.xml文件到TestScrip目录下

（5）ant命令执行测试脚本

进入TestScrip目录，输入：ant run（run为build.xml中的target的name名）

（6）查看测试报告

根据bulid.xml文件中定义的测试报告路径，进入相应目录即可找到测试报告文件。

  <!-- jmeter生成html格式的结果报告的路径-->
  <property name="jmeter.result.html.dir" value="/usr/jmeter/apache-jmeter-3.3/TestReport/testToken/html" />

在这里可以看到报告中的request和response两项没有数据。修改jmeter/bin目录下jmeter.properties文件如下部分，我这里都修改成true，这样执行完脚本后就会保存这些结果到.jtl文件里面：

jmeter.save.saveservice.data_type=true
jmeter.save.saveservice.label=true
jmeter.save.saveservice.response_code=true
# response_data is not currently supported for CSV output
jmeter.save.saveservice.response_data=true
# Save ResponseData for failed samples
jmeter.save.saveservice.response_data.on_error=false
jmeter.save.saveservice.response_message=true
jmeter.save.saveservice.successful=true
jmeter.save.saveservice.thread_name=true
jmeter.save.saveservice.time=true
jmeter.save.saveservice.subresults=true
jmeter.save.saveservice.assertions=true
jmeter.save.saveservice.latency=true
jmeter.save.saveservice.connect_time=true
jmeter.save.saveservice.samplerData=true
jmeter.save.saveservice.responseHeaders=true
jmeter.save.saveservice.requestHeaders=true
jmeter.save.saveservice.encoding=false
jmeter.save.saveservice.bytes=true
jmeter.save.saveservice.url=true
jmeter.save.saveservice.filename=true
jmeter.save.saveservice.hostname=true
jmeter.save.saveservice.thread_counts=true
jmeter.save.saveservice.sample_count=true
jmeter.save.saveservice.idle_time=true

接下来将介绍如何把以上的操作使用jenkins来做持续集成，请关注后续文章。