java test使用手册,Java自动化测试框架-12 - TestNG之xml文件详解篇 （详细教程）

1.简介

现在这篇，我们来学习TestNG.xml文件，前面我们已经知道，TestNG就是运行这个文件来执行测试用例的。通过本篇，你可以进一步了解到：这个文件是配置测试用例，测试套件。简单来说，利用这个文件，我们可以跑同一个类或者多个不同类里面的测试用例。

TestNG通过设置testng.xml文件能做以下事情

1)创建来源不同包、类、方法的测试套件

2)包括一些选项，例如失败的用例可以重跑。

3)支持使用正则表达式

4)运行把外部参数传入测试方法

5)支持配置多线程的执行环境

testNG启发自JUnit和NUnit的一种测试框架，通过使用testNG使的测试更简单。，比如如下的一些特点：

1.通过注释来管理测试

2.多线程并发执行测试，且是安全的

3.支持数据驱动测试

4.支持在多样化的平台上使用(Eclipse、IDEA、Maven等)

5.嵌入了BeanShell，使的更具灵活性

6.支持依赖

2.testNG的xml文件的结构

2.1简单的大概结构如下：

---- ---- ---- -- ---- -- ---- -- --

2.2比较详细的结构如下：

3.文档具体的元素说明

3.1

testNG.xml文件的最外层标签即suite，即测试套件，其下可以有多个和，其有几个可以添加的属性

说明：一个xml文件只能有一个,，是一个xml文件的根级

由和组成

参数说明：

参数

说明

使用方法

参数值

name

必选项，的名字，将出现在reports里

name="XXX"

suite名字

junit

是否执行Junit模式(识别setup()等)

junit="true"

true和false，默认false

verbose

控制台输出的详细内容等级,0-10级(0无，10最详细)

verbose="5"

0到10

parallel

是否在不同的线程并行进行测试，要与thread-count配套使用

parallel="mehods"

详见表格下内容，默认false

parent-module

和Guice框架有关，只运行一次，创建一个parent injector给所有guice injectors

guice-stage

和Guice框架有关

guice-stage="DEVELOPMENT"

DEVELOPMENT，PRODUCTION，TOOL，默认"DEVELOPMENT"

configfailurepolicy

测试失败后是再次执行还是跳过，值skip和continue

configfailurepolicy="skip"

skip、continue，默认skip

thread-count

与parallel配套使用，线程池的大小，决定并行线程数量

thread-count="10"

整数，默认5

annotations

获取注解，值为javadoc时，使用JavaDoc的注释；否则用JDK5注释

annotations="javadoc"

javadoc

time-out

设置parallel时，终止执行单元之前的等待时间(毫秒)

time-out="10000"

整数，单位毫秒

skipfailedinvocationcounts

是否跳过失败的调用

skipfailedinvocationcounts="true"

true和false，默认false

data-provider-thread-count

并发时data-provider的线程池数量

data-provider-thread-count="5"

整数

object-factory

一个实现IObjectFactory接口的类，实例化测试对象

object-factory="classname"

类名

allow-return-values

是否允许返回函数值

all-return-values="true"

true和false

preserve-order

是否按照排序执行

preserve-order="true"

true和false，默认true

group-by-instances

按照实例分组

group-by-instances="true"

true和false，默认false

parallel

该参数的值false，methods，tests，classes，instances。默认false

parallel必须和thread-count配套使用，否则相当于无效参数，thread-count决定了并行测试时开启的线程数量

parallel="mehods"  TestNG将并行执行所有的测试方法在不同的线程里

parallel="tests"  TestNG将并行执行在同一个下的所有方法在不同线程里

parallel="classes"  TestNG将并行执行在相同下的方法在不同线程里

parallel="instances"  TestNG将并行执行相同实例下的所有方法在不同的县城里

parent-module和guice-stage和Guice框架有关，testNG 6对Guice框架提供了支持，我没用过这个框架，所以这两个参数没看懂╮(╯▽╰)╭

3.2

说明：引入外部的xml文件(地址由path参数决定，path必填项)，将引入的xml与当前的xml文件一起使用

声明方法：

3.3

此标签无特别意义，其下可以包括多个标签，如groups、classes等

说明：一个下可以有多个，可以通过的parallel="tests"来进行并行测试，必须和thread-count配套使用，否则是无效参数

由、、三部分组成

参数说明：

参数

说明

使用方法

参数值

name

test的名字，将出现在报告里

name="testname"

test的名字

junit

是否按照Junit模式运行

junit="true"

true和false，默认false

verbose

控制台输出的详细内容等级,0-10级(0无，10最详细)，不在报告显示

verbose="5"

0到10

parallel

是否在不同的线程并行进行测试，要与thread-count配套使用

parallel="mehods"

与suite的parallel一致，默认false

thread-count

与parallel配套使用，线程池的大小，决定并行线程数量

thread-count="10"

整数，默认5

annotations

获取注解，值为javadoc时，使用JavaDoc的注释；否则用JDK5注释

annotations="javadoc"

javadoc

time-out

设置parallel时，终止执行单元之前的等待时间(毫秒)

time-out="10000"

整数，单位毫秒

enabled

标记是否执行这个test

enabled="true"

true和false，默认true

skipfailedinvocationcounts

是否跳过失败的调用

skipfailedinvocationcounts="true"

true和false，默认false

preserve-order

是否按照排序执行，如果是true，将按照xml文件中的顺序去执行

preserve-order="true"

true和false，默认true

allow-return-values

是否允许返回函数值

all-return-values="true"

true和false，默认false

3.4

说明：提供测试数据，有name和value两个参数

声明方法：

testng.xml文件中的可以声明在或者级别，在下的会覆盖在下声明的同名变量

3.5

说明：方法选择器定义了哪些类的方法需要去执行，类必须继承自org.testng.IMethodSelector

声明方法：

(language还可以用beanshell等)

备注：这个我没用过，所以了解，如果有错的欢迎指出来~

3.6

此标签必然是在标签下的，用于标识那些组会被用于测试或者被排除在测试之外，其同级必然要包含一个标签或者标签，用于指定groups来自于哪些包或者类

说明：要运行的组，可以自定义一个组，可以包括要执行的，还排除要执行的方法。必须和配套使用，从下面的类中找到对应名字的方法

由和、三部分组成。可以将group组成一个新组，包括要执行和不执行的大组；要执行的方法；指定了某group需要依赖的group(比如下面的例子，group1需要依赖group2和group3先执行)。

声明方法：

3.7

说明：方法选择器，要执行的方法写在这里，参数有name和priority。

注释：

1.下必须写要执行的，否则不会执行任何内容，如果填写了class没有写methods，会按照填写的class的下的注释@Test去执行所有的方法

2.下的如果填写了，那只会执行所填写的方法，没有填写的方法不会去执行

声明方法：

3.8

说明：指定包名代替类名。查找包下的所有包含testNG annotation的类进行测试

声明方法：

3.9

说明：指定listeners，这个class必须继承自org.testng.ITestNGListener。在java中使用@Listeners({com.example.MyListener.class,com.example.MyMethodInterceptor.class})的注释也可以有同样效果

声明方法：

4.小结

好了，今天关于TestNG之xml文件详解篇 ，就分享到这里。