接口自动化测试一体式解决方案

前戏叨逼叨：
测试多年工作经验，很少有写文章、博客之类的东西。
其实我这人不爱去写博客之类的东西，更多的是靠脑子的总结。不是脑子好用，其实就一句话：懒！就是懒！！！
早在几年前就有记录的想法，但当时确实因为工作原因 加上懒，就借口了自己。
好了，如今就要奔三的人，该面对的往往都要面对。
于是觉得是该写点东西记录下，倒不是说要总结什么的；只是想让自己经历过的事情，通过记录的形式加强印象；与此同时，希望能够给像自己这样的小白，在遇到类似问题时能够带来想法。
所以，第一次写类似测试技术博客，献丑。看官海涵~
第一篇不谈理论，实践篇。
叨逼叨结束！。

2017.8.17 更新：

1. 接口实现辅助类的优化。
2. 因单接口用例数量上升，多接口的 .xml 文件管理混乱问题，进行优化。

樱木镇楼

无聊的背景

测试工作多年，一路以来一直都会伴随着服务端的测试。
那么首当其冲的肯定是接口测试， 而接口测试中首先联想到的是接口自动化测试。
注意：服务端测试 != 接口测试 != 接口自动化测试 。这个公式是不等！找机会再写篇文章详细聊聊...
在经历过多中不同的平台后，毅然而然的觉得通过码代码的用例是最靠谱的。别相信那些带UI降低编写接口自动化用例难度的自动化平台，原因不详！（不想详细解释，入坑后自会明白...）
好了，今天介绍一款接口自动化测试的一体式解决方案。（有点夸张，其实吧还真是一体式。）这是入坑后，个人认为在Java大背景服务开发下比较理想的解决方案。
最后，接口自动化测试的框架和平台形形色色，不用评论哪个好，哪个差。只有最合适项目团队的才是最好的。（废话...）

本文代码github：https://github.com/Jsir07/TestHub

话不多说，先上Jenkins上自助运行用例，查看报告流程截图。也可结合持续集成自动触发测试服务。

Jenkins自助运行流程

一、方案介绍

①. 选型：Java + Maven + Testng + ExtentReports + Git + Retrofit2 + Jenkins

• 使用Java作为项目编程语言。
• 使用Maven作为项目类型，方便管理架包。
• 使用TestNG作为项目运行框架，方便执行测试用例，生成测试报告。
• 使用ExtentReports作为代替TestNG报告的报告驱动，二次美化功能，界面更美观，内容清晰
• 使用Git作为仓库管理工具，方便管理项目代码。
• 使用Retrofit2作为API接口自动化项目底层服务驱动框架。
• 使用Jenkins作为自动化持续集成平台，方便自动编译，自动打包，自动运行测试脚本，邮件发送测试报告，通知等。

②. 功能介绍：

1. 实现持续集成测试，自助式测试，一站式测试平台。
2. 通过Retrofit2作为等常用接口定义与请求方法，使用方便简洁。同时可分离接口定义、实现请求、响应验证。
3. 参数化驱动用例运行方式，目前使用本地配置文件；可扩展为造数据。
4. 还有...自己体会...

二、环境安装与配置

（一）开发环境：

1. JDK1.7 及以上
2. IDEA 社区版（壕->pro）
3. Maven 不限
4. Git 不限
5. Jenkins 不限

（二）部分环境安装细节：

1. JDK 安装请查阅。https://www.cnblogs.com/ottox/p/3313540.html

2. Maven 安装与配置。

• setting配置，主要是国内镜像 阿里云。https://blog.csdn.net/liuhui_306/article/details/52822152
  - 加速。

  <mirror>
        <id>alimaven</id>
        <name>aliyun maven</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        <mirrorOf>central</mirrorOf>        
  </mirror>
  
  

• 本地localRepository配置。为什么要配置这个？因为默认是放在C盘的。Default: ${user.home}/.m2/repository。jar 太多、太大！

  <localRepository>E:\apache-maven-3.5.3\repository</localRepository>
  

• 命令配置。https://www.cnblogs.com/eagle6688/p/7838224.html
  - 为啥配置这个？因为后面Jenkins如果需要在本地运行的话，需要用到mvn命令。
  

3. IDEA 安装请查阅，下载社区版本即可。 https://www.jetbrains.com/idea/

• 编码设置UTF-8：https://blog.csdn.net/frankcheng5143/article/details/50779149

• 字体设置：https://blog.csdn.net/qq_35246620/article/details/63253518

• 模板设置：https://blog.csdn.net/xiaoliulang0324/article/details/79030752

• JDK配置：选择JDK的存放路径。

• maven配置：file->settings->搜索maven->

  Maven home deirectory: maven存放地址。
  User settings file: maven的setting路径。
  Local repository: repository 要存放的路径。

• 以上配置最好设置成默认配置，这样不用针对每个项目配置。File->Other settings -> Default Settings.

4. Git 安装。

参考：https://git-scm.com/book/zh/v2/%E8%B5%B7%E6%AD%A5-%E5%AE%89%E8%A3%85-Git

5. Jenkins本地安装，只要安装不用创建任务，后面会有任务创建。

参考：https://www.cnblogs.com/c9999/p/6399367.html。

若遇网站需要翻墙，具体下载安装请自行百度。

三、框架搭建

（一） 项目基础工程

搭工程，建立基本工程框架，采用maven结构框架工程。 话不多说，先搭建工程。方式：

1.1 IDEA 上，File ->New ->Project -> maven. 选maven后，不选任何模板，直接Next。

image.png

1.2 填写对应项目信息后，next。

image.png

1.3 继续填写 对应信息后，Finish。

image.png

（二）Maven pom.xml文件配置 与多环境切换

2.1 依赖配置

需要使用到的依赖有testng、extentreports、retrofit、fastjson、okhttp等..

 <dependencies>
    <!-- https://mvnrepository.com/artifact/com.alibaba/fastjson -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.47</version>
    </dependency>
    
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>3.10.0</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/com.squareup.okhttp3/logging-interceptor  日志拦截器-->
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>logging-interceptor</artifactId>
        <version>3.10.0</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.testng/testng -->
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>6.14.2</version>
        <!--<scope>test</scope>-->
        <!--作用范围，默认是test。验证部分被抽象，不仅test作用域需使用-->
    </dependency>
    
    <!-- https://mvnrepository.com/artifact/com.aventstack/extentreports -->
    <dependency>
        <groupId>com.aventstack</groupId>
        <artifactId>extentreports</artifactId>
        <version>3.1.5</version>
        <scope>provided</scope>
    </dependency>

    <!-- https://mvnrepository.com/artifact/com.vimalselvam/testng-extentsreport -->
    <dependency>
        <groupId>com.vimalselvam</groupId>
        <artifactId>testng-extentsreport</artifactId>
        <version>1.3.1</version>
    </dependency>
    
    <dependency>
        <groupId>com.squareup.retrofit2</groupId>
        <artifactId>retrofit</artifactId>
        <version>2.4.0</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/com.squareup.retrofit2/converter-gson 对象转换器-->
    <dependency>
        <groupId>com.squareup.retrofit2</groupId>
        <artifactId>converter-gson</artifactId>
        <version>2.3.0</version>
    </dependency>
</dependencies>

2.2 配置多环境切换部分

采用maven环境切换方式。

• 2.2.1 先配置pom.xml文件的 build节点。

  <build>
     <resources>
         <resource>
             <directory>src/main/resources</directory>
             <filtering>true</filtering>
             <!--扫描替换参数的文件路径-->
         </resource>
     </resources>
     <filters>
         <filter>src/main/filters/filter-${env}.properties</filter>
         <!--环境过滤器的配置方式，回头需要在该路径下建立对应文件-->
     </filters>
     <plugins>
         <plugin>
             <!--该插件是解决命令下执行mvn test指定testng xxx.xml 文件 的配置-->
             <groupId>org.apache.maven.plugins</groupId>
             <artifactId>maven-surefire-plugin</artifactId>
             <version>2.22.0</version>
             <configuration>
                 <!--为了解决在jenkins maven执行test 报告乱码问题，编码格式设置为UTF-8-->
                 <argLine>-Dfile.encoding=UTF-8</argLine>
                 <encoding>UTF-8</encoding>
                 <!--动态指定执行的xml文件。${project.basedir}项目目录，${xmlFileName}maven文件-->
                 <suiteXmlFiles>
                     <suiteXmlFile>${project.basedir}/target/classes/testNg/${xmlFileName}</suiteXmlFile>
                 </suiteXmlFiles>
             </configuration>
         </plugin>
         <plugin>
             <groupId>org.apache.maven.plugins</groupId>
             <artifactId>maven-compiler-plugin</artifactId>
             <configuration>
                 <encoding>UTF-8</encoding>
                 <source>8</source>
                 <target>8</target>
             </configuration>
         </plugin>
     </plugins>
  </build>
  

• 2.2.2 在pom.xml文件配置properties为了maven打包编译时后台一直输出警告信息。导致构建失败。

      <!--为了maven打包编译时后台一直输出警告信息。导致构建失败-->
      <properties>
          <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
          <xmlFileName></xmlFileName>
      </properties>
  

• 2.2.3 在pom.xml文件配置Properties环境。多环境配置参数切换。

      <profiles>
          <!-- 开发环境，默认激活 -->
          <profile>
              <id>dev</id>
              <properties>
                  <env>dev</env>
              </properties>
          </profile>
  
          <!-- 生产环境 -->
          <profile>
              <id>product</id>
              <properties>
                  <env>product</env>
              </properties>
          </profile>
  
          <!-- 测试环境 -->
          <profile>
              <id>debug</id>
              <properties>
                  <env>debug</env>
              </properties>
              <activation>
                  <activeByDefault>true</activeByDefault><!--默认启用的是dev环境配置-->
              </activation>
          </profile>
      </profiles>
  

2.3 配置环境切换-文件部分

• 2.3.1 在src/resource下创建env.properties文件。
  该文件记录的信息是跟环境切换相关的参数。
  如：接口请求不同环境的host，mongodb、mysql数据库等，因不同环境的信息。
  例如：

      api.post.host=${api.post.host}
  

• 2.3.2 创建src/main/filters/下创建
  filter-debug.properties、filter-dev.properties、filter-product.properties
  用于环境信息记录。
  详细信息，如：

      api.post.host=http://apidebug.xxx.com:80/
  

如图：

image.png

(三) testNg配置部分

3.1. 在src/resources/下创建testNg目录.

src/resources/testNg 目录是存放测试集合的目录，可根据测试模块创建对应模块文件夹。

3.1.1 每个文件夹可以是独立模块，每个模块下可以有模块的测试集合。

• 例如，在src/resources/testNg/下创建测试集合：api/search/search-TestSuite.xml。配置如下：

  <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
  
  <suite name="search_tags-搜索分类-电影首页测试集合" verbose="1" preserve-order="true">
    <parameter name="report.config" value="src/main/resources/config/report/extent-config.xml"/>
    <parameter name="system.info" value="reporter.config.MySystemInfo"/>
  
    <test name="0100.搜索分类-电影首页-正常场景" preserve-order="true">
      <classes>
          <class name="com.jxq.douban.SearchTagsTest">
              <methods>
                  <include name="testcase1"/>
              </methods>
          </class>
      </classes>
    </test>
  
    <test name="0100.搜索分类-TV首页-正常场景" preserve-order="true">
      <classes>
          <class name="com.jxq.douban.SearchTagsTest">
              <methods>
                  <include name="testcase2"/>
              </methods>
          </class>
      </classes>
    </test>
  
    <listeners>
      <listener class-name="reporter.Listener.MyExtentTestNgFormatter"/>
    </listeners>
  </suite>
  

3.1.2.为了能够让所有接口统一运行测试，需建立一个所有的测试集合，测试集合一般放在src/resources/testNg 目录下。

型如：

  <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >

  <suite name="接口测试集合" verbose="1" preserve-order="true">
    <parameter name="report.config" value="src/main/resources/config/report/extent-config.xml"/>
    <parameter name="system.info" value="reporter.config.MySystemInfo"/>

    <suite-files>
      <suite-file path="search/SearchTags-TestSuite.xml"/>
    </suite-files>

    <listeners>
        <listener class-name="reporter.Listener.MyExtentTestNgFormatter"/>
    </listeners>
    </suite>

3.1.3 说明

• 有同学会问：为什么会有这么多inclde name？
  原因是：test里的name是针对一整个testclass的名称，为了让每一个测试名称都能够展示。
  故此把层级调整了。调整后的层级对应如下：

需要说明的是，在testng接口层级管理上，每个项目可以有各自的方式，只要符合你的是好的。

• 这里添加了parameter、listener，是用于替换testng默认报告，使用ExtentReported。关于ExtentReported后面会有说明。

    <parameter name="report.config" value="src/main/resources/config/report/extent-config.xml"/>
    <parameter name="system.info" value="reporter.config.MySystemInfo"/>
    
    <listeners>
        <listener class-name="reporter.Listener.MyExtentTestNgFormatter"/>
    </listeners>

（四） TestCase测试用例

4.1 Test用例类

• 首先，满足maven工程结构在src/test目录下建立对应的测试用例类。
• 其次，测试用例类的命名也满足maven在单元测试时的规范。类名以Test结尾.如：SearchTagsTest.java
• 最后，根据各模块分类建立对应模块包。

4.2 测试用例怎么写？

其实网上有很多关于TestNg的文章，这边就不做过多介绍了。

官网：https://testng.org/doc/index.html
也可查阅：https://www.yiibai.com/testng/

写接口用例，不在与形式，形式网上很多。
最重要的是编写的层次与心得。回头有空再整理下。

（五） extentreports报告

extentreports是什么？网上有很多关于使用extentreports替代TestNg自带报告。原因是什么？
漂亮。先上张图。

testNg原有报告有点丑，信息整理有点乱。ExtentReports是用于替换testNg原有的报告。也可以使用ReportNg，个人偏好ExtentReports样式。

5.1 强制重写ExtentTestNgFormatter类

强制重写EExtentTestNgFormatter类主要是以下两点原因：
①、为了能够在报告中展示更多状态类型的测试结果，例如：成功、失败、警告、跳过等测试状态结果。
②、因为不支持cdn.rawgit.com访问，故替css访问方式。

方式如下：下载ExtentReportes源码，找到ExtentTestNgFormatter类。

• 5.1.1 在创建类：src/main/java/reporter/listener路径下MyExtentTestNgFormatter.java类。
  MyExtentTestNgFormatter直接从ExtentTestNgFormatter继承。

  public class MyExtentTestNgFormatter extends ExtentTestNgFormatter {
  

• 5.1.2 构造方法加入htmlReporter.config().setResourceCDN(ResourceCDN.EXTENTREPORTS);
  MyExtentTestNgFormatter 类，代码如下：

    public MyExtentTestNgFormatter() {
        setInstance(this);
        testRunnerOutput = new ArrayList<>();
        String reportPathStr = System.getProperty("reportPath");
        File reportPath;
  
        try {
            reportPath = new File(reportPathStr);
        } catch (NullPointerException e) {
            reportPath = new File(TestNG.DEFAULT_OUTPUTDIR);
        }
  
        if (!reportPath.exists()) {
            if (!reportPath.mkdirs()) {
                throw new RuntimeException("Failed to create output run directory");
            }
        }
  
        File reportFile = new File(reportPath, "report.html");
        File emailReportFile = new File(reportPath, "emailable-report.html");
  
        htmlReporter = new ExtentHtmlReporter(reportFile);
        EmailReporter emailReporter = new EmailReporter(emailReportFile);
        reporter = new ExtentReports();
        //        如果cdn.rawgit.com访问不了，可以设置为：ResourceCDN.EXTENTREPORTS或者ResourceCDN.GITHUB
        htmlReporter.config().setResourceCDN(ResourceCDN.EXTENTREPORTS);
        reporter.attachReporter(htmlReporter, emailReporter);
    }
  

• 5.1.3 接着在onstart方法重写功能。
  用了很粗暴的方式，新建了一个类名为MyReporter，一个静态ExtentTest的引用。

  • ① reporter.Listener包下MyReporter.java

        public class MyReporter {
            public static ExtentTest report;
        }
    

  • ② MyExtentTestNgFormatter.java

        public void onStart(ITestContext iTestContext) {
            ISuite iSuite = iTestContext.getSuite();
            ExtentTest suite = (ExtentTest) iSuite.getAttribute(SUITE_ATTR);
            ExtentTest testContext = suite.createNode(iTestContext.getName());
            // 将MyReporter.report静态引用赋值为testContext。
            // testContext是@Test每个测试用例时需要的。report.log可以跟随具体的测试用例。另请查阅源码。
            MyReporter.report = testContext;
            iTestContext.setAttribute("testContext", testContext);
        }
    

• 5.1.4 顺带提一句，测试报告默认是在工程根目录下创建test-output/文件夹下，名为report.html、emailable-report.html。可根据各自需求在构造方法中修改。

      public MyExtentTestNgFormatter() {
          setInstance(this);
          testRunnerOutput = new ArrayList<>();
          // reportPath报告路径
          String reportPathStr = System.getProperty("reportPath");
          File reportPath;
  
          try {
              reportPath = new File(reportPathStr);
          } catch (NullPointerException e) {
              reportPath = new File(TestNG.DEFAULT_OUTPUTDIR);
          }
  
          if (!reportPath.exists()) {
              if (!reportPath.mkdirs()) {
                  throw new RuntimeException("Failed to create output run directory");
              }
          }
          // 报告名report.html
          File reportFile = new File(reportPath, "report.html");
          // 邮件报告名emailable-report.html
          File emailReportFile = new File(reportPath, "emailable-report.html");
  
          htmlReporter = new ExtentHtmlReporter(reportFile);
          EmailReporter emailReporter = new EmailReporter(emailReportFile);
          reporter = new ExtentReports();
          reporter.attachReporter(htmlReporter, emailReporter);
      }
  

• 5.1.5 顺带再提一句，report.log 可以有多种玩法。

  // 根据状态不同添加报告。型如警告
  MyReporter.report.log(Status.WARNING, "接口耗时(ms)：" + String.valueOf(time));
  

  直接从TestClass中运行时会报MyReporter.report的空指针错误，需做个判空即可。

5.2 导入MyExtentTestNgFormatter监听类

在测试集合.xml文件中导入Listener监听类。

<listeners>
        <listener class-name="reporter.Listener.MyExtentTestNgFormatter"/>
</listeners>

5.3 配置报告信息

extent reporters支持报告的配置。目前支持的配置内容有title、主题等。

• 先在src/resources/目录下添加 config/report/extent-config.xml。

  • 配置内容

  <?xml version="1.0" encoding="UTF-8"?>
  <extentreports>
      <configuration>
          <timeStampFormat>yyyy-MM-dd HH:mm:ss</timeStampFormat>
          <!-- report theme -->
          <!-- standard, dark 个人喜好暗色 -->
          <theme>dark</theme>
  
          <!-- document encoding -->
          <!-- defaults to UTF-8 -->
          <encoding>UTF-8</encoding>
  
          <!-- protocol for script and stylesheets -->
          <!-- defaults to https -->
          <protocol>https</protocol>
  
          <!-- title of the document -->
          <documentTitle>QA-接口自动化测试报告</documentTitle>
  
          <!-- report name - displayed at top-nav -->
          <reportName>QA-接口自动化测试报告</reportName>
  
          <!-- report headline - displayed at top-nav, after reportHeadline -->
          <reportHeadline>接口自动化测试报告</reportHeadline>
  
          <!-- global date format override -->
          <!-- defaults to yyyy-MM-dd -->
          <dateFormat>yyyy-MM-dd</dateFormat>
  
          <!-- global time format override -->
          <!-- defaults to HH:mm:ss -->
          <timeFormat>HH:mm:ss</timeFormat>
  
          <!-- custom javascript -->
          <scripts>
              <![CDATA[
          $(document).ready(function() {
  
          });
        ]]>
          </scripts>
  
          <!-- custom styles -->
          <styles>
              <![CDATA[
  
        ]]>
          </styles>
      </configuration>
  </extentreports>
  

5.4 添加系统信息

不多说，上图。

可用于添加系统信息，例如：db的配置信息，人员信息，环境信息等。根据项目实际情况添加。

• 在src/main/java/reporter/config目录下创建MySystemInfo.java类，继承SystemInfo接口。

  public class MySystemInfo implements SystemInfo {
      @Override
      public Map<String, String> getSystemInfo() {
          InputStream inputStream = this.getClass().getClassLoader().getResourceAsStream("env.properties");
          Properties properties = new Properties();
          Map<String, String> systemInfo = new HashMap<>();
          try {
              properties.load(inputStream);
              systemInfo.put("environment", properties.getProperty("Environment"));
              systemInfo.put("sqlURL", properties.getProperty("ESsql.URL"));
              systemInfo.put("redisHost", properties.getProperty("redis.host"));
              systemInfo.put("redisPort", properties.getProperty("redis.port"));
              systemInfo.put("mongodbHost", properties.getProperty("mongodb.host"));
              systemInfo.put("mongodbPort", properties.getProperty("mongodb.port"));
              systemInfo.put("测试人员", "jxq");
          } catch (IOException e) {
              e.printStackTrace();
          }
          return systemInfo;
      }
  }
  

  至此，extentreports美化报告完成。

（六）. retrofit2.0--Http接口测试驱动原力

其实Java的Http客户端有很多，例如HTTPClient、OKHttp、retrofit等。。。
为什么那么多Http客户端会选择retrofit？用一个图见证他的实力

如此多的星星可知

真正的原因
接口定义与实现分离
retrofit2.0可将Http接口定义与请求实现分离；通过制定interface定义接口。
网上有很多关于retrofit2.0的教程，这里就不再班门弄斧了，度娘即可。参考：https://blog.csdn.net/carson_ho/article/details/73732076

附上本项目方式。

6.1 具体Http Api的定义interface。新建ISearch interface。

public interface ISearch {
    @GET("j/search_tags")
    Call<MovieResponseVO> searchTags(@Query("type") String type, @Query("source") String source);
}

6.2 HttpBase基础类提供原动力。

HttpBase类中提供了Retrofit基础。
同时，我考虑到了日常控制台和测试报告上都需要看到对应请求信息，故此在HttpClient中默认加入了日志拦截器；日志拦截器的实现方法里，用Reportes.log记录到日志中。
并且，考虑到实际项目中每个Http请求都会有对应类似RequestHeader、RequestBody的加密签名等，预留了拦截器。
可在HttpBase构造方法时传入对应拦截器。
对应的拦截器可以通过实现接口Interceptor，做对应项目需求操作。
先看代码。

public class HttpBase {
    public static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");
    private Retrofit retrofit;
    private String host;

    /**
     * 构造方法（1个参数）
     * 只传Host，默认没有使用拦截器。
     *
     * @param host 访问域名host
     */
    public HttpBase(String host) {
        init(host, null);
    }

    /**
     * 构造方法（2个参数）
     * 只传Host，默认使用日志拦截器。
     *
     * @param host        访问域名host
     * @param interceptor 自定义拦截器
     */
    public HttpBase(String host, Interceptor interceptor) {
        init(host, interceptor);
    }

    /**
     * 初始化方法
     *
     * @param host        访问域名host
     * @param interceptor 自定义拦截器
     */
    private void init(String host, Interceptor interceptor) {
        OkHttpClient.Builder client = getHttpClient(interceptor);
        retrofit = new Retrofit.Builder()
                .baseUrl(host)
                .client(client.build())
                .addConverterFactory(RespVoConverterFactory.create())
                .build();
    }

    /**
     * 获取HttpClient.Builder 方法。
     * 默认添加了，基础日志拦截器
     *
     * @param interceptor 拦截器
     * @return HttpClient.Builder对象
     */
    private OkHttpClient.Builder getHttpClient(Interceptor interceptor) {
        HttpLoggingInterceptor logging = getHttpLoggingInterceptor();
        OkHttpClient.Builder builder = new OkHttpClient.Builder()
                .connectTimeout(10, TimeUnit.SECONDS)
                .retryOnConnectionFailure(true);
        if (interceptor != null) {
            builder.addInterceptor(interceptor);
        }
        builder.addInterceptor(logging);
        return builder;
    }

    /**
     * 日志拦截器
     *
     * @return
     */
    private HttpLoggingInterceptor getHttpLoggingInterceptor() {
        HttpLoggingInterceptor logging = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() {
            @Override
            public void log(String message) {
                Reporter.log("RetrofitLog--> " + message, true);
            }
        });
        logging.setLevel(HttpLoggingInterceptor.Level.BODY);//Level中还有其他等级. 设置打印内容级别到Body。
        return logging;
    }

    /**
     * retrofit构建方法
     *
     * @param clazz 泛型类
     * @param <T>   泛型类
     * @return 泛型类
     */
    public <T> T create(Class<T> clazz) {
        return retrofit.create(clazz);
    }

    public String getHost() {
        return host;
    }

    public void setHost(String host) {
        this.host = host;
    }
}

6.3 集成HttpBase的Http Api接口请求方法类

这里需要说明下，为什么需要有这个类的存在？
其实在Retrofit已经可以用4行的代码实现Http请求了，如下：

        HttpBase httpBase = new HttpBase(host);
        ISearch iSearch = httpBase.create(ISearch.class);
        Call<MovieResponseVO> call = iSearch.searchTags(type, source);
        Response<MovieResponseVO> response = call.execute();

看了上面的4行代码，每次都需要写也是挺麻烦的。
所以抽出来，让编写测试用例验证更简洁点。
抽取后的代码如下：

public class HttpSearch extends HttpBase {
    private ISearch iSearch;

    public HttpSearch(String host) {
        super(host);
        iSearch = super.create(ISearch.class);
    }

    public Response<MovieResponseVO> searchTags(String type, String source) throws IOException {
        Call<MovieResponseVO> call = iSearch.searchTags(type, source);
        return call.execute();
    }

//    同模块下，新增的接口可添加到这里。
//    public Response<MovieResponseVO> searchTags(String type, String source) throws IOException {
//        Call<MovieResponseVO> call = iSearch.searchTags(type, source);
//        return call.execute();
//    }
}

6.4 使用JsonSchema验证基础响应体

Http响应体非Json格式，可跳过该步骤。

这里引入了JsonSchema来做基础验证，减少了Http响应返回带来的大量对象基础验证。
方式如下：

• 6.4.1 pom.xml 依赖引入

      <!--json schema start-->
      <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-core -->
      <dependency>
          <groupId>com.fasterxml.jackson.core</groupId>
          <artifactId>jackson-core</artifactId>
          <version>2.9.6</version>
      </dependency>

      <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
      <dependency>
          <groupId>com.fasterxml.jackson.core</groupId>
          <artifactId>jackson-databind</artifactId>
          <version>2.9.6</version>
      </dependency>

      <dependency>
          <groupId>com.github.fge</groupId>
          <artifactId>json-schema-validator</artifactId>
          <version>2.2.6</version>
      </dependency>
      <!--json schema end-->

• 6.4.2 简单抽象JsonSchemaUtils工具类。
  直接看代码。

/**
* JsonSchema工具类
*/
public class JsonSchemaUtils {
  /**
   * 从指定路径读取Schema信息
   *
   * @param filePath Schema路径
   * @return JsonNode型Schema
   * @throws IOException 抛出IO异常
   */
  private static JsonNode readJSONfile(String filePath) throws IOException {
      InputStream stream = JsonSchemaUtils.class.getClassLoader().getResourceAsStream(filePath);
      return new JsonNodeReader().fromInputStream(stream);
  }

  /**
   * 将Json的String型转JsonNode类型
   *
   * @param str 需要转换的Json String对象
   * @return 转换JsonNode对象
   * @throws IOException 抛出IO异常
   */
  private static JsonNode readJSONStr(String str) throws IOException {
      return new ObjectMapper().readTree(str);
  }

  /**
   * 将需要验证的JsonNode 与 JsonSchema标准对象 进行比较
   *
   * @param schema schema标准对象
   * @param data   需要比对的Schema对象
   */
  private static void assertJsonSchema(JsonNode schema, JsonNode data) {
      ProcessingReport report = JsonSchemaFactory.byDefault().getValidator().validateUnchecked(schema, data);
      if (!report.isSuccess()) {
          for (ProcessingMessage aReport : report) {
              Reporter.log(aReport.getMessage(), true);
          }
      }
      Assert.assertTrue(report.isSuccess());
  }

  /**
   * 将需要验证的response 与 JsonSchema标准对象 进行比较
   *
   * @param schemaPath JsonSchema标准的路径
   * @param response   需要验证的response
   * @throws IOException 抛出IO异常
   */
  public static void assertResponseJsonSchema(String schemaPath, String response) throws IOException {
      JsonNode jsonSchema = readJSONfile(schemaPath);
      JsonNode responseJN = readJSONStr(response);
      assertJsonSchema(jsonSchema, responseJN);
  }
}

这里已经将最后抽成简单方法供使用，只需传入schemaPath路劲、以及需要验证的对象。

• 6.4.3 Http响应体保存到本地
  • ①、可以通过客户端抓包获取得到Http响应体、或者开发接口定义文档 等方式，得到最后Http响应体的Json对象。(注意：响应体内容尽量全面，这样在验证时也可以尽可能验证)
  • ②、将请求响应体通过 https://jsonschema.net/ ，在线验证得到JsonSchema信息。
  • ③、根据接口响应需求，做基础验证配置。例如，这里将tags字段认为是必须存在的参数。
    完整Schema约束文件如下，并将此文件保存到resources目录对应模块下。

  {
  "$id": "http://example.com/example.json",
  "type": "object",
  "properties": {
    "tags": {
      "$id": "/properties/tags",
      "type": "array",
      "items": {
        "$id": "/properties/tags/items",
        "type": "string",
        "title": "The 0th Schema ",
        "default": "",
        "examples": [
          "热门",
          "最新"
        ]
      }
    }
  },
  "required": [
    "tags" 
  ]
}

6.5 TestCase测试用例编写。

public class SearchTagsTest {
    private static Properties properties;
    private static HttpSearch implSearch;
    private static String SCHEMA_PATH = "parameters/search/schema/SearchTagsMovie.json";

    @BeforeSuite
    public void beforeSuite() throws IOException {
        InputStream stream = this.getClass().getClassLoader().getResourceAsStream("env.properties");
        properties = new Properties();
        properties.load(stream);
        String host = properties.getProperty("douban.host");
        implSearch = new HttpSearch(host);
        stream = this.getClass().getClassLoader().getResourceAsStream("parameters/search/SearchTagsParams.properties");
        properties.load(stream);
        stream = this.getClass().getClassLoader().getResourceAsStream("");
        stream.close();
    }

  // 注意!!! @Test 注释内加入了description 用于描述该测试用例，（例如：描述测试目标，对象，参数，业务流程，测试方法等...）
    @Test(description = "电影首页。类别:type=movie source=index")
    public void testcase1() throws IOException {
        String type = properties.getProperty("testcase1.req.type");
        String source = properties.getProperty("testcase1.req.source");
        Response<MovieResponseVO> response = implSearch.searchTags(type, source);
        MovieResponseVO body = response.body();
        Assert.assertNotNull(body, "response.body()");
//        响应返回内容想通过schema标准校验
        JsonSchemaUtils.assertResponseJsonSchema(SCHEMA_PATH, JSONObject.toJSONString(body));
//        再Json化成对象
        Assert.assertNotNull(body.getTags(), "tags");
    }

    @Test(threadPoolSize = 10, invocationCount = 100, invocationTimeOut = 3, description = "Tv首页。类别:type=tv source=index")
    public void testcase2() throws IOException {
        String type = properties.getProperty("testcase2.req.type");
        String source = properties.getProperty("testcase2.req.source");
        Response<MovieResponseVO> response = implSearch.searchTags(type, source);
        MovieResponseVO body = response.body();
        Assert.assertNotNull(body, "response.body()");
        JsonSchemaUtils.assertResponseJsonSchema(SCHEMA_PATH, JSONObject.toJSONString(body));
        Assert.assertNotNull(body.getTags(), "tags");
    }
}

至此，TestNg测试用例部分全部完成。

四、Jenkins部分配置

Jenkins的安装上面已有说明，这里不重复。

（一） Jenkins插件

1.插件列表

需要使用到的插件有：

• Maven Integration plugin
• HTML Publisher plugin
• Dingding[钉钉] Plugin
• TestNG Results
• Groovy
• Parameterized Trigger Plugin

2. Jenkins插件安装

怎么安装插件？
Jenkins-》系统管理-》插件管理-》搜索插件-》安装即可

3. 插件说明

• Maven Integration plugin -必备！
  Maven构建插件，使用简单方便。

• HTML Publisher plugin -必备！
  extentreporets美化报告替换testng就是为了好看，但要在jenkins中展示必须安装此插件。

• Groovy -必备！
  Jenkins不支持异类样式CSS，所以Groovy插件是为了解决HTML Publisher plugin在展示extentreporets时能够正确美丽的作用。

• Dingding[钉钉] Plugin -必备！
  测试用例构建结果的通知。网上很多说用邮件，说实话使用场景最频繁高效的应该是IM靠谱。这个插件就是解决测试结果的通知。

• TestNG Results - 非必备
  TestNg测试结果收集，统计运行结果数据。

• Parameterized Trigger Pl ugin - 非必备
  依赖构建传参插件。http://note.youdao.com/noteshare?id=c56333317d3078b36b2479fdf8fe68d7&sub=wcp1530172849180570

（二）Jenkins新建任务配置

在插件安装完后，开始任务的新建配置。

• 新建一个maven项目。

  
  
  image.png

（三）General配置

• 丢弃旧的构建配置 -可配
  该配置根据需求配置。

  
  
  image.png

（四） 构建配置-maven配置

在Jenkins使用Maven构建项目自动化测试前，先通过本地使用maven测试是否通过。
这里本来要将参数化构建，但参数化构建前先说明下是如何利用maven构建测试的。

• 1. 检查pom.xml配置中指定的suiteXmlFile对象。

  <suiteXmlFiles>
      <!--用于根据maven传入的文件，运行maven test测试集合对象。 ${xmlFileName}是maven命令替换对象，别忘了添加properties中的xmlFileName-->
      <suiteXmlFile>${project.basedir}/target/classes/testNg/${xmlFileName}</suiteXmlFile>
      
      <!--在IEDA上运行maven test命令时，可打开该注释使用完整测试集合-->
      <!--<suiteXmlFile>${project.basedir}/target/classes/testNg/api/testng.xml</suiteXmlFile>-->
  </suiteXmlFiles>
  
  <properties>
      <xmlFileName></xmlFileName>
  </properties>
  

• 2. 先在IDEA上验证maven test是否生效？

  在<suiteXmlFile>${project.basedir}/target/classes/testNg/api/testng.xml</suiteXmlFile> 开启后，使用maven test验证是否成功。如下图：

image.png

• 3. 通过terminal命令验证maven test是否生效
  • 在2.3.1验证通过后，pom.xml注释<suiteXmlFile>${project.basedir}/target/classes/testNg/api/testng.xml</suiteXmlFile>.
  • 打开<suiteXmlFile>${project.basedir}/target/classes/testNg/${xmlFileName}</suiteXmlFile>
  • 进入terminal命令验证maven test是否生效。在命令行上输入mvn clean test -DxmlFileName=testng.xml
  • 验证maven test 是否正确。
  image.png
• 4. 唠叨编码问题

  我在执行上面的命令时，maven一直提示警告信息-编码问题；该警告信息原先我本不太在意，因为配置没有问题。
  可后来，命令执行一直报错。看了报错信息都指向了非编码问题。也就把我引向了其他错误解决区域。
  不得不说，maven的提示还是要重头到尾认真看。因为真正报错误的地方不一定是[error]提示。
  警告信息是： [WARNING] File encoding has not been set, using platform encoding GBK, i.e. build is platform dependent!

  如何解决该问题呢？在pom.xml上加入如下配置。

  // 这个配置由于被误删了，导致花费了半天解决。。。
  <properties>
      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      <xmlFileName></xmlFileName>
  </properties>
  

（五） 配置构建-maven配置信息。

回到Jenkins界面配置maven信息。

• 5.1 先在Jenkins新建任务，构建模块，增加构建步骤 - 调用顶层maven目标。
  （需要注意下，这里写的是中文，根据不同的Jenkins版本该名称可能是英文的）
  

• 5.2 然后配置信息如下。在目标加入命令信息：clean test -P%env% -DxmlFileName=%xmlFileName%

  
  

• 5.3命令解释：clean test -P%env% -DxmlFileName=%xmlFileName%

• maven参数化替换使用的占位符是 %xxx%
• -P%env% 指定maven运行的环境，该环境信息与pom.xml 配置的信息一直。同时，-P%env% 用于参数化构建传参使用，后面会有介绍。
• -DxmlFileName=%xmlFileName% 指定maven test 运行的测试集合对象。用于参数化构建传参使用，后面介绍。

（六） 参数化构建过程 配置

• 6.1添加参数 选择是 【选项参数】。

  
  

• 6.2完整配置信息如下图。

  
  

• 6.3参数名称xmlFileName，对应maven构建中的-DxmlFileName=%xmlFileName%，再对应pom.xml中的<suiteXmlFile>${project.basedir}/target/classes/testNg/${xmlFileName}</suiteXmlFile>
  加入需要运行的集合选项。

• 6.4 同样，env对应maven构建中的 -P%env% ，再对应pom.xml中的build信息。
  加入运行的环境选项。

（七） 源码管理配置

这个配置网上有很多详细文档，这里不重复。具体度娘查看。

image.png

（八） 构建触发器

> 这个配置可根据实际项目需求配置。个人建议: 接口自动化测试中的自动化最核心的是结合持续构建。   
> 所以建议配置“其他工程构建后触发”，填入所需测试的服务端项目名称即可。当然要在一个Jenkins中。

image.png

（九） 构建信息配置

> 上面已经配置了“调用顶层Maven目标”，然后还需要配置Groovy script。  
> 配置Groovy script的目的是让Http Reported插件css能用，同时不用担心jenkins重启。

• 配置Groovy script前保障Groovy 插件已经安装。

• 增加构建步骤“Execute system Groovy script” ，选择Groovy command，填入System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

（十） 构建后操作信息配置

9.1. publish html reports

加入publish html reports步骤。
- HTML directory to archive： 报告路径。 填写extentreports默认输出路径：test-output\
- Index page[s] ： 报告索引名称。填写extentreports默认报告名称：report.html
- Keep past HTML reports： 保留报告，勾选！不多说。

9.2 publish html reports

publish testng results 配置。默认**/testng-results.xml 即可。 
为什么要testng默认报告？ 因为需要统计分析时查看。 当然这个是可选的。

image.png

9.3. 钉钉通知器配置

怎么玩转钉钉消息？查看https://blog.csdn.net/workdsz/article/details/77531802
- 填入access token。

image.png

4. 构建后操作信息配置 钉钉通知器配置 二次开发 - 可选

http://www.51testing.com/html/25/n-3723525.html

(十一) 构建测试

• 11.1 build with parameters

  
  

• 11.2 构建成功后 在 HTML Report上查看

  
  
  
  

• 11.3 构建成功后 在 TestNG Results上查看

  
  

• 11.4 构建成功后 在 钉钉上查看

  
  

五、工程目录讲解 与 接口测试用例编写步骤

(一) 工程目录讲解

 先上图说明

(二) 接口测试用例编写步骤

1. 目标：具体Htpp接口定义的熟悉、理解。

注意：Http 请求行、请求头、请求体；响应行、响应头、响应体

• 可通过查看开发wiki文档，或者通过抓包等手段达到。

2. 具体Htpp接口的定义 - Host

• 2.1 将不同环境的Host地址配置在env.properties文件
• 2.2 然后在根据不同环境，配置不同properties文件，中对应的host信息。filter-debug.properties、filter-dev.properties、filter-product.properties。

3. 具体Htpp接口的定义 - interface

• 3.1 在src/main/java/下com.xxx.api.下新建对应模块，例如article
  • 一个模块文件夹下存放：接口定义的interface、接口定义的实现类。
• 3.2 在article下新建具体的接口定义interface

  public interface IArticle {
    @POST("article/feed")
    Call<ResponseBody> articleFeed(@Query("tid") String tid, @Body RequestBody requestBody);
  }
  

4. 具体Htpp接口的定义实现 - implement

• 4.1 在article下新建具体的接口定义实现

为什么要有这个类？
原因有1.简化接口调用代码，直接通过静态方法调用。 2. 当遇到接口需要特殊处理时，可通过该类进行扩展。

public class ImplArticle extends HttpBase {
  private IArticle iArticle;

  public ImplArticle(String host) {
      super(host);
      iArticle = super.create(IArticle.class);
  }

  public Response<ResponseBodyVo> articleFeed(String tid, String requestBody) throws IOException {
      Call<ResponseBodyVo> call = iArticle.articleFeed(tid, RequestBody.create(HttpBase.JSON, requestBody));
      return call.execute();
  }
}

5. 编写测试用例 -xxxTest

• 5.1 在test/java 目录下新建对应测试模块的文件夹 ，例如：article

  • 一个接口用例类，对应一个文件夹。

• 5.2 在test/java/article 目录下新建测试用例类。

  • 开始编写接口测试类。

  public class ArticleFeedTest {
    private static String HOST;
    private static Properties properties;
  
    @BeforeSuite
    public void beforeSuite() throws IOException {
        InputStream stream = this.getClass().getClassLoader().getResourceAsStream("env.properties");
        properties = new Properties();
        properties.load(stream);
        HOST = properties.getProperty("api.newsapi.host");
        stream = this.getClass().getClassLoader().getResourceAsStream("parameters/api/article/ArticleFeedParam.properties");
        properties.load(stream);
        stream.close();
    }
  
    @Test(description = "获取推荐文章信息流(下拉方式)")
    public void testcase1() throws IOException {
        String reques = properties.getProperty("testcase1.requestBody");
  
        String response = ImplArticle.articleFeed(HOST, "tid", reques);
        ResponseBodyVo responseBodyVo = JSONObject.parseObject(response, ResponseBodyVo.class);
        assertResponseBody(responseBodyVo);
    }
  
  

// 注解 @Test 中的描述信息，最后可以在报告中体现。
@Test(description = "获取推荐文章信息流(上拉方式)")
public void testcase2() throws IOException {
String reques = properties.getProperty("testcase1.requestBody");

    String response = ImplArticle.articleFeed(HOST, "tid", reques);
    ResponseBodyVo responseBodyVo = JSONObject.parseObject(response, ResponseBodyVo.class);
    assertResponseBody(responseBodyVo);
}

}

  
##### 6. 具体接口测试用例suite集合制作
- 在testNg/api/article/ArticleFeed-TestSuite.xml下创建suite集合

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >

<suite name="article/feed-接口测试集合" verbose="1" preserve-order="true">
<parameter name="report.config" value="src/main/resources/config/report/extent-config.xml"/>
<parameter name="system.info" value="reporter.config.MySystemInfo"/>

<test name="ArticleFeedTest接口测试集合" preserve-order="true">
    <classes>
        <class name="com.api.article.ArticleFeedTest"/>
    </classes>
</test>

<listeners>
    <listener class-name="reporter.Listener.MyExtentTestNgFormatter"/>
</listeners>

</suite>

##### 7. 所有接口测试用例suite集合制作    
- 在testNg/api/APICollection-TestSuite.xml下创建suite集合

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >

<suite name="接口测试集合" verbose="1" preserve-order="true">
<parameter name="report.config" value="src/main/resources/config/report/extent-config.xml"/>
<parameter name="system.info" value="reporter.config.MySystemInfo"/>

<suite-files>
    <suite-file path="article/ArticleFeed-TestSuite.xml"/>
    <suite-file path="post/PostFeed-TestSuite.xml"/>
    <suite-file path="push/RegisterToken-TestSuite.xml"/>
    <suite-file path="sys/SysGetConfig-TestSuite.xml"/>
    <suite-file path="sys/SysGetRegions-TestSuite.xml"/>
    <suite-file path="registerDevice/RegisterDevice-TestSuite.xml"/>
</suite-files>

<listeners>
    <listener class-name="reporter.Listener.MyExtentTestNgFormatter"/>
</listeners>

</suite>

 
#### 写在最后
其实，接口自动化测试平台的搞起来不难。
推动平台接入到持续集成，将测试变成一种服务，更快更及时的服务于项目，才是重点。
正所谓：wiki一定，开发未动，接口已行。
而，服务端测试才挑战。知识储备的深度决定了，测试的深度。

个人GitHub:  https://github.com/Jsir07/TestHub
欢迎Watch + Fork
end...