QTAF接口自动化框架–从零开始构建接口测试（三）

前提：

• 本地的jdk1.7+、maven环境已部署OK

• Example项目可成功运行

接下来就可以创建自己的接口测试maven项目了，也可以直接在Example项目上修改

下面以新建一maven项目为例说明

一、整理待测接口信息

在这儿以微信公众平台的某一接口为例，接口信息见页面： http://mp.weixin.qq.com/wiki/index.php?title=获取access_token 

整理后接口信息如下：

• 1、接口地址：https://api.weixin.qq.com/cgi-bin/token?  注意最后的?号要带着，LEO下一版本将兼容此问题

• 2、http请求方式：Get 

• 3、cookie：无需处理 cookie留空

• 4、签名：无需处理，ArgCount设置为0

• 5、参数：有3个参数 

注意：CaseID和Excel表的sheet命名要满足java命名规范，且CaseID不能重复

最终用例Excel内容如下图：保存Excel--> Demo测试用例.xlsx

二、创建maven项目

1、打开eclipse，选择新建-项目-Maven--Maven Project

2、选择项目保存磁盘目录，或使用默认项

3、在【Select an Archetype】时，选择“Maven-archetype-quickstart”如下图，之后点击下一步

4、Group Id和Aritifact Id自定义输入，此实例中输入：

Group Id：cn.baiweigang.test

Aritifact Id：DemoWeiXinAPI

点击【完成】后，maven项目创建完毕，其项目代码结构如下图：

三、项目添加类文件

1、修改pom.xml文件，加入QTAF框架依赖，可把默认的junit依赖删掉，最终依赖部分配置如下：

1 2 3 4 5 6 7 8 9

< dependencies >    < dependency >        < groupId >cn.baiweigang</ groupId >        < artifactId >qtaf</ artifactId >        < version >1.2.0</ version >        < type >jar</ type >        < scope >compile</ scope >    </ dependency > </ dependencies >

2、删除掉源码下的test，只保留main即可；删除掉默认的App类

3、拷贝第一步中创建到Excel测试用例文件【Demo测试用例.xlsx】到项目根目录，此步可选，在最后指定用例时，可通过测试用例文件的绝对路径定位，是否拷贝到项目无影响

4、创建WeiXinAPIConf类，参照Example项目DemoConf类的内容，此处只填写Get参数即可，如下：

1 2 3 4 5 6 7 8 9 10 11 12

package  cn.baiweigang.test.DemoWeiXinAPI;   /**   * @author @<a href='http://weibo.com/bwgang'>bwgang</a><br/>   *   */ public  class  WeiXinAPIConf {      public  static  final  String[]  HeardPara ={};      public  static  final  String[] GetPara = { "grant_type" , "appid" , "secret" };      public  static  final  String[] PostPara = {};      public  static  final  String ENCODING= "UTF-8" ; }

5、创建WeiXinAPICasesUtils类，要继承自LEO框架中的CasesUtils类，参照Example项目DemoCasesUtils类的内容，创建方法Demo，代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

/**   * @author @<a href='http://weibo.com/bwgang'>bwgang</a><br/>   *   */ public  class  WeiXinAPICasesUtils  extends  CasesUtils{      public  IFtResultInfo Demo(IftTestCase testcase)  {          //设置用例编码--可选          testcase.setEnCoding(WeiXinAPIConf.ENCODING);            //更新用例的签名计算、url参数、form参数、header参数--必须          testcase=updateAllToListForCase(testcase, WeiXinAPIConf.GetPara, WeiXinAPIConf.PostPara, WeiXinAPIConf.HeardPara);            //更新用例参数值，针对rand等特殊标识处理--必须          testcase=updateAllParaForCase(testcase, 10 );          //发起请求          ResponseInfo resInfo = execResquest(testcase);            //预期结果格式为key1=value1&key2=value2  或key1=value11#value12&key2=value2 支持一个可以对应多个值          String expRes=testcase.getCaseMap().get( "Expres" );          if  (expRes== ""  ||  null ==expRes) {              expRes= "预期结果为空" ;          }          //获取处理后的实际结果 目前只支持json\xml格式  如果接口返回结果不是此两种格式 则需要把actRes转换为json或xml格式          String actRes= resInfo.getResBodyInfo();          //预期值与实际值比对 并返回IFtResultInfo类型          return  getIFtResultInfo(resInfo, expRes, actRes);      }   }

6、创建执行入口类Entry，参照Example项目Entry类的内容，代码如下：

其中 iftExec.addCase(IftConf.RootPath + "Demo测试用例.xlsx", "获取access_token", "获取access_token接口", WeiXinAPICasesUtils.class, "Demo");

表示添加一个测试，可以添加多个

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

/**   * @author @<a href='http://weibo.com/bwgang'>bwgang</a><br/>   *   */ public  class  Entry {        /**       * @param args       */      public  static  void  main(String[] args) {          // 依赖的jar文件路径信息 必须设置 以maven方式运行一次后会记录本地库jar文件位置          if  (!IftConf.updateJarFile(args))              return ;          // 添加用例          IftExec iftExec =  new  IftExec();          /**           * casePath 用例路径 必填 sheetName Excel的sheet表名 可选 caseName 用例名称 必填 cls           * 执行用例的类 必填 method 类中的方法 必填           */          iftExec.addCase(IftConf.RootPath +  "Demo测试用例.xlsx" ,  "获取access_token" ,                  "获取access_token接口" , WeiXinAPICasesUtils. class ,  "Demo" );          // 执行          TestReport report = iftExec.run();          // 输出执行结果          System.out.print( "任务执行结果："  + report.getResMsg() +  "\n" );          if  (report.getResNo() > - 1 ) {              System.out.print( "任务名称："  + report.getTaskName() +  "\n" );              System.out.print( "任务执行时间："  + report.getSumTime() +  "毫秒\n" );              System.out.print( "Html报告："  + report.getHtmlReport()                      +  "/index.html\n" );              System.out.print( "Excel报告："  + iftExec.getExcelReportPath());          }      }   }

四、运行配置

至此项目初步创建完毕，执行入口类Entry，此类就是个main函数，第一次直接执行此类时，不会执行用例的，会提示【在eclipse中，第一次需要以maven方式执行】

需要在pom文件中配置的  

在

1 2	< name >DemoWeiXinAPI</ name > < url >http://maven.apache.org</ url >

此部分后面添加，目的是指定maven方式运行时执行的类以及构建编码等，

注意 ：

1 2 3

<java classname="cn.baiweigang.test.DemoWeiXinAPI.Entry" classpath="$   {runtime_classpath}"

此部分内容中执行类修改为实际的。

添加的部分xml如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48

< build >          < plugins >              < plugin >                  < groupId >org.apache.maven.plugins</ groupId >                  < artifactId >maven-compiler-plugin</ artifactId >                  < configuration >                      < source >7</ source >                      < target >7</ target >                      < encoding >UTF-8</ encoding >                      < file.encoding >UTF-8</ file.encoding >                  </ configuration >              </ plugin >              < plugin >                  < groupId >org.apache.maven.plugins</ groupId >                  < artifactId >maven-surefire-plugin</ artifactId >                  < configuration >                      < argLine > -Dfile.encoding=UTF-8</ argLine >                      < forkMode >once</ forkMode >                  </ configuration >              </ plugin >                < plugin >                  < groupId >org.apache.maven.plugins</ groupId >                  < artifactId >maven-antrun-plugin</ artifactId >                  < executions >                      < execution >                          < id >test</ id >                          < phase >test</ phase >                          < configuration >                              < tasks >                                  < property  name = "runtime_classpath"  refid = "maven.runtime.classpath"  />                                  < java  classname = "cn.baiweigang.test.DemoWeiXinAPI.Entry"  classpath = "${runtime_classpath}"                                      fork = "true"  maxmemory = "256m" >                                      < sysproperty  key = "file.encoding"  value = "UTF-8"  />                                      < arg  value = "${runtime_classpath}"  />                                  </ java >                              </ tasks >                          </ configuration >                          < goals >                              < goal >run</ goal >                          </ goals >                      </ execution >                    </ executions >              </ plugin >            </ plugins >      </ build >

然后在项目名称上右键--“运行方式“--”Maven test“，控制台输出如下信息表示执行成功。

之后可以通过直接运行Entry类来调试或执行用例了

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

[INFO] Executing tasks       [java] [TestNG] Running:       [java]   E:\workspace_ee\DemoWeiXinAPI\qtaf\dispatch\suites\接口测试.xml       [java]       [java]       [java] ===============================================       [java] 接口测试       [java] Total tests run: 1, Failures: 1, Skips: 0       [java] ===============================================       [java]       [java] 任务执行结果：任务执行成功       [java] 任务名称：接口测试       [java] 任务执行时间：3724毫秒       [java] Html报告：E: /workspace_ee/DemoWeiXinAPI/qtaf/ift/report/ 接口测试 /html/index .html       [java] Excel报告：E: /workspace_ee/DemoWeiXinAPI/qtaf/ift/report/ 接口测试/测试报告_Demo测试用例.xlsx [INFO] Executed tasks [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total  time : 18.034s [INFO] Finished at: Wed Feb 26 18:10:35 CST 2014 [INFO] Final Memory: 7M /17M [INFO] ------------------------------------------------------------------------