Java+Maven+TestNG - 创建项目篇

本文是使用IDEA创建一个Java+Maven+TestNG的自动化测试项目，开始之前我们需要做一些准备工作：

1. 安装IDEA， 官网下载community版本就可以
2. Java 版本需要安装JDK11
3. 下载Maven安装包，解压之后配置环境变量

---

1.名词解释

1. 1 什么是Maven？

        Maven是基于项目对象模型(POM project object model)，可以通过一小段描述信息（配置）来管理项目的构建，报告和文档的『软件项目管理工具』。 Maven是通过pom.xml文件的配置获取jar包，而不用手动去添加jar包。

1.2 什么是TestNG？
        TestNG 是java中的一个开源『自动化测试框架』，其灵感来自JUnit和NUnit，TestNG还涵盖了整个核心的JUnit4功能，但引入了一些新的功能。它目前是很流行的单元测试框架，有完善的用例管理模块，配合Maven能够很方便管理依赖，插件。使用TestNG可以做功能、接口、单元、集成的自动化测试，最常见的是结合selenium做功能自动化测试。它的优势是支持依赖测试方法，并行测试，负载测试，局部故障；灵活的插件API；支持多线程测试。

---

2.创建项目

2.1 创建Maven项目

• 因为项目之后要在pipeline上部署，所以我们需要一个代码库，方便以后提交。首先，在GitHub先创建一个仓库，然后将仓库Clone到本地
• 在IDE中打开这个仓库的文件夹，创建一个Maven的quickStart的Module（选择quickStart的原因是这个模板是最简单的，根据需要你也可以尝试其他的模板），创建成功后会自动添加对应的plugins，添加完成后Maven项目就创建完成了。
• 创建完成之后，可以看到在项目的根目录下有一个pom.xml 文件，如果没有这个文件，项目就不会被认为是一个Maven项目。
• 配置.gitignore 文件。 以后编译项目会生成一些编译文件，log文件等占据空间都很大，又不是项目代码，为了以后提交代码方便，没有必要将这些文件上传到代码库。所以我们可以在根目录添加一个 .gitignore 文件，把不需要上传到仓库里的文件写在这里。如下图：
• 创建完成后将所有代码提交到GitHub上

2.2 Maven项目的结构

    ---pom.xml　　　　         核心配置，项目根下
    ---src
        ---main　　　　　　
              ---java　　　　  java源码目录
              ---resources　  java配置文件目录
        ---test
             ---java　　　　   测试源码目录
             ---resources　   测试配置目录
    ---target                 编译之后的class文件存放路径

2.3 pom.xml 文件的结构

2.4 在pom.xml文件中添加TestNG依赖

<dependency>
  <groupId>org.testng</groupId>
  <artifactId>testng</artifactId>
  <version>6.10</version>
  <scope>test</scope>
</dependency>

2.5 pom.xml关联TestNG

        在Maven项目中Maven Surefire Plugin插件是用来执行单元测试的，所以在pom.xml文件中需要添加Maven Surefire Plugin插件，在 configuration 中可以配置需要执行的测试文件，因为是通过TestNG来运行测试，所以这里需要填写TestNG对应的xml文件，在下一步我们会创建testng.xml文件。

    <plugin>
      <artifactId>maven-surefire-plugin</artifactId>
      <configuration>
        <suiteXmlFiles>
          <! -- testng.xml所在的路径，这里指的是相对路径 -- !>
          <suiteXmlFile>testng.xml</suiteXmlFile>  
        </suiteXmlFiles>
      </configuration>
      <version>2.22.1</version>
    </plugin>

        且在执行完之后，surefire的report会存放在target/surefire-reports 文件夹中。

2.6 创建TestNG.xml文件

        运行TestNG测试脚本我们需要配置一个xml文件，使用xml配置文件来执行测试脚本是非常便利的。在xml配置文件里，不仅可以选择某些需要执行的测试脚本，还可以排除某些不需要运行的测试脚本。
        创建testng.xml文件，可以通过IDEA安装一个TestNG插件，在项目中点击右键，选择 “Create TestNG XML” 生成一个 testng.xml 文件，生成的文件有testng.xml文件的基本格式，然后根据项目需要进行修改；基本格式如下：

        * 每一个xml文件只能有一个suite，代表的是一个测试集；
        * 一个suite中可以包含多个test，多个test会按照顺序执行；
        * 每一个test里边可以写需要运行的测试用例的class。如果不写，默认会跑所有的测试用例；
        * 每个class可以指定要执行哪些用例，不执行哪些用例。如果不写method，则默认本类里的全部用例都执行。

注意: 这里我们还没有创建测试用例的脚本，下一步我们会讲解如何创建测试用例。

2.7 执行测试用例

       首先，TestNG的测试用例可以通过在IDE里边运行testng.xml文件来运行测试用例，但是在一个项目中运行测试用例都是使用脚本，Maven也有自己的一些常用命令，我们可以通过Maven命令来执行测试代码。

编译：mvn compile　　--src/main/java目录java源码编译生成class （target目录下）
测试：mvn test　　　　--src/test/java 目录编译
清理：mvn clean　　　 --删除target目录，也就是将class文件等删除
打包：mvn package　　--生成压缩文件：java项目#jar包；web项目#war包，也是放在target目录下
安装：mvn install　　　--将压缩文件(jar或者war)上传到本地仓库
部署：mvn deploy　　   --将压缩文件上传私服

       我们可以通过 mvn test执行测试用例，整个过程是通过调用pom.xml 中的 Maven Surefire Plugin插件 - > 找到对应执行的测试用例 testng.xml 文件 -> 运行testng.xml文件中所配置的测试用例。

---

3.编写测试用例脚本

        项目架子已经大家完成，而且也知道如何去运行测试，接下来创建测试用例的脚本。

        代码：

package org.example;
import org.openqa.selenium.*;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.annotations.Test;

public class BasesCases {

    @Test
    public void searchJavaInBaiDu(){
        System.setProperty("webdriver.chrome.driver", "Driver/chromedriver");
        WebDriver driver;
        driver = new ChromeDriver();
        driver.manage().window().maximize();
        driver.get("https://baidu.com");

        driver.findElement(By.id("kw")).clear();
        driver.findElement(By.id("kw")).sendKeys("java");
        driver.findElement(By.id("su")).click();

        driver.quit();
    }
}

        用例编写完成之后，我们就可以在testng.xml文件中添加要运行的用例，执行mav test来运行测试。最终在target目录下查看测试用例的结果。

---

写在后边：

• 想要学习如何将自动化测试用例部署到CI上，可以进入：
  Java+Maven+TestNG+GoCD - 部署篇
  Java+Maven+TestNG+Jenkins - 部署篇

• 想要学习如何编写POM(Page of Model)自动化测试用例的，敬请期待~