jmeter+ANT接口自动化测试框架

项目说明

  • 本框架是一套基于jmeter+Ant+Excel+Python而设计的数据驱动接口自动化测试框架，jmeter 作为执行器，Ant 作为构建工具，进行构建测试，本框架无需你使用代码编写用例，测试用例存储在csv中，在csv中可以进行接口用例编写，接口断言，用例运行控制。

技术栈

  • jmeter
  • Ant
  • Python

环境部署

1、安装JDK
2、安装Jmeter
3、安装 ANT
  • 1、解压apache-ant-1.10.5-bin.zip到任意目录，比如 E:\apache-ant-1.10.5
  • 2、windows中配置ANT环境变量，如下为我的配置


    
 
  1. 
  
    ANT_HOME E:\apache-ant-1.10.5
    2. 
 
  2. 
  
    Path E:\apache-ant-1.10.5\bin
    3. 
 
  3. 
  
    CLASSPATH E:\apache-ant-1.10.5\lib
    4. 



    
 
  • 3、ANT安装验证
    
   验证安装结果，命令行输入ant -v ，出现版本信息则安装成功，如图 
  
    • 



4、ANT与Jmeter集成


    
 
  • 
  
    1、配置库文件
    
    将jmeter\extras目录下的ant-jmeter-1.1.1.jar 文件拷贝到ant安装目录下的lib文件夹中，如图
    
  
    • 
 
  • 
  
    2、配置ANT与Jmeter的配置文件
    
    新建ant的编译文件，命名为 build.xml，其内容如下：
    • 







    
 
  1. 
  
    <?xml version="1.0" encoding="UTF-8"?>
    2. 
 
  2. 
 
  3. 
  
    <project name="ant-jmeter-test" default="run" basedir=".">
    4. 
 
  4. 
  
    <tstamp>
    5. 
 
  5. 
  
    <format property="time" pattern="yyyy_MM_dd_HH_mm" />
    6. 
 
  6. 
  
    </tstamp>
    7. 
 
  7. 
  
    <!-- 需要改成自己本地的 项目路径根 目录，即jmeter安装文件所在的目录--> 
    8. 
 
  8. 
  
    <property name="project.home" value="..\" />
    9. 
 
  9. 
  
    <!-- 需要改成自己本地的 Jmeter 目录--> 
    10. 
 
  10. 
  
    <property name="jmeter.home" value="${project.home}\apache-jmeter-3.2" />
    11. 
 
  11. 
  
    <!-- jmeter生成jtl格式的结果报告的路径--> 
    12. 
 
  12. 
  
    <property name="jmeter.result.jtl.dir" value="${project.home}\report\jtl" />
    13. 
 
  13. 
  
    <!-- jmeter生成html格式的结果报告的路径-->
    14. 
 
  14. 
  
    <property name="jmeter.result.html.dir" value="${project.home}\report\html" />
    15. 
 
  15. 
  
    <!-- 生成的报告的前缀--> 
    16. 
 
  16. 
  
    <property name="ReportName" value="TestReport" />
    17. 
 
  17. 
  
    <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}_${time}.jtl" />
    18. 
 
  18. 
  
    <property name="jmeter.result.all_htmlName" value="${jmeter.result.html.dir}/All_Report/All${ReportName}_${time}.html" />
    19. 
 
  19. 
  
    <property name="jmeter.result.detail_htmlName" value="${jmeter.result.html.dir}/Detail_Report/Detail${ReportName}_${time}.html" /> 
    20. 
 
  20. 
 
  21. 
  
    <target name="run">
    22. 
 
  22. 
  
    <antcall target="test" />
    23. 
 
  23. 
  
    <antcall target="report" />
    24. 
 
  24. 
  
    </target>
    25. 
 
  25. 
 
  26. 
  
    <target name="test">
    27. 
 
  27. 
  
    <taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
    28. 
 
  28. 
  
    <jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
    29. 
 
  29. 
  
    <!-- 声明要运行的目录和脚本。"*.jmx"指包含此目录下的所有jmeter脚本-->
    30. 
 
  30. 
  
    <testplans dir="${project.home}\jmeter_Code" includes="*.jmx" />
    31. 
 
  31. 
 
  32. 
  
    <property name="jmeter.save.saveservice.output_format" value="xml"/>
    33. 
 
  33. 
  
    </jmeter>
    34. 
 
  34. 
  
    </target>
    35. 
 
  35. 
 
  36. 
  
    <path id="xslt.classpath">
    37. 
 
  37. 
  
    <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/>
    38. 
 
  38. 
  
    <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>
    39. 
 
  39. 
  
    </path>
    40. 
 
  40. 
 
  41. 
  
    <target name="report">
    42. 
 
  42. 
  
    <tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /></tstamp> 
    43. 
 
  43. 
  
    <xslt 
    44. 
 
  44. 
  
    classpathref="xslt.classpath"
    45. 
 
  45. 
  
    force="true"
    46. 
 
  46. 
 
  47. 
  
    in="${jmeter.result.jtlName}"
    48. 
 
  48. 
  
    out="${jmeter.result.all_htmlName}"
    49. 
 
  49. 
  
    style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl" /> 
    50. 
 
  50. 
 
  51. 
  
    <xslt 
    52. 
 
  52. 
  
    classpathref="xslt.classpath"
    53. 
 
  53. 
  
    force="true"
    54. 
 
  54. 
 
  55. 
  
    in="${jmeter.result.jtlName}"
    56. 
 
  56. 
  
    out="${jmeter.result.detail_htmlName}"
    57. 
 
  57. 
  
    style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl" /> 
    58. 
 
  58. 
 
  59. 
  
    <!-- 因为上面生成报告的时候，不会将相关的图片也一起拷贝至目标目录，所以，需要手动拷贝 --> 
    60. 
 
  60. 
  
    <copy todir="${jmeter.result.html.dir}/All_Report">
    61. 
 
  61. 
  
    <fileset dir="${jmeter.home}/extras">
    62. 
 
  62. 
  
    <include name="collapse.png" />
    63. 
 
  63. 
  
    <include name="expand.png" />
    64. 
 
  64. 
  
    </fileset>
    65. 
 
  65. 
  
    </copy>
    66. 
 
  66. 
  
    </target> 
    67. 
 
  67. 
 
  68. 
  
    </project>
    69. 







    
 
  • 按实际情况修改build.xml文件，相关说明如下 
  
       
  
    • 



    
 
  • 3、配置jmeter.properties 
  
      
   
    • 配置jmeter报告输出格式为xml。在jmeter根目录下apache-jmeter-3.2\bin\jmeter.properties文件中修改 jmeter.save.saveservice.output_format=csv 为 jmeter.save.saveservice.output_format=xml，并去掉前面的注释符号#，如图所示 
    
      • 
  
    • 



框架代码与用例设计及相关说明


1、用例设计


    
 
  • 测试用例保存在csv文件中，如图所示 
  
    • 



2、脚本代码说明


    
 
  • 
  
    测试计划中定义用户变量，以供后面的脚本使用，如图
    
  
    • 
 
  • 
  
    循环控制器设置永远循环，如图
    
  
    • 
 
  • 
  
    循环控制器下新增CSV Data Set ConFig控件，循环读取用例文件中的测试用例，如图
    
  
    • 
 
  • 
  
    Allow quoted data?：是否允许带双引号的数据
    • 



    
 
  1. 此项实际是控制csv文件中的双引号是否为有效字符；
    2. 
 
  2. 如果数据带有双引号且此项设置TRUE，则会自动去掉数据中的引号使能够正常读取数据，且即使引号之间的内容包含有分隔符时，仍作为一个整体而不进行分隔；
    3. 
 
  3. 如果数据带有引号且此项设置为FALSE，则读取数据报错；
    4. 
 
  4. 如果希望双引号字段中间再包含双引号，则需要加两个双引号来代表单个双引号。
    5. 
 
  5. 比如此项设置为true时，"2,3"-->2,3；"4""5"-->4"5
    6. 



    
 
  • Sharing mode：共享模式
    • 



    
 
  1. All threads：针对所有线程组的所有线程，每个线程取值不一样，依次取csv文件中的下一行。即不管是单个线程组还是多个线程组，每个线程都是依次取下一行。
    2. 
 
  2. Current thread group：当前线程组。以线程组为单位，每个线程组内的线程都会从第1行开始取值并依次往下进行取值。
    3. 
 
  3. Current thread：当前线程。每个线程都会从第1行开始取值并依次往下进行取值，在同一次循环中所有的线程取值一样。
    4. 



    
 
  • 
  
    添加执行控制器，筛选测试用例执行，如下，可执行所有用例、可执行其中某部分用例、也可按用例的优先级执行测试用例。
    
  
    • 
 
  • 
  
    根据调用方法选择请求方式
    
    通过if选择器区分GET与POST方法的请求，配置http请求，如图
    
  
    • 



    
 
  • Post请求的配置方式 ：post请求参数放在body data中 
  
    • 
 
  • 响应结果配置如图 
  
    • 
 
  • Get 请求的配置方式：get请求的参数配置url后面，如图 
  
    • 



    
 
  • 结合Python发送测试报告到邮箱
    • 







    
 
  1. 
  
    #encoding=utf-8
    2. 
 
  2. 
 
  3. 
  
    import time
    4. 
 
  4. 
  
    import smtplib
    5. 
 
  5. 
  
    import email
    6. 
 
  6. 
  
    from email.mime.text import MIMEText
    7. 
 
  7. 
  
    from email.mime.multipart import MIMEMultipart
    8. 
 
  8. 
  
    import sys
    9. 
 
  9. 
  
    import os.path 
    10. 
 
  10. 
  
    reload(sys)
    11. 
 
  11. 
  
    sys.setdefaultencoding('utf-8')
    12. 
 
  12. 
 
  13. 
  
    #收件箱，如果是list请以逗号分隔
    14. 
 
  14. 
  
    mailto_list=['testXXX1@126.com','testXXX2@126.com']
    15. 
 
  15. 
  
    #发件箱
    16. 
 
  16. 
  
    mail_host="smtp.126.com"
    17. 
 
  17. 
  
    mail_user="XXXXtest"
    18. 
 
  18. 
  
    mail_pass="XXXXXX"
    19. 
 
  19. 
  
    mail_postfix="126.com"
    20. 
 
  20. 
 
  21. 
  
    def send_mail(attfile1, attfile2):
    22. 
 
  22. 
 
  23. 
  
    today = time.strftime('%Y-%m-%d',time.localtime(time.time()))
    24. 
 
  24. 
  
    detailTime = time.strftime('%H:%M:%S',time.localtime(time.time()))
    25. 
 
  25. 
  
    todaytime = today + ' 00:00:00'
    26. 
 
  26. 
  
    selectres = todaytime
    27. 
 
  27. 
  
    send_header = "[demo项目][线上环境][自动化用例测试报告]- ".encode("utf-8") + today +" "+detailTime
    28. 
 
  28. 
  
    me= mail_user+"@"+mail_postfix
    29. 
 
  29. 
  
    msg = MIMEMultipart()
    30. 
 
  30. 
  
    msg['Subject'] = send_header
    31. 
 
  31. 
  
    msg['From'] = me
    32. 
 
  32. 
  
    msg['To'] = ";".join(mailto_list)
    33. 
 
  33. 
 
  34. 
  
    #正文
    35. 
 
  35. 
  
    fp = open(attfile1,"r")
    36. 
 
  36. 
  
    content1 = fp.read()
    37. 
 
  37. 
  
    fp.close()
    38. 
 
  38. 
 
  39. 
  
    content2 = '<html><h3>测试结果及更多详情请查看邮件附件【All_Report.html】和【Detail_Report.html】!!!</h3></html>'
    40. 
 
  40. 
 
  41. 
  
    msg.attach(MIMEText(content1 + content2, 'html', 'utf-8'))
    42. 
 
  42. 
 
  43. 
  
    #总体报告目录
    44. 
 
  44. 
  
    att1 = MIMEText(open(attfile1, 'rb').read(), 'base64', 'gb2312')
    45. 
 
  45. 
  
    att1["Content-Type"] = 'application/octet-stream'
    46. 
 
  46. 
  
    att1["Content-Disposition"] = 'attachment; filename="All_Report.html"'
    47. 
 
  47. 
  
    msg.attach(att1)
    48. 
 
  48. 
 
  49. 
  
    #详细报告目录
    50. 
 
  50. 
  
    att2 = MIMEText(open(attfile2, 'rb').read(), 'base64', 'gb2312')
    51. 
 
  51. 
  
    att2["Content-Type"] = 'application/octet-stream'
    52. 
 
  52. 
  
    att2["Content-Disposition"] = 'attachment; filename="Detail_Report.html"'
    53. 
 
  53. 
  
    msg.attach(att2)
    54. 
 
  54. 
 
  55. 
  
    try:
    56. 
 
  56. 
  
    server = smtplib.SMTP()
    57. 
 
  57. 
  
    server.connect(mail_host)
    58. 
 
  58. 
  
    server.ehlo()
    59. 
 
  59. 
  
    server.starttls()
    60. 
 
  60. 
  
    server.login(mail_user,mail_pass)
    61. 
 
  61. 
  
    server.sendmail(me, mailto_list, msg.as_string())
    62. 
 
  62. 
  
    server.quit()
    63. 
 
  63. 
  
    return True
    64. 
 
  64. 
  
    except Exception, e:
    65. 
 
  65. 
  
    print str(e)
    66. 
 
  66. 
  
    return False
    67. 
 
  67. 
 
  68. 
  
    #======查找测试报告目录，找到最新生成的测试报告文件====
    69. 
 
  69. 
  
    def new_report(testreport):
    70. 
 
  70. 
  
    result_dir = testreport
    71. 
 
  71. 
  
    #获取该目录下的所有文件，将文件存到列表lists里
    72. 
 
  72. 
  
    lists=os.listdir(result_dir)
    73. 
 
  73. 
  
    #重新按时间先后对目录下（列表lists里）的文件进行排列，最新文件排末尾
    74. 
 
  74. 
  
    lists.sort(key=lambda fn: os.path.getmtime(result_dir+"\\"+fn))
    75. 
 
  75. 
  
    #找到最新生成的文件，并加上路径，lists(-1)倒数第一个
    76. 
 
  76. 
  
    file_new = os.path.join(result_dir,lists[-1])
    77. 
 
  77. 
  
    return file_new
    78. 
 
  78. 
 
  79. 
  
    if __name__ == '__main__':
    80. 
 
  80. 
 
  81. 
  
    report_dir1 = "../report/html/Detail_Report" #详细报告目录
    82. 
 
  82. 
  
    report_dir2 = "../report/html/All_Report" #总体报告目录
    83. 
 
  83. 
 
  84. 
  
    #找到生成的最新的测试报告
    85. 
 
  85. 
  
    file_new1 = new_report(report_dir1)
    86. 
 
  86. 
  
    file_new2 = new_report(report_dir2)
    87. 
 
  87. 
  
    print(file_new2)
    88. 
 
  88. 
 
  89. 
  
    if send_mail(file_new2, file_new1):
    90. 
 
  90. 
  
    print u"测试报告邮件发送成功！"
    91. 
 
  91. 
  
    else: 
    92. 
 
  92. 
  
    print u"测试报告邮件发送失败！"
    93. 



3、执行测试，查看结果


    
 
  • 
  
    build配置文件放在与测试脚本同目录下
    
  
    • 
 
  • 
  
    执行测试
    • 



    
 
  1. 命令行cd到build.xml文件所在目录，输入 ant run ，执行测试，如图 
  
    2. 
 
  2. 看到build successful 则说明构建测试成功
    3. 



    
 
  • 测试报告
    • 



    
 
  1. 概要报告如下 
  
    2. 
 
  2. 详细报告如下 
  
       
  
    3. 



 


总结：


感谢每一个认真阅读我文章的人！！！


作为一位过来人也是希望大家少走一些弯路，如果你不想再体验一次学习时找不到资料，没人解答问题，坚持几天便放弃的感受的话，在这里我给大家分享一些自动化测试的学习资源，希望能给你前进的路上带来帮助。




软件测试面试文档


我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。




   视频文档获取方式：

  这份文档和视频资料，对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！以上均可以分享，点下方小卡片即可自行领取
 
  

        # jmeter
      
  
 
 Logo 
EazyDevelop社区
 
一站式 AI 云服务平台
 
 
  
更多推荐
  
cover
 
5分钟搞定！MySQL/PostgreSQL 到 Elasticsearch 的实时同步
 
 
avatar EazyDevelop社区
 
cover
 
两小时，我搭了一套销售提成计算系统
 
 
avatar EazyDevelop社区
 
cover
 
零代码时代：如何利用聚合API平台快速构建你的专属AI Agent
 
 
avatar EazyDevelop社区