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>
TestNG DTD:http://testng.org/testng-1.0.dtd.php