当前位置：首页 > article >正文

TestNG 单元测试详解

article 2026/1/23 4:12:07

1、测试环境

jdk1.8.0 121

myeclipse-10.0-offline-installer-windows.exe

TestNG 插件

org.testng.eclipse 6.8.6.20130607 0745

2、介绍

套件(suite):由一个 XML 文件表示,通过<suite>标签定义,包含一个或更多测试(test)。测试(test):由<test>定义，包含一个或更多 TestNG 类(class)。TestNG类(class):至少包含一个TestNG注释(annotation)的java 类，由<class>标签定义，包含一个或多个测试方法(test medthod)。测试方法(test method):一个附注了@Test 的 java 方法。

3. Annotation

更多解释，可以查看官方文档的介绍

4、testng.xml介绍

4.1.例 1

注:test-output是运行后自动生成的。xmltest.xm1是在对应目录下新建的，testng-1.0.dtd 也是下载后，手动放进去的。

Test1.java 代码:

package unittests;
import org.testng.annotations.*
public class Test1 {
@Test
public void func1(){System.out.println("test in func1");
public void func2(){System.out.println("test in func2");

testng-1.0.dtd下载地址:http://testng.org/testng-1.0.dtd

右键 xmltest.xml-> Run As TestNG Suite，运行套件,输出如下:

说明:
1、只有被附注了@Test 的方法才会被执行。
2、如果右键只能看到 Run As Run Configurations，则右键项目，选择 refresh 刷新

3、TestNG 类没有归属 package，也可以如下编写 xml(当前版本的插件是不允许新建TestNG Class 时不提供包名的，通常建议提供包名)

4.2.例 2

也可以指定包名，而非类名,TestNG将查找 unittests 包中所有 class，且仅保留携带TestNG 注解的类。

运行结果同上

4.3.例3
还可以指定需要包含/排除的 group 和方法。

修改 Test1.java 代码

package unittests;
import org.testng.annotations.*;
public class Test1 {@Test(groups={"functest","checkintest"})public void func1(){System.out.println("test in func1");
@Test(groups={"functest""checkintest"})
public void func2(){
System.out.println("test in func2");
@Test(groups={"functest"})public void func3(){System.out.println("test in func3");

问题:保存代码后，编辑器中，代码 package unittests;右侧会提示“红叉”解决方法:

修改 xmltest.xml

运行结果:未执行任何一个测试方法。
再修改下，把

说明:
1、例中的<include>和<exclude>是 and 关系，而非 or 的关系

2、仅提供 groups 元素配置，不提供 class 元素，执行后不调用任何测试方法

3、还可以为 group 添加其它属性，比如是否并发运行，使用多少线程，是否运行Junit

运行结果:只执行了 func1 测试方法

说明:
同时设置了groups 和method元素,且同时为groups和method设置了include、exclude为 method 元素设置 include 属性，那么 groups 元素的设置不起作用，仅执行 method中需要 include 的方法

只为method元素设置exclude属性,那么根据groups 元素设置得出需要运行的测试方法然后在此基础上过滤掉 method 元素的 exclude 属性设置的方法。

4.4.例 4

默认的，TestNG 依据出现在 xm1 中的顺序执行测试。可以设置 preserve-order 属性为false 来改变这一行为。
修改xmltest.xml如下

5.测试方法(Test method)，测试类(Test class)，测试组(Test groups)

5.1.测试方法(Test method)

默认的，被附注了@Test 的测试方法，其返回值被忽略，除非设置 allow-return-values值为 true。
<suite allow-return-values="true">
or
<test allow-return-values="true">

5.2.测试组(test groups)

groups 可以位于<test>、<suite>元素内。如果在<suite>标签下指定 groups,那么 group设置作用于该 suite 下的所有<test>。

5.2.1.例 1

修改 Test1.java 内容下

package unittests;
import org.testng.annotations.*
public class Test1 {@Test(groups={"functest","checkintest"})public void testMethod1(){System.out.println("test in func1");
@Test(groups={"functest","checkintest"})public void testMethod2(){System.out.println("test in func2");
@Test(groups={"functest"})public void testMethod3(){System.out.println("test in func3");

groups 元素放在<test>标签下

groups 元素放在<suite>标签下

5.2.2.例 2

使用正则表达式。
修改 Test1.java 内容下

package unittests;
import org.testng.annotations.*;
public class Test1 {
@Test(groups={"windows.functest"})public void testMethod1(){System.out.println("test in func1");
@Test(groups={"linux.functest"})public void testMethod2(){System.out.println("test in func2");
@Test(groups={"functest"})public void testMethod3(){System.out.println("test in func3");

修改 xmltest.xml如下

运行结果:
只执行了 testMethod1

5.2.3.例 3

方法组(method groups)包含、排除单个测试方法修改 xmltest.xm1 内容如下:

运行结果:testMethod1，testMethod2，testMethod3 都被执行了。

嵌套组
组可以包含组。
修改 Test1.java 如下

package unittests;
import org.testng.annotations.*;
public class Test1 {@Test(groups={"functest","checkintest"})public void testMethod1(){System.out.println("test in func1");
@Test(groups={"functest","checkintest"})public void testMethod2(){System.out.println("test in func2");
@Test(groups={"functest"})public void testMethod3(){System.out.println("test in func3");

修改xmltest.xm1

运行结果:
3个测试方法都被执行了，为何?难道是 bug?不理解

排除组

运行结果:
只执行了 testMethod3 测试方法

Partial 组
可在 class级别添加组，然后在方法级别添加组修改 Test1.java 内容如下

package unittests;
import org.testng.annotations.*.
@Test(groups="functest")
public class Test1 {
@Test(groups={"checkintest"})public void testMethod1(){System.out.println("test in func1");
@Test(groups={"checkintest"})public void testMethod2(){System.out.println("test in func2");
@Test
public void testMethod3(){System.out.println("test in func3");

xmltest.xml 内容如下

运行结果:仅执行了 testMethod3

说明:TestNG类中所有被附注了@Test的测试方法，默认都归属在类级别定义的group

6. 参数
6.1.来自 testng.xml 的参数
6.1.1.例 1
修改 Test1.java

修改 xmltest.xml

参数还可以用于@Before/After 和@Factory

6.1.2.例 2可用@0ptional 来声明参数可选

修改 Test1.java

说明:如果在 xm1 文件中找不到参数 arg_in_xm1，那么使用 0ptional 括号中的值作为参都
修改 testxml.xm1

6.2.携带 DataProvider 的参数

6.2.1.例 1

修改 Test1.java

注意:必须用 dataProvider 属性指明 Data Provider，属性值必须和@DataProvider(name="...")中 name 的值保持一致。另外，参数个数得保持一致。

修改 xmltest.xm1

运行结果，输出如下数据:
rebort 36
2014 37
默认的，TestNG 会在当前测试类、其某个父类中査找 Data Provider。如果想把 dataprovider 放在其它的类中,那么被附注的方法必须是静态方法、或者携带无参构造器的类,并在 dataProviderClass 属性中指定该类。

6.2.2.例 2

在 unittests 包下新建一个 StaticProvider.java，代码内容如下

运行结果，输出:
42

data provider 返回以下类型之一:
1)返回一个 object[][]，数组第一维度的大小，代表了测试方法被调用的次数，第二维度则包含了和测试方法的参数类型匹配的任意对象数组。
2)返回一个迭代器 Iterator<0bject[]>。
eg:

@DataProvider(name ="test1")public Iterator<Object[]>createData(){return new MyIterator(DATA);

6.2.3.例 3

如果声明@DataProvider接收一个java.lang.reflect.Method作为第一个参数,TestNG将会把当前测试方法传递给该参数。
修改 Test1.java 内容如下

如果想在不同的线程池中运行多个 data provider,需要从 xm1 文件中运行它们。

7. 依赖

7.1.使用注解的依赖

7.1.1.例 1
依赖方法
修改 Test1.java 内容如下

运行结果，先后输出:test2
test1

说明:test1的运行依赖 test2 的运行注意:这种依赖，如果被依赖者运行失败，那么依赖者的不被执行，报告中被标记为 SKIPeg:修改 test2方法如下,再次运行

7.1.2.例 2
利用@Test 的属性设置 alwaysRun=true 解决例2中被依赖者运行失败，不执行依赖者的
问题
修改 Test1.java

7.1.3.例 3
依赖组

更多资料参考： Otaku – Cedric's blog

默认的，依赖方法按组分类，如果方法 test1 和方法 test2 都是同一个测试类的测试方法,test1依赖test2,那么当该类的多个实例被调用时,会先执行完所有test2,再执行test1.

7.1.4.例 4
新建 testNG 测试类

运行结果

7.2.XML 中的依赖
可选的，可在 testng.xm1 文件中指定组依赖。使用<dependencies>标签来实现这个。修改 Test1.java 内容如下

修改 xmltest.xml 内容如下

注意:被依赖的多个组之间用空格分隔。

8. 工厂模式
动态的创建测试。
8.1.例1
假设，你想创建一个测试方法，使用不同的值，多次访问某个web站点的页面

如果继续按这个思路继续，很快就会变得难以管理。所以考虑使用工厂模式新建 TestNG 类文件 WebTest.java

新建 TestNG 类文件 WebTestFactory.java

修改 xmltest.xml 如下

运行结果:webTest 中的测试方法也被执行了
说明:附注@Factory 注解的方法中构造某测试类的实例,会自动调用该测试类中带有@Test注解的方法
当然，也可以在 java 程序中通过代码来运行新建 Test2.java，内容如下:

factory 方法接收类似@Test 和@Before/After 的参数，且必须返回 0bject[]。返回的对象可以是任何类实例(注:对象所在类，不含@xxxx注解的方法不被执行)。

@Factory 也可以配合 data provider 使用，可用于构造器或者普通方法
8.2.例 2
修改 WebTestFactory.java 内容如下

结果:运行了 30 次测试，即 testServer 被调用了 38 次。

9.类级别的注解

运行结果:test1,test2都被执行了，也就是说类级别的@Test 注解会把该类的所有公有方法都当作测试方法，不管是否有注解。这种情况下，依旧可为单个类方法进行注解以添加其他属性，比如归属的组别

10.并行和超时
10.1. 并行套件
假如有多个套件需要运行。修改 xmltest.xml如下，复制xmltest.xml分别为xmltest2.xml，xmltest3.xml，修改套件名分别为suite2，suite3

注意:要先 javac 对类文件进行编译，否则会报错，类似如下:ITestNG] [ERROR]
Cannot find class in classpath:unittests.Test1
运行套件

且想让每个套件在单独的线程中运行，可添加-suitethreadpoolsize选项java org.testng.TestNG -suitethreadpoolsize 3 testng.xml testng2.xmltestng3.xml

10.2.并行test,class,method
略
11.返回失败测试
TestNG 会为每次运行套件失败的测试，在结果输出目录(如果为用 -d outpu_dir 指定目录则结果输出目录为在当前工作目录下的生成的 test-outputs)下创建一个名为testng-failed.xm1 的文件。可按如下方式运行失败的用例。src>java org.testng.TestNG test-output/testng-failed.xml

12.JUnit tests

13.Annotation 转换略
14.Method Interceptors略
15. TestNG Listeners
哈
16. Dependency injection
贻
17.重写测试方法
略
18.更改套件、方法略

19.通过编程方式运行 TestNG

假设想同运行如下假设的 xm1 一样，通过编程方式运行 TestNG 可如下操作

20.测试结果

20.1. 成功，失败断言

20.1.1.例 1

修改 Test1.java 内容如下

为了满足更复杂对象的断言，可导入 JUnit 的 Assert 类。20.1.2.例 2
修改 Test1.java 内容如下

注意:使用 static import 是为了在使用断言方法，如 assertEquals 时，不用携带包名类名，如果不用 static，则需要这么使用:org.testng.AssertJUnit.assertEquals
20.2. Logging和结果
20.2.1.logging 监听器
例: