TestNG

文章目录

TestNG
- 一、概述与使用
- - 1.1 配置环境
  - 1.2 测试方法
  - 1.3 使用xml文件
- 二、测试方法常用注解
- - 2.1 配置类注解
  - 2.2 非配置类注解
  - - 2.2.1 @Parameters
    - 2.2.2 @DataProvider
- 三、依赖测试
- 四、忽略测试
- 五、超时测试
- 六、分组测试
- 七、失败重试机制
- - 7.1 IRetryAnalyzer接口
  - 7.2 测试方法引入失败重试
  - - 7.2.1 通过注解的方式
    - 7.2.2 通过实现接口 + 监听器的方式

一、概述与使用

TestNG是一款设计测试用例执行流程的测试框架。

1.1 配置环境

添加依赖

<dependency><groupId>org.testng</groupId><artifactId>testng</artifactId><version>6.14.3</version>
</dependency>

安装插件

1.2 测试方法

//导入的两个包均为testng的
import org.testng.Assert;
import org.testng.annotations.Test;public class Tester {@Testpublic void test() {//自定义add方法用来计算两个参数的和int res = Calculator.add(3, 4);int expected = 7;//断言，如果参数的两个值一样，断言就通过，否则抛出异常Assert.assertEquals(res, expected);}
}

运行结果成功示例：

运行结果失败示例（将expected值修改为5）：

1.3 使用xml文件

testng.xml 文件用来设计测试用例的执行流程。

在对应的项目右键，选择如下：

生成的文件如下图：

xml 配置文件解析

<suite>：套件就是将所有的测试类整理在一块，形成一套测试用例
<test>：测试集就是测试类的集合，一般把项目的某一个模块设计成一个测试集
<classes>：测试集下的所有测试类
<class>：具体测试类，name 属性指定测试类的路径
<methods>：测试类下具体的测试方法，如果不写此标签则默认包含测试类下的所有方法

以后需要执行哪些测试方法，在xml文件中编写对应的标签即可。

运行xml配置文件

运行 testng.xml 文件其实运行的是套件中定义的所有测试集下的所有测试类中的指定的测试方法。

xml文件右键选择Run，结果如下：

二、测试方法常用注解

2.1 配置类注解

@Test 标记的方法：标记测试方法
- 如果有多个测试方法，执行顺序按照方法名的字典顺序执行，与定义顺序无关
＠BeforeSuite／＠AfterSuite 标记的方法：在某个测试套件（suite）开始之前运行／在某个测试套件所有测试方法执行之后运行
＠BeforeTest／＠AfterTest 标记的方法：在某个测试集（test）开始之前运行／在某测试集下的所有测试类中的测试方法执行之后运行
＠BeforeClass／＠AfterClass 标记的方法：在某个测试类（class）开始之前运行／在某个测试类中的所有测试方法执行之后运行
＠BeforeMethod／＠AfterMethod 标记的方法：在某个测试方法（method）之前运行／在某个测试方法执行之后运行

使用上述所有注解的方法执行顺序：

BeforeSuite
BeforeTest
BeforeClass
{ BeforeMethodTestAfterMethod }
AfterClass
AfterTest
AfterSuite

注意：

上述 {} 内的注解表示有几个 @Test ，这些注解标记的方法就要执行多少次
除了 @BeforeSuite、@BeforeTest、@AfterTest、@AfterSuite 可以对不同的测试类生效外，其他注解的作用范围只在本类中生效。所以，如果想要在别的类中共用某些方法，可以将这些方法声明在上述四个注解中
图示如下：

2.2 非配置类注解

2.2.1 @Parameters

先在 testng.xml 文件中定义参数标签
对应的测试方法使用注解

2.2.2 @DataProvider

使用此注解的方法用来提供多组测试数据，返回值是二维数组。

使用示例：

@DataProvider
public Object[][] dataResult() {return new Object[][]{{"火星哥", 22, "男"},{"霉霉", 23, "女"}};
}@Test(dataProvider = "dataResult") //值为方法名
public void test(String name, int age, String sex) {System.out.println(name + age + sex);
}/*** @DataProvider(name = "myName")，使用时不再使用方法名，而使用指定的myName名称*/

运行结果：

注意：代码中写测试用例效率较低，一般都是读取excel中的测试用例作为返回值。

三、依赖测试

某测试方法的执行需要依赖于另一测试方法的执行。

使用示例：

@Test(dependsOnMethods = {"test2"})
public void test1() {System.out.println("test1()");
}@Test
public void test2() {System.out.println("test2()");
}

运行结果：

按照字典顺序应该test1()先执行，但是由于test1()依赖于test2()，所以test2()先执行：

四、忽略测试

执行某一测试类时忽略某一测试方法。

使用方法：@Test(enabled = false)

五、超时测试

某一测试方法执行的时间超过指定的毫秒数，则认为此方法执行失败并终止执行抛出异常：

使用方法：@Test(timeOut = 1000)

六、分组测试

可用于只想执行某一部分测试用例时使用。

定义测试方法并指定分组

@Test(groups = {"g1"})
public void test1() {System.out.println("g1分组的test1()方法执行");
}@Test(groups = {"g1"})
public void test2() {System.out.println("g1分组的test2()方法执行");
}@Test(groups = {"g2"})
public void test3() {System.out.println("g2分组的test3()方法执行");
}

testng.xml 文件中定义 groups 标签
运行结果

七、失败重试机制

有时在测试过程中，可能会出现失败的情况，如果想要重试失败的测试方法就需要使用 TestNG 的失败重试机制。

7.1 IRetryAnalyzer接口

如果想要使用 TestNG 的失败重试机制，就必须了解此接口。

该接口的定义如下：

public interface IRetryAnalyzer {/*** 1. 如果测试方法需要重试则此方法返回true，否则返回false* 2. 参数result表示刚刚运行的测试方法的运行结果*/public boolean retry ( ITestResult result ) ;
}

经过配置之后，一旦测试方法失败，将调用此方法，可以从参数 result 中得到该测试方法的详细信息。如果要重新执行失败的测试，此方法实现应返回true，如果不想重新执行测试，则返回false。通常，此接口的实现类中定义重试的次数。

使用举例：

@Slf4j
public class RetryListener implements IRetryAnalyzer {//定义重试次数的初始值private int initReTryNum = 1;//定义最大重试次数private int maxReTryNum = 3;@Overridepublic boolean retry(ITestResult iTestResult) {if (initReTryNum <= maxReTryNum) {//组装error messageString message = "方法名: " + iTestResult.getName() + " " + "运行失败，正在进行第 " + initReTryNum + " 次重试";System.out.println(message);//重试次数+1            initReTryNum++;//还没有达到最大重试次数，继续重试return true;}return false;}
}

7.2 测试方法引入失败重试

7.2.1 通过注解的方式

该方式可以精确的指定某个测试方法进行失败重试。

在 @Test 注解的属性 retryAnalyzer 中指定 IRetryAnalyzer 的实现类。

使用举例：

public class Test {//此方法指定重试机制@Test(retryAnalyzer = RetryListener.class)public void test1() {Assert.assertEquals(false, true);}//此方法没有指定失败重试@Testpublic void test2() {Assert.assertEquals(false, true);}
}

运行结果：

只有 test1() 进行了指定次数的重试，因为仅在 test1() 的 @Test 注解中指定了 IRetryAnalyzer 的实现类，test2() 仅执行一次，因为没有在 test2() 的 @Test 注解中指定 IRetryAnalyzer 的实现类。

7.2.2 通过实现接口 + 监听器的方式

需要实现 ITestAnnotationTransformer 接口，会自动的在测试运行期间为每个测试方法调用重写的 transform 方法。也就是说，这种方式会为所有测试方法设置失败重试。

使用举例：

实现 ITestAnnotationTransformer 接口

import org.testng.internal.annotations.IAnnotationTransformer;
import java.lang.reflect.Method;public class OverrideIAnnotationTransformer implements IAnnotationTransformer{@Overridepublic void transform(ITestAnnotation iTestAnnotation, Class aClass, Constructor constructor, Method method) {IRetryAnalyzer iRetryAnalyzer= iTestAnnotation.getRetryAnalyzer();if(iRetryAnalyzer==null){//设置指定的IRetryAnalyzer接口的实现类iTestAnnotation.setRetryAnalyzer(RetryListener.class);}	}
}

配置 testng.xml 的监听器

<suite name="All Test Suite"><listeners><!-- 定义IAnnotationTransformer的实现类 --><listener class-name="com.qizegao.interfacetest.OverrideIAnnotationTransformer"/></listeners><test verbose="2" preserve-order="true" name="F:/InterfaceTest"><classes><class name="com.qizegao.test.Test001"/></classes></test>
</suite>