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简单的大概结构如下:

<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<suite>

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

说明:一个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和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将并行执行在同一个<test>下的所有方法在不同线程里

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

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

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

3.2<suite-file>

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

声明方法:

<suite-files>
<suite-file path="/path/suitefile1"></suite-file>
</suite-files>

3.3<test>

此标签无特别意义,其下可以包括多个标签,如groupsclasses

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

<test>由<parameters>、<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<parameter>

说明:提供测试数据,有name和value两个参数

声明方法:<parameter name = "parameter_name" value = "parameter_value "/>

testng.xml文件中的<parameter>可以声明在<suite>或者<test>级别,在<test>下的<parameter>会覆盖在<suite>下声明的同名变量

3.5<method-selectors>

说明:方法选择器定义了哪些类的方法需要去执行,类必须继承自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>

备注:<method-selectors>这个我没用过,所以了解,如果有错的欢迎指出来~

3.6<groups>

此标签必然是在<test>标签下的,用于标识那些组会被用于测试或者被排除在测试之外,其同级必然要包含一个<classes>标签或者<pakages>标签,用于指定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>

3.7<classes>

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

注释:

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

2.<classes>下的<methods>如果填写了<include>,那只会执行所填写的方法,没有填写的方法不会去执行

声明方法:

<classes>
<class name="要执行的class名">
<methods>
<include name ="要执行的方法名"></include>
</methods>
</class>
</classes>

3.8<packages>

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

声明方法:

<packages>
<package name="packagename"/>
<package name="packagename">
<include name="methodname"/>
<exclude name="methodname"/>
</package>
</packages>

3.9<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>

4.小结

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

上一篇:java集合框架collection(2)ArrayList和LinkedList


下一篇:设计模式,Let's “Go”! (上)