01 TestNG

01 简介

在日常测试工作中,经常需要用写代码和脚本来完成一些测试任务,比如自动化测试,接口测试,单元测试等。当写完若干脚本后,需要对这些脚本进行组织、管理和结果统计,这个时候就需要有一个工具来负责这些事情,于是TestNG就出现了。

TestNG是Java体系中的一个测试框架,可以用于做单元测试、集成测试等。在TestNG之前,有一个类似的框架早就出现了,那就是Junit。TestNG借鉴了Junit的一些特点,然后增加了很多更强大的功能。成为Java体系里使用最广泛的测试框架。

需要注意的是,很多人理解TestNG是一个接口测试框架,其实并不是的,TestNG本身不能做接口测试,它主要用来管理你的接口测试。类似于Python里的pytest框架。今天我们就来详细介绍下TestNG的使用。

02 环境安装

创建一个Maven工程,引入TestNG的依赖包

<dependency> 

   <groupId>org.testng</groupId>

   <artifactId>testng</artifactId>

   <version>6.8</version>

</dependency>

一个简单的小例子

写一个简单的计算器类

//一个简单的加减乘除计算器
public class Calculator {
    // 加法
    public int add(int a, int b){
        return a + b;
    }
    // 减法
    public int subtract(int a, int b){
        return a - b;
    }
    // 乘法
    public int multiply(int a, int b){
        return a * b;
    }
    // 除法
    public int divide(int a, int b){
        return a / b;
    }
}

接下来对这个计算器进行单元测试,创建一个测试类,并对加法运算编写了一个测试方法

// 计算器测试类
public class CalculatorTest {
    // 加法测试
    @Test
    public void testAdd(){
        System.out.println("开始执行testAdd");
        Calculator calculator = new Calculator();
        int result = calculator.add(1, 1);
        Assert.assertEquals(2, result);
    }
    // 减法测试
    @Test
    public void testSubtract(){
        System.out.println("开始执行testSubtract");
        Calculator calculator = new Calculator();
        int result = calculator.subtract(2, 1);
        Assert.assertEquals(1, result);
    }
}

注意:

在上面代码中,testAdd方法上添加了一个@Test注解,这个是TestNG提供的一个注解(可以理解成一个标记),改注解标明此方法需要TestNG来执行,@Test注解也是最常使用的注解。

Assert是TestNG中的断言类,assertEquals是最常用的一个方法,用于判断期望值和实际值是否一致。如果一致,测试通过;如果不一致,测试不通过。

03 TestNG的执行

IntelliJ IDEA中内置了TestNG的支持,因此直接在方法名上右键,选择"run testAdd"即可,并且会在控制台上打印用例的执行结果。

java 接口怎么测试 java接口单元测试_单元测试

控制台打印,如果都显示为绿色,就代表执行成功了

java 接口怎么测试 java接口单元测试_java_02

也可以在类上右键运行,TestNG中会运行整个类中所有带@Test注解的测试方法

02 套件测试

01 套件定义

一个测试类里会编写若干个测试方法。如果某个场景需要执行多个测试类,就需要用到套件测试。套件是一组测试类的集合。在TestNG中,需要使用一个xml文件来定义一个套件,套件里可以包含1个或多个测试类。在xml中还可以很多灵活的配置,实现一些精细化的执行策略。

在Maven工程的resource目录下创建一个testng.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
<suite name="TestAll">

  <!--执行整个类-->

    <test name="calculator_all_class">
        <classes>
             <!-- 指定类名,可以添加多个-->

            <class name="com.mtx.CalculatorTest"></class>
        </classes>
    </test>
    <!--仅执行某个方法-->

    <test name="calculator_one_method">
        <classes>
            <class name="com.mtx.CalculatorTest">
                <methods>
                       <!--指定方法名,可以添加多个-->

                    <include name="testAdd"></include>
                </methods>
            </class>
        </classes>
    </test>
</suite>

在xml中,一个test标签就代表了一个执行用例,可以执行一个或多个类,或者指定一个或多个方法(见注释)

02 套件执行

在xml上右键run即可运行整个套件,执行结果

java 接口怎么测试 java接口单元测试_java 接口怎么测试_03

03 数据驱动

在很多测试用例中,对于同一套逻辑,需要使用大量不同的数据进行验证,这个情况下可以使用TestNG的@DataProvider注解来提供数据,并驱动测试用例执行

在测试类中定义一个数据驱动方法,并添加@DataProvider注解

// 加法测试
@Test(dataProvider = "testAddData")
public void testAdd(int a, int b, int expect){
    System.out.println("开始执行testAdd");
    Calculator calculator = new Calculator();
    int result = calculator.add(a, b);
    Assert.assertEquals(expect, result);
}
// 提供了三组测试数据:{数字1, 数字2, 期望值}
// 因为返回类型的Object,所以数组中也可以写其他数据类型,String、int、char、float等
@DataProvider(name = "testAddData")
public Object[][] testAddData(){
    Object[][] data = new Object[][]{{1, 1, 2}, {2, 2, 4}, {3, 3, 5}};
    return data;
}

注意:

提供数据的providerData方法必须添加注解@DataProvider,并且执行name为testAddData。方法返回的数据类型必须为Object二维数组

使用数据的testAdd方法上,必须制定对应的dataprovider name,并且方法上定义对应数量和类型的入参,用于接受数据

执行testAdd方法后,发现执行了三次,每次分别传入不同的参数,第三组数据执行因为实际和预期不一致,执行结果为失败

java 接口怎么测试 java接口单元测试_java_04

04 其他注解

除了@Test注解,还有一些其他的注解也经常使用,具体如下:

java 接口怎么测试 java接口单元测试_测试工程师_05

@BeforeClass
public void classInit(){
    System.out.println("类执行前测试");
}
@AfterClass
public void classEnd(){
    System.out.println("类执行后测试");
}
@BeforeTest
public void testInit(){
    System.out.println("测试方法执行前测试");
}
@AfterTest
public void testEnd(){
    System.out.println("测试方法执行后测试");
}

执行结果:

java 接口怎么测试 java接口单元测试_单元测试_06

05 命令行执行

除了在idea中执行TestNG测试方法外,另外一种更实用的执行方法是命令行执行,使用命令行执行更容易和其他外部工具进行集成,比如Jenkins。然而TestNG自身提供的命令行执行方式并不好用。比较简单的方法是和Maven集成,实用maven的方式来调用TestNG。

在工程的pom文件里,添加插件:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <testFailureIgnore>true</testFailureIgnore>
                <suiteXmlFiles>
                    <suiteXmlFile>src/main/resources/testng.xml</suiteXmlFile>
                </suiteXmlFiles>
            </configuration>
        </plugin>
    </plugins>
</build>

在suiteXmlFile标签里,指定testng.xml文件的相对位置。

然后在cmd下,进入到工程的目录下,执行命令:mvn test,可以看到,最终在控制台里打印出了测试结果

java 接口怎么测试 java接口单元测试_java 接口怎么测试_07