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 |
該參數的值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>
此標簽無特別意義，其下可以包括多個標簽，如groups、classes等
說明：一個<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文件詳解篇 ，就分享到這里。