jmeter+ant+jenkins框架搭建问题

工具介绍：

•   jmeter

      接口编写，调试，执行。

•   ant

      Ant是Java的生成工具，都是用来编译、生成；Ant的主要目的就是把你想做的事情自动化，不用你手动一步一步做，因为里面内置了javac、java、创建目录、复制文件等功能，所以可以直接点击Ant文件，即可编译生成你的项目。

      Ant由一个内置任务和可选任务组成的。Ant运行时需要一个XML文件(构建文件)。 Ant通过调用target树，就可以执行各种task。

      在这个框架内，ant通过xml构建文件创建一个项目。这个项目执行了1、运行jmeter脚本的任务；2、生成测试记录和测试结果报告。

• jenkins

      执行ant的build文件，何时执行，执行记录等。也就是说，如果不需要记录版本等，用ant+jmeter即可完成简单的自动化接口构架。

 

主要配置：

1、让ant运行jmeter脚本

     将jmeter的extras文件中ant-jmeter-1.1.1.jar包拷贝至ant安装目录下的lib目录中，该包相当于是ant和jmeter连接的桥梁，作用是使Ant运行时能够找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类，从而成功触发JMeter脚本。

 

 2、优化报告内容

    Jmeter默认的报告展示的信息比较少，不是很方便定位问题。要查看构建的详细信息，需要另行设置。

   修改Jmeter的bin目录下jmeter.properties文件的配置。

    1、jmeter.save.saveservice.output_format=csv修改为xml。作用是使Jmeter报告输出文件格式为xml。这一步很重要，不修改会导致格式报错。

    2、下列设置全部设置为true，即全部显示在文件内。这样执行完脚本后就会保存这些结果到.jtl文件里面。这属于优化内容。可根据需求设置。

 

  3、给ant创建build文件

      build.xml：Ant根据该文件运行jmeter脚本（关键文档，需要配置正确）

     主要作用就是把生成的.jtl数据文件转换为.html格式的报告。（前提：下载style文件jmeter.results.shanhe.me.xsl放到jmeter的extras目录下）

     网上代码很多，可根据需求摘取。

 

<?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:\Work\jmeter\apache-jmeter-5.1.1\extras" /> 
    <!-- 需要改成自己本地的 Jmeter 目录-->   
    <property name="jmeter.home" value="D:\Work\jmeter\apache-jmeter-5.1.1" /> 
    <!-- jmeter生成jtl格式的结果报告的路径-->  
    <property name="jmeter.result.jtl.dir" value="E:\java\JmeterTest\resultLog\jtl" /> 
    <!-- jmeter生成html格式的结果报告的路径--> 
    <property name="jmeter.result.html.dir" value="E:\java\JmeterTest\resultLog\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" /> 
       
    <path id="xslt.classpath"> 
        <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/> 
        <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/> 
    </path> 
    
   <!--主要执行任务，包括2个子任务-->      
    <target name="run"> 
        <antcall target="test" /> 
        <antcall target="report" /> 
    </target> 
       
       
     <!--test任务-->    
    <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="E:\工作内容\测试项目\配置中心测试2.0" includes="配置中心接口自动化测试.jmx" /> 
        
            
        </jmeter> 
    </target> 
         
     <!--report任务-->      
    <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="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>

     具体属性的含义：

    in：生成的.jtl文件的路径

    out：生成的.html文件的路径

    style：从.jtl转换成.html所使用的样式，这些文件也在extras目录下，上文中写的前提内容。

  4、Jenkins配置

 

 

  5、Jenkins执行成功后，查看html报告

 

 

常见问题

1、保存文件问题

报这样的错误是因为 ：jmeter默认保存的是csv格式的文件，需要修改成xml格式。将jmeter.properties文件中#jmeter.save.saveservice.output_format=csv改为jmeter.save.saveservice.output_format=xml （#也要去掉）。

2、响应乱码导致构建失败

接口实际返回的是excel文档，响应信息出现乱码问题。导致jenkins构建报错。

 

 去jtl文件内查看，是有乱码问题

 

 

解决方案：导出文件内容存到本地，修改responsdata。jmeter导出请求后加BeanShell或者JSR223 后置处理器，代码如下：

//将导出内容存到本地
byte[] result=prev.getResponseData();
String file_name="E:\\jmeter脚本\\apitest\\TerminalDevicePoint.xlsx";
File file =new File(file_name);
FileOutputStream out = new FileOutputStream(file); 
out.write(result);
out.close();
//修改responsedata内容
if(file.exists())
{
    prev.setResponseData("导出成功","utf-8");
    log.warn("导出成功");    
    }
    else
    {
        prev.setResponseData("导出失败","utf-8");
        log.warn("导出失败");
        }