Jmeter+Ant+Jenkins接口自动化框架

　　最近应公司要求，搭建一套接口自动化环境。看到通知邮件，没有多想就确定了Jmeter路线。可能有些人会

说，为啥不用python，相对而言高大上一些。因为公司内部现在项目有用到Jmeter，正好可以结合利用，适合自

己才是最好的嘛。整体思路是Jmeter可以做压力测试，也可以做接口测试；Ant是基于Java的构建工具，完成脚

本执行收集结果并生成报告；Jenkins也是基于Java开发的持续集成工具。

JDK安装

下载安装包，解压到安装目录，本次用的是jdk1.8版本。

下载地址：https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html

设置环境变量

JAVA_HOME:D:\jdk\jdk1.8.0_20_64
Path:%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
CLASSPATH:.;%JAVA_HOME%lib;%JAVA_HOME%lib\tools.jar（注意最前面的.）

安装结果验证

在命令行窗口输入 java -version 然后回车，出现对应的jdk版本即为安装成功。

Jmeter安装

下载安装包，解压到自己电脑的安装目录，鉴于之前有人说找不到老版本下载地址，借此贴出来。

最新版本下载：http://jmeter.apache.org/download_jmeter.cgi

历史版本下载：https://archive.apache.org/dist/jmeter/binaries/

设置环境变量

JMETER_HOME:D:\apache-jmeter-3.1
CLASSPATH:%JMETER_HOME%\lib\ext\ApacheJMeter_core.jar;%JMETER_HOME%\lib\jorphan.jar;
Path:%JMETER_HOME%\bin

安装结果验证

在命令行窗口输入 jmeter -v 然后回车，出现对应的版本即为安装成功，我这里用的是自己安装的命令行工具。

Ant安装

下载安装包，解压到安装目录。本次使用的是1.10.8版本，大家可以根据需要选择。

下载地址：http://ant.apache.org/bindownload.cgi

设置环境变量

ANT_HOME:D:\apache-ant-1.10.8
CLASSPATH:%ANT_HOME%\lib;
PATH:%ANT_HOME%\bin;

安装结果验证

在命令行窗口输入 ant -v 然后回车，出现对应安装版本即为成功。

本地调试使用ant构建运行jmeter脚本

配置运行文件

将jmeter>>>extras目录下的 ant-jmeter-1.1.1.jar 文件拷贝到ant安装目录下的lib文件夹中，这样Ant运行

时才能找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类，从而成功触发JMeter脚本。

配置报告输出格式

jmeter默认保存的是csv格式的文件，我们要将其改为xml格式。在jmeter的bin目录下找到jmeter.properties并

编辑，这里建议大家用vsCode或者Notepad打开。

配置编译文件

在ant的安装目录下，新建build.xml文件，然后修改文件内容。注意：在jmeter的extras目录下也有个

build.xml文件，不要修改成这个文件。ant目录下这个文件是需要你自己新建并修改的。下面给出一份

推荐build内容供参考，主要修改里面的jmeter版本、指定报告路径以及运行脚本路径。

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

<project name="ant-jmeter-test" default="run" basedir=".">  

    <tstamp>
        <format property="time" pattern="yyyyMMddhhmm" />
    </tstamp>
    <property name="basedirectory" value="D:\Jmeter\apache-jmeter-5.2.1\extras" />
    <!-- 需要改成自己本地的 Jmeter 目录-->
    <property name="jmeter.home" value="D:\Jmeter\apache-jmeter-5.2.1" />
    <!-- jmeter生成jtl格式的结果报告的路径-->
    <property name="jmeter.result.jtl.dir" value="D:\autotest\result\jtl" />
    <!-- jmeter生成html格式的结果报告的路径-->
    <property name="jmeter.result.html.dir" value="D:\autotest\result\html" />
    <!-- Name of test (without .jmx) -->
    <property name="test" value="Test"/>
    <!-- 生成的报告的前缀-->
    <property name="ReportName" value="TestReport" />
    <!--property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${time}.jtl" />
    <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${time}.html" /-->
    <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${time}.jtl"/>
    <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/DetailReport${time}.html"/>
    <property name="jmeter.result.htmlName2" value="${jmeter.result.html.dir}/SummaryReport${time}.html"/>

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

    <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:\autotest\script" includes="*.jmx" />
        </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">
              <param name="reportDate" expression="${report.datestamp}"/>
        </xslt>
        <xslt classpathref="xslt.classpath"
              force="true"

              in="${jmeter.result.jtlName}"
              out="${jmeter.result.htmlName2}"
              style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl">
              <param name="showData" expression="${show-data}"/>
              <param name="titleReport" expression="${ReportName}${time}"/>
              <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>

执行测试并查看结果

在build.xml所在目录(我这里就是ant的安装目录)打开命令行窗口，输入 ant 然后回车，执行成功

会出现如下所示内容。

打开build.xml文件中指定的结果存放路径，查看是否生成了html和jtl文件。

优化测试报告

由于jmeter原始的测试报告信息不太符合项目需要，我对报告模板做了简单修改，大家可以根据

实际情况再次调整。

下载地址：https://pan.baidu.com/s/1TwCe9cPgxmr55NUN4zWeKA

提取码：g8wc

下载完成，将文件放入jmeter extras目录下，打开build.xml文件，设置文件路径。

打开jmeter.properties文件，设置测试报告的输出内容，将需要的结果置为true并去掉#。

配置Jenkins构建持续集成

下载安装Jenkins，本文不做详细介绍，大家可自行百度。

下载地址：https://jenkins.io/zh/download/，安装完成配置环境变量 JENKINS_HOME:D:\Jenkins

Jenkins服务默认端口为8080，如果出现端口冲突，可在Jenkins安装目录jenkins.xml文件中修改。

配置JDK和Ant环境

在浏览器中输入：http://127.0.0.1:8585，进入Jenkins主页，配置用户名、密码和插件。根据项目需要，我这里

需要安装HTML Publisher Plugin和Ant Plugin。在Manage Jenkins>>>Manage Plugin中搜索这两个插件并安装，

然后在Manage Jenkins>>>Global Tool Configuration中配置JDK和Ant的工作路径。

配置工作项目

在Jenkins主页点击New Item，输入项目名称，选择Freestyle project，点击ok会进入到项目配置页面。因

为我已经建好了项目，这里会提示项目名称已存在，项目名称建议大家用英文。

进入到项目配置页面，我们目前需要修改一些配置。Discard old builds(丢弃旧的构建)：为了避免多余

的构建日志、临时文件占磁盘空间，需要定期的清除过期文件。我这里配置保留5天内的构建文件，保

持最大构建个数不限。

Build Triggers(构建触发器)用来设置定时任务，其语法是由“* * * * *”构成，中间空格隔开。

第一颗*表示分钟，取值0~59
第二颗*表示小时，取值0~23
第三颗*表示一个月的第几天，取值1~31
第四颗*表示第几月，取值1~12
第五颗*表示一周中的第几天，取值0~7，其中0和7代表的都是周日

Build模块需要增加Invoke Ant，其中Ant Version的值要与上面在Jenkins中设置名称一致；Build File

填写我们新建的build.xml文件所在的路径。

Post-build Actions(构建后操作)目前先配置一下报告存放路径，此路径要与build.xml文件中报告存放

路径一致，否则无法在Jenkins中查看测试报告，Report title默认不做更改。

写在最后的话

至此，一套简单的接口自动化框架搭起来了，期间也踩了很多坑。由于技术能力有限，这个框架

扩展功能还在研究中，有实用的功能后续再做补充。