TestNG.XML初级指南

这是一篇DTD文档的概述


简单说明:

测试代码中在需要测试的方法前加上注释符,例如:

package com.yiban.test;
public class test2 {
  @Parameters({ "first-name" }) //参数   @Test(groups={"g1","g2"}) //组名   public void test001() throws Exception {     System.out.println("test001");   }
}

 XML文件写法

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

 

 

以下详细XML规则

-结-构-树

suite
--tests
----parameters
----groups
------definitions
------runs
----classes
--parameters

 

**suite元素
suite 是testng.xml文档中最上层的元素

< suite (groups?,(listeners|packages|test|parameter|method-selectors|suite-files)*) >

属性: 参数列表(“”中是默认值,CDATA代表字符串)

name suite的名字(他会出现在测试报告中)
junit 是否以junit模式运行
verbose 在控制台中如何输出,这个设置不影响html版本的测试报告
parallel 是否使用多线程测试(可能加速测试)
configfailurepolicy 是否在运行失败了一次后继续尝试或跳过
 thread-count  如果设置了parallel,可以设置线程数
 annotations  有‘javadoc’的时候寻找,没有的话使用jdk5的注释
 time-out   在终止method (如果parallel="methods") 或者test (如果parallel="tests")之前设置以毫秒为单位的等待时间
 skipfailedinvocationcounts  是否跳过失败的调用
data-provider-thread-count 提供一个整数线程池的范围为了使用parallel data
object-factory 一个继承IObjectFactory的类,被用来实例化测试对象
allow-return-values 如果设置true,将会运行测试用例并返回值



< suite
name CDATA #必填项
junit (true | false) "false"
verbose CDATA #隐含
parallel (false | methods | tests | classes | instances) "false"
configfailurepolicy (skip | continue) "skip"
thread-count CDATA "5"
annotations CDATA #隐含
time-out CDATA #隐含
skipfailedinvocationcounts (true | false) "false"
data-provider-thread-count CDATA "10"
object-factory CDATA #隐含
group-by-instances (true | false) "false"
preserve-order (true | false) "true"
allow-return-values (true | false) "false"
>

 

**suite-files元素

一个XML文档的列表包含更多的suite描述

< suite-files (suite-file)* >
< suite-file ANY >

参数列表

< suite-file
path CDATA #必填项
>

 

**Parameters元素

Parameters 可以在suite或者test级别被定义.
Parameters 定义在test级别时将覆盖sutie级别的同名参数
Parameters 被用来联系java方法参数的实际值,并在这里定义.

< parameter ANY>

参数列表

< parameter
name CDATA #必填项
value CDATA #必填项 >

 

**method-selectors元素

方法选择器定义了那些方法要运行,他们必须继承org.testng.IMethodSelector

< method-selectors (method-selector*) >
< method-selector ((selector-class)*|script) >
< selector-class ANY>

参数列表:

< selector-class
name CDATA #必填项
priority CDATA #隐含
>

 

**script元素

< script ANY>

参数列表:

< script
language CDATA #必填项
>

 

**test元素

一个test包含参数和classes,另外,你可以定义组(组中组)

< test (method-selectors?,parameter*,groups?,packages?,classes?) >

属性:

name test的名字(他会出现在测试报告中)
junit 是否以junit模式运行
verbose 在控制台中如何输出,这个设置不影响html版本的测试报告,默认值: suite 级别的verbose
parallel 是否使用多线程测试(可能加速测试)
thread-count  如果设置了parallel,可以设置线程数
annotations  有‘javadoc’的时候寻找,没有的话使用jdk5的注释
time-out  在终止method (如果parallel="methods") 或者test (如果parallel="tests")之前设置以毫秒为单位的等待时间
enabled  设置是否运行当前test,默认值:true
skipfailedinvocationcounts  是否跳过错误的调用
prserve-order  如果设置true,classes会按照XML文档中的顺序执行
allow-return-values  如果设置true,将会运行测试用例并返回值

  

属性列表:

< test
name CDATA #必填项
junit (true | false) "false"
verbose CDATA #隐含
parallel CDATA #隐含
thread-count CDATA #隐含
annotations CDATA #隐含
time-out CDATA #隐含
enabled CDATA #隐含
skipfailedinvocationcounts (true | false) "false"
preserve-order (true | false) "true"
group-by-instances (true | false) "false"
allow-return-values (true | false) "false"
>

 

**groups元素

定义包含在测试中要运行的组(组中组)

< groups (define*,run?,dependencies?) >

 

 

**define元素

< define (include*)>

 属性列表

< define
name CDATA #必填项
>

 

**include元素

定义组中组

<include ANY>

 属性列表

< include
name CDATA #必填项
description CDATA #隐含
invocation-numbers CDATA #隐含>

 

**exclude元素

定义排除的组

< exclude ANY>

 属性列表

< exclude
name CDATA #必填项
>

 

**run元素
定义那些group需要被运行

< run (include?,exclude?)* >

 

**dependencies元素

< dependencies (group*)>

 

**group元素

< group ANY>

 属性列表

< group
name CDATA #必填项
depends-on CDATA #必填项
>

 

**classes元素
包含在此次test中的classes列表

< classes (class*) >

 

**class元素

< class (methods*) >

 属性列表:

< class
name CDATA #必填项 >

 

**packages元素
包含在此次test中的packages列表

< packages (package*) >

 

**package元素
如果package名字结尾包含.* ,则所有的子包也被包括其中

< package (include?,exclude?)*>

 属性列表:

< package
name CDATA #必填项 
>

 

**methods元素
包含或排除在此次test中的methods列表

< methods (include?,exclude?,parameter?)* >

 

**listeners元素
将被传给TestNG的监听列表

< listeners (listener*) >

 

**listener元素

< listener ANY>

 属性列表

<listener
class-name CDATA #必填项
>

 

posted on 2013-05-15 16:00  choose.wang  阅读(14771)  评论(2编辑  收藏  举报

导航