testng的xml文件說明(TestNG DTD)


testNG啟發自JUnit和NUnit的一種測試框架,通過使用testNG使的測試更簡單。,比如如下的一些特點:
1.通過注釋來管理測試
2.多線程並發執行測試,且是安全的
3.支持數據驅動測試
4.支持在多樣化的平台上使用(Eclipse、IDEA、Maven等)
5.嵌入了BeanShell,使的更具靈活性
6.支持依賴
 
一、testNG的xml文件的結構
簡單的大概結構如下:
<suite>
 --<test>
 -- --<parameter>
 -- --<test>
 -- -- -- <parameter>
 -- -- -- <groups>
 -- -- -- <classes>
 
比較詳細的結構如下:
<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>
 
二、文檔具體的元素說明
<suite>
說明:一個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框架提供了支持,我沒用過這個框架,所以這兩個參數沒看懂╮(╯▽╰)╭
 
-<suite-file>
說明:引入外部的xml文件(地址由path參數決定,path必填項),將引入的xml與當前的xml文件一起使用
聲明方法:
<suite-files>
     <suite-file path="/path/suitefile1"></suite-file>
</suite-files>
 
-<test>
說明:一個<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
 
--<parameter>
說明:提供測試數據,有name和value兩個參數
聲明方法:<parameter name = "parameter_name" value = "parameter_value "/>
testng.xml文件中的<parameter>可以聲明在<suite>或者<test>級別,在<test>下的<parameter>會覆蓋在<suite>下聲明的同名變量
 
--<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>這個我沒用過,所以了解,如果有錯的歡迎指出來~
 
--<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。
注釋:
1.<classes>下必須寫要執行的<class>,否則不會執行任何內容,如果填寫了class沒有寫methods,會按照填寫的class的下的注釋@Test去執行所有的方法
2.<classes>下的<methods>如果填寫了<include>,那只會執行所填寫的方法,沒有填寫的方法不會去執行
 
聲明方法:
<classes>
     <class name="要執行的class名">
          <methods>
               <include name ="要執行的方法名"></include>
          </methods>
     </class> 
</classes>
 
--<packages>
說明:<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>
 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM