TestNG XML 标签说明

做自己的女王ヽ

最近在思考自动化测试活动架构，所以参照着dtd和网上别人的经验，整理了一份完整版的testng xml，给有需要的童鞋吧。至于里面标注todo的部分，这是我在网上没找到令我满意
的说明，准备以后有时间试验过再确定的内容。以上。

1. <?xml version="1.0" encoding="UTF-8"?>
   
2. <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
   
3. <!--suite（测试套件）为根路径，仅允许出现1次，是多个test（测试用例）的集合，以下为各属性含义及取值
   
4.     @name 必填，标记suite的名称
   
5.     @junit 选填，是否以junit模式运行，可选值（true|false） 默认值"false"
   
6.     @verbose 选填，命令行信息打印等级（与测报内容无关），可在测试代码注释中配置，可选值（1|2|3|4|5）
   
7.     @parallel 选填，是否多线程并发运行测试，可选值(false | methods | tests | classes | instances)，默认 "false"
   
8.     @thread-count 选填，填写值为正整数，当为并发执行时的线程池数量，默认为"5"
   
9.     @configfailurepolicy 一旦Before/After Class/Methods这些方法失败后，是继续执行测试还是跳过测试；可选值 (skip | continue)，默认"skip
   
10.     @annotations="javadoc" 获取注解的位置，如果为"javadoc", 则使用javadoc注解，否则使用jdk注解
    
11.     @time-out 为具体执行单元设定一个超时时间，具体参照parallel的执行单元设置；单位为毫秒
    
12.     @skipfailedinvocationcounts 是否跳过失败的调用，可选值(true | false)，默认"false"
    
13.     @data-provider-thread-count 并发执行时data-provider的线程池数量，默认为"10"
    
14.     @object-factory 一个实现IObjectFactory接口的类，用来实例测试对象
    
15.     @allow-return-values="true" 是否允许返回函数值，可选值(true | false)，默认"false"
    
16.     @preserve-order：顺序执行开关，可选值(true | false) "true"
    
17.     @group-by-instances：是否按实例分组，可选值(true | false) "false"
    
18.     @guice-stage 支持使用JSR-330的@Inject注解来配置运行时提供的实例
    
19.     @parent-module 和Guice框架有关，只运行一次，创建一个parent injector给所有guice injectors
    
20.     -->
    
21. <suite name="suitename" junit="false" verbose="3" parallel="false" thread-count="5" configfailurepolicy="skip"
    
22.        annotations="javadoc" time-out="10000" skipfailedinvocationcounts="true" data-provider-thread-count="5"
    
23.        object-factory="classname" allow-return-values="true" preserve-order="true" group-by-instances="false">
    
24. 
    
25.     <!--可以执行多个suite，@path 必填，欲引用的suitefile的绝对路径-->
    
26.     <suite-files>
    
27.         <suite-file path="/path/to/suitefile1"></suite-file>
    
28.     </suite-files>
    
29.     <!--全局参数，@name和@value必填，分别为参数名和参数值-->
    
30.     <parameter name="par1" value="value1"></parameter>
    
31.     <parameter name="par2" value="value2"></parameter>
    
32. 
    
33.     <!--方法选择器，在suite/test中增加需要额外执行的类（根据父标签而定），及安排执行优先级-->
    
34.     <method-selectors>
    
35.         <method-selector>
    
36.             <!--
    
37.                 @name 必填
    
38.                 @priority 选填
    
39.                 -->
    
40.             <selector-class name="classname" priority="1"></selector-class>
    
41.             <!--
    
42.                 @language 必填
    
43.                 -->
    
44.             <script language="java"></script>
    
45.         </method-selector>
    
46.     </method-selectors>
    
47. 
    
48.     <!--test定义一次测试执行，以下为各属性含义及取值
    
49.         @name：必填，test的名字，测试报告中会有体现
    
50.         @junit：选填，是否以Junit模式运行，可选值(true | false)，默认"false"
    
51.         @verbose：选填，命令行信息打印等级，不会影响测试报告输出内容；可选值(1|2|3|4|5)
    
52.         @parallel：选填，是否多线程并发运行测试；可选值(false | methods | tests | classes | instances)，默认 "false"
    
53.         @thread-count：选填，当为并发执行时的线程池数量，默认为"5"
    
54.         @annotations：选填，获取注解的位置，如果为"javadoc", 则使用javadoc注解，否则使用jdk5注解
    
55.         @time-out：选填，为具体执行单元设定一个超时时间，具体参照parallel的执行单元设置；单位为毫秒
    
56.         @enabled：选填，设置当前test是否生效，可选值(true | false)，默认"true"
    
57.         @skipfailedinvocationcounts：选填，是否跳过失败的调用，可选值(true | false)，默认"false"
    
58.         @preserve-order：选填，顺序执行开关，可选值(true | false) "true"
    
59.         @group-by-instances：选填，是否按实例分组，可选值(true | false) "false"
    
60.         @allow-return-values：选填，是否允许返回函数值，可选值(true | false)，默认"false"
    
61.         -->
    
62.     <test name="testename" junit="false" verbose="3" parallel="false" thread-count="5" annotations="javadoc"
    
63.           time-out="10000" enabled="true" skipfailedinvocationcounts="true" preserve-order="true"
    
64.           allow-return-values="true">
    
65.         <!--局部参数，@name和@value必填，分别为参数名和参数值，如果参数名与全局参数一致，则覆盖全局参数取值-->
    
66.         <parameter name="par1" value="value1"></parameter>
    
67.         <parameter name="par2" value="value2"></parameter>
    
68.         <!--搭配class使用，执行class内指定组-->
    
69.         <groups>
    
70.             <!--定义执行组名，在run中使用
    
71.                 @name 必填，组中组的名称
    
72.             -->
    
73.             <define name="xxx">
    
74.                 <!--定义包含的测试组，测试方法属于哪个测试组在测试代码注释中定义。
    
75.                     @name 必填，需要包含进组中组的组名
    
76.                     @description 选填，关于组的描述
    
77.                     @invocation-numbers 选填，执行次序或者执行次数——TODO
    
78.                     -->
    
79.                 <include name="" description="" invocation-numbers=""/>
    
80.                 <include name="" description="" invocation-numbers=""/>
    
81.             </define>
    
82.             <!--运行组中组的配置-->
    
83.             <run>
    
84.                 <!--执行指定的组中组，@name必填，与define name一致-->
    
85.                 <include name=""/>
    
86.                 <!--排除指定的组中组，@name必填，与define name一致-->
    
87.                 <exclude name=""/>
    
88.             </run>
    
89.             <!--组中组的依赖配置-->
    
90.             <dependencies>
    
91.                 <!--配置依赖
    
92.                     @name 必填，需要依赖其他组的组名，define中设置
    
93.                     @depends-on 必填，被依赖的组名，define中设置，可以有多个，用空格隔开
    
94.                     -->
    
95.                 <group name="" depends-on=""></group>
    
96.                 <group name="" depends-on=""></group>
    
97.             </dependencies>
    
98.         </groups>
    
99.         <!--配置要执行的类，是多个class的集合-->
    
100.         <classes>
     
101.             <!--局部参数，@name和@value必填，分别为参数名和参数值，如果参数名与全局参数和父标签的局部参数一致，则覆盖全局参数和父标签的局部参数取值-->
     
102.             <parameter name="par1" value="value1"></parameter>
     
103.             <parameter name="par2" value="value2"></parameter>
     
104.             <!--多个methods的集合，@name 必填，对应class的名称，如com.example.autotest.testcase-->
     
105.             <class name="classname">
     
106.                 <!--要执行的方法，如为空，则执行整个class内包含的全部方法-->
     
107.                 <methods>
     
108.                     <!--局部参数，@name和@value必填，分别为参数名和参数值，如果参数名与全局参数和父标签的局部参数一致，则覆盖全局参数和父标签的局部参数取值-->
     
109.                     <parameter name="par3" value="value3"></parameter>
     
110.                     <!--类内要执行的测试方法名，在测试代码注释中配置，如设置inclde，则只执行该方法，其他跳过
     
111.                         @name 必填，执行方法名
     
112.                         @description 选填，方法描述
     
113.                         @invocation-number 选填，宣发执行顺序或执行次数——TODO
     
114.                         -->
     
115.                     <include name="" description="" invocation-numbers=""></include>
     
116.                     <!--除了该方法外，类内其他方法都执行，@name 必填，不执行的方法名-->
     
117.                     <exclude name=""></exclude>
     
118.                 </methods>
     
119.                 <methods></methods>
     
120.             </class>
     
121.         </classes>
     
122.         <!--可以执行指定包下面所有类，是多个package的汇聚-->
     
123.         <packages>
     
124.             <!--配置要执行的包，@name 必填，要执行的package名，如com.example.autotest-->
     
125.             <package name="">
     
126.                 <!--包内要执行的测试方法名，在测试代码注释中配置，如设置inclde，则只执行该方法，其他跳过
     
127.                     @name 必填，执行方法名
     
128.                     @description 选填，方法描述
     
129.                     @invocation-number 选填，宣发执行顺序或执行次数——TODO
     
130.                     -->
     
131.                 <include name="" description="" invocation-numbers=""></include>
     
132.                 <!--除了该方法外，包内其他方法都执行，name 必填，不执行的方法名-->
     
133.                 <exclude name=""></exclude>
     
134.             </package>
     
135.         </packages>
     
136.     </test>
     
137.     <!--设置监听的类名，可设置多个，class-name 必填，类名，如com.example.autotest.Listener-->
     
138.     <listeners>
     
139.         <listener class-name="classname1"/>
     
140.         <listener class-name="classname2"/>
     
141.     </listeners>
     
142. </suite>
     

复制代码

海海豚

谢谢分享~

梦想家