针对testng.xml,分不同层级进行xml运行时配置文件的编写,一个典型的xml文件配置如下:
<suite>
<test name="xxxx">
<!-- 参数定义的方法 -->
<parameter name="first-name" value="Cedric"/>
<!-- groups的用法,前提是需要存在classes的组,否则所有方法不被运行 -->
<groups>
<!-- 定义组中组的方法 -->
<define name="groups_name">
<include name="group1"/>
<include name="group2"/>
</define>
<run>
<!-- 此处用组名来区别 -->
<inclue name="groups_name" />
<exclue name="groups_name" />
</run>
</groups>
<!-- classes的用法,classes中包含类名,类名底下可以包含方法名或排除方法名 -->
<classes>
<class name="class1">
<methods>
<!-- 此处用方法名来区别 -->
<inclue name="method_name" />
<exclue name="method_name" />
</methods>
</class>
</classes>
</test>
</suite>
通用的结构树:
suite
--tests
----parameters
----groups
------definitions
------runs
----classes
<suite>标签
testng.xml文档中最上层的元素
说明:一个xml文件只能有一个<suites>,是一个xml文件的根级
<suite>由<test>和<parameters>组成
参数说明:
name必选项,<suite>的名字,将出现在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和continueconfigf,使用示例:ailurepolicy="skip",默认skip
thread-count与parallel配套使用,线程池的大小,决定并行线程数量,使用示例:thread-count="10",默认5
annotations获取注解,值为javadoc时,使用JavaDoc的注释;否则用JDK5注释;
time-out设置parallel时,终止执行单元之前的等待时间(毫秒)取值整数,单位毫秒
skipfailedinvocationcounts配置是否跳过失败的调用,可取值true和false,默认false
data-provider-thread-count设置并发时data-provider的线程池数量data-provider-thread-count="5"整数
object-factory一个实现IObjectFactory接口的类,实例化测试对象object-factory=具体类名
allow-return-values配置是否允许返回函数值,可取值true和false
preserve-order配置是否按照排序执行,可取值true和false,默认true
group-by-instances配置是否按照实例分组,可取值true和false,默认false
parallel该参数的值默认false,必须和thread-count配套使用,否则相当于无效参数,thread-count决定了并行测试时开启的线程数量
parallel="mehods" TestNG将并行执行所有的测试方法在不同的线程里
parallel="tests" TestNG将并行执行在同一个<test>下的所有方法在不同线程里
parallel="classes" TestNG将并行执行在相同<class>下的方法在不同线程里
parallel="instances" TestNG将并行执行相同实例下的所有方法在不同的线程里
<test>标签
说明:一个下可以有多个,可以通过的parallel="tests"来进行并行测试(必须和thread-count配套使用,否则是无效参数)
<test>由<parameters>、<groups>、<classes>三部分组成
参数说明:
name设置test的名字,将出现在报告里
junit配置是否按照Junit模式运行,可取值true和false,默认false
verbose配置控制台输出的详细内容等级,可取值0-10级(0无,10最详细),不在报告显示
parallel配置是否在不同的线程并行进行测试,要与thread-count配套使用parallel="mehods"与suite的parallel一致,默认false
thread-count与parallel配套使用,线程池的大小,决定并行线程数量,可取值整数,默认5
annotations获取注解,值为javadoc时,使用JavaDoc的注释;否则用JDK5注释
time-out设置parallel时,终止执行单元之前的等待时间(毫秒),可取值整数,单位毫秒
enabled标记是否执行这个test,可取值true和false,默认true
skipfailedinvocationcounts配置是否跳过失败的调用,可取值true和false,默认false
preserve-order配置是否按照排序执行,如果是true,将按照xml文件中的顺序去执行,可取值true和false,默认true
allow-return-values是否允许返回函数值,可取值true和false,默认false
<groups>标签
说明:要运行的组,可以自定义一个组(包括要执行的,还排除要执行的方法)。必须和<classes>配套使用,从下面的类中找到对应名字的方法
<groups>由<difine>和<run>、<dependencies>三部分组成。
<diffine>可以将group组成一个新组,包括要执行和不执行的大组;
<run>要执行的方法;
<dependencies>指定了某group需要依赖的group
比如下面的例子,group1需要依赖group2和group3先执行:
<groups>
<define name ="all">
<include name ="testgroup1"/>
<exclude name ="testgroup2'/>
</define>
<run>
<include name ="all"/>
<include name ="testmethod1"/>
<exclude name="testmethod2"/>
</run>
<dependencies>
<group name ="group1" depends-on="goup2 group3"/>
</dependencies>
</groups>
<classes>标签
说明:方法选择器,要执行的方法写在这里,参数有name和priority。
<classes>下必须写要执行的,否则不会执行任何内容,如果填写了class没有写methods,会按照填写的class的下的注释@Test去执行所有的方法
<classes>下的<methods>如果填写了,那只会执行所填写的方法,没有填写的方法不会去执行
具体示例:
<classes>
<class name="要执行的class名">
<methods>
<include name ="要执行的方法名"></include>
</methods>
</class>
</classes>
<packages>标签
说明:指定包名代替类名。查找包下所有包含testNG annotation的类进行测试,示例如下:
<packages>
<package name="packagename"/>
<package name="packagename">
<include name="methodname"/>
<exclude name="methodname"/>
</package>
</packages>
<listener>标签
说明:指定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>