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>

此標籤無特別意義，其下能夠包括多個標籤，如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文件詳解篇 ，就分享到這裏。