TestNG 单元测试详解

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 方法。

Annotation

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

4、testng.xml介绍

4.1.例 1

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

Test1.java 代码:

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 代码

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。

5.2.测试组(test groups)

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

5.2.1.例 1

修改 Test1.java 内容下

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 内容下

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 如下

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 内容如下

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.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，代码内容如下

运行结果，输出:

data provider 返回以下类型之一:

1)返回一个 object[][]，数组第一维度的大小，代表了测试方法被调用的次数，第二维度则包含了和测试方法的参数类型匹配的任意对象数组。

2)返回一个迭代器 Iterator<0bject[]>。

eg:

java 复制代码

@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.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.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