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简单的大概结构如下：
<suite> --<test> -- --<parameter> -- --<test> -- -- -- <parameter> -- -- -- <groups> -- -- -- <classes>
2.2比较详细的结构如下：
<suite> <suite-files> <suite-file path="">suite-file> suite-files> <parameter name="" value="">parameter> <method-selectors> <method-selector> <selector-calss name="">selector-calss> mehod-selector> method-selectors> <test name=""> <parameter name="" value=""><parameter> <groups> <define name=""> <include name=""/> <exclude name=""/> define> <run> <include name=""/> <exclude name=""/> run> groups> <classes> <class name=""> <mehods> <parameter name="" value="">parameter> <include name="">include> <exclude name="">exclude> methods> class> <class>class> classes> <packages> <package name=""> <include name="">include> <exclude name="">exclude> package> packages> <listeners> <listener class-name=""/> listenters> test> <test>test> suite>
3.文档具体的元素说明
3.1
testNG.xml文件的最外层标签即suite，即测试套件，其下可以有多个
说明：一个xml文件只能有一个
参数说明：
| 参数 | 说明 | 使用方法 | 参数值 |
| name | 必选项， |
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 |
该参数的值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文件一起使用
声明方法：
<suite-files> <suite-file path="/path/suitefile1">suite-file> suite-files>
3.3
此标签无特别意义，其下可以包括多个标签，如groups、classes等
说明：一个
参数说明：
| 参数 | 说明 | 使用方法 | 参数值 |
| 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
声明方法：
<method-selectors> <method-selector> <selector-class name="classname" priority="1">selector-class> <script language="java">script> （language还可以用beanshell等） method-selector> method-selectors>
备注：
3.6
此标签必然是在
说明：要运行的组，可以自定义一个组，可以包括要执行的，还排除要执行的方法。必须和
声明方法：
<groups> <define name ="all"> <include name ="testgroup1"/> <exclude name ="testgroup2'/>/> <include name ="testmethod1"/> <exclude name="testmethod2"/> run> <dependencies> <group name ="group1" depends-on="goup2 group3"/> dependencies> groups> all"
3.7
说明：方法选择器，要执行的方法写在这里，参数有name和priority。
注释：
1.
2.
声明方法：
<classes> <class name="要执行的class名"> <methods> <include name ="要执行的方法名">include> methods> class> classes>
3.8
说明：
声明方法：
<packages> <package name="packagename"/> <package name="packagename"> <include name="methodname"/> <exclude name="methodname"/> package> packages>
3.9
说明：指定listeners，这个class必须继承自org.testng.ITestNGListener。在java中使用@Listeners({com.example.MyListener.class,com.example.MyMethodInterceptor.class})的注释也可以有同样效果
声明方法：
<listeners> <listener class-name="com.example.MyListener"/> <listener class-name="com.example.MyMehodIntercepor"/> listeners>
4.小结
好了，今天关于TestNG之xml文件详解篇 ，就分享到这里。