TestNG官方文檔中文版.doc

精品文檔TestNG官方文檔中文版(1)-介紹 最近決定開始使用TestNG來替代junit，作為未來的單元測(cè)試基礎(chǔ)組件。 google了一下沒有找到好的詳細(xì)的文檔，最后發(fā)現(xiàn)官網(wǎng)上的文檔其實(shí)挺全的，決定翻譯一下。 TestNG的官方文檔請(qǐng)見： /doc/documentation-main.html1. 介紹 TestNG是一個(gè)設(shè)計(jì)用來簡(jiǎn)化廣泛的測(cè)試需求的測(cè)試框架，從單元測(cè)試（隔離測(cè)試一個(gè)類）到集成測(cè)試（測(cè)試由有多個(gè)類多個(gè)包甚至多個(gè)外部框架組成的整個(gè)系統(tǒng)，例如運(yùn)用服務(wù)器）。 編寫一個(gè)測(cè)試的過程有三個(gè)典型步驟： * 編寫測(cè)試的 業(yè)務(wù)邏輯并在代碼中插入TestNG annotation * 將測(cè)試信息添加到testng.xml文件或者build.xml中 * 運(yùn)行TestNG在歡迎頁面上可以找到快速入門示例。下面是這篇文檔使用的概念： * suite由xml文件描述。它包含一個(gè)或多個(gè)測(cè)試并被定義為標(biāo)簽 * test由描述并包含一個(gè)或者多個(gè)TestNG類 * TestNG類是包含至少一個(gè)TestNG annotation的java類，由標(biāo)簽描述并包含一個(gè)或多個(gè)測(cè)試方法 * 測(cè)試方法是源文件中帶有Testd注釋的java方法 TestNG測(cè)試可以被BeforeXXX 和 AfterXXX annotations配置，容許在特定點(diǎn)的前后執(zhí)行一些java邏輯，這些點(diǎn)上面已經(jīng)列出。這份手冊(cè)的剩余部分將講述以下內(nèi)容： * 所有的annotation列表并帶有簡(jiǎn)短說明，為TestNG的多種功能性提供參考, 你可能需要參考為每個(gè)annotation提供的代碼片段來學(xué)習(xí)細(xì)節(jié)。 * testng.xml文件描述，它的語法和如果指定它。 * 多個(gè)特性的詳細(xì)列表和怎樣結(jié)合annotation和testng.xml來使用它們*注：上面的內(nèi)容很簡(jiǎn)短，但是請(qǐng)注意其中的一些細(xì)節(jié)。1. TestNG是一個(gè)設(shè)計(jì)用來簡(jiǎn)化廣泛的測(cè)試需求的測(cè)試框架，從單元測(cè)試到集成測(cè)試 這個(gè)是TestNG設(shè)計(jì)的出發(fā)點(diǎn)，不僅僅是單元測(cè)試，而且可以用于集成測(cè)試。設(shè)計(jì)目標(biāo)的不同，對(duì)比junit的只適合用于單元測(cè)試，TestNG無疑走的更遠(yuǎn)。 可以用于集成測(cè)試，這個(gè)特性是我選擇TestNG的最重要的原因。2. 測(cè)試的過程的三個(gè)典型步驟，注意和junit(4.0)相比，多了一個(gè)將測(cè)試信息添加到testng.xml文件或者build.xml 測(cè)試信息尤其是測(cè)試數(shù)據(jù)不再寫死在測(cè)試代碼中，好處就是修改測(cè)試數(shù)據(jù)時(shí)不需要修改代碼/編譯了，從而有助于將測(cè)試人員引入單元測(cè)試/集成測(cè)試。3. 基本概念，相比junit的TestCase/TestSuite，TestNG有suite/test/test method三個(gè)級(jí)別，即將test/test method明確區(qū)分開了。 junit中的TestCase將test/test method混合，比較容易讓人概念不清晰，尤其是新手。TestNG官方文檔中文版(2)-annotation TestNG的官方文檔的中文翻譯版第二章，原文請(qǐng)見 /doc/documentation-main.html2 - Annotation這里是TestNG中用到的annotation的快速預(yù)覽，還有它們的屬性。BeforeSuite: 被注釋的方法將在所有測(cè)試運(yùn)行前運(yùn)行AfterSuite: 被注釋的方法將在所有測(cè)試運(yùn)行后運(yùn)行BeforeTest: 被注釋的方法將在測(cè)試運(yùn)行前運(yùn)行AfterTest: 被注釋的方法將在測(cè)試運(yùn)行后運(yùn)行BeforeGroups: 被配置的方法將在列表中的gourp前運(yùn)行。這個(gè)方法保證在第一個(gè)屬于這些組的測(cè)試方法調(diào)用前立即執(zhí)行。AfterGroups: 被配置的方法將在列表中的gourp后運(yùn)行。這個(gè)方法保證在最后一個(gè)屬于這些組的測(cè)試方法調(diào)用后立即執(zhí)行。BeforeClass: 被注釋的方法將在當(dāng)前類的第一個(gè)測(cè)試方法調(diào)用前運(yùn)行。AfterClass: 被注釋的方法將在當(dāng)前類的所有測(cè)試方法調(diào)用后運(yùn)行。BeforeMethod: 被注釋的方法將在每一個(gè)測(cè)試方法調(diào)用前運(yùn)行。AfterMethod: 被注釋的方法將在每一個(gè)測(cè)試方法調(diào)用后運(yùn)行。屬性： alwaysRun 對(duì)于每個(gè)bufore方法(beforeSuite, beforeTest, beforeTestClass 和 beforeTestMethod, 但是不包括 beforeGroups): 如果設(shè)置為true，被配置的方法將總是運(yùn)行而不管它屬于哪個(gè)組。 對(duì)于after方法(afterSuite, afterClass, .): 如果設(shè)置為true，被配置的方法甚至在一個(gè)或多個(gè)先調(diào)用的方法失敗或被忽略時(shí)也將運(yùn)行。 dependsOnGroups 這個(gè)方法依賴的組列表 dependsOnMethods 這個(gè)方法依賴的方法列表 enabled 這個(gè)類的方法是否激活 groups 這個(gè)類或方法所屬的分組列表 inheritGroups 如果設(shè)置為true，這個(gè)方法被屬于在類級(jí)別被Test annotation指定的組DataProvider 標(biāo)記一個(gè)方法用于為測(cè)試方法提供數(shù)據(jù)。 被注釋的方法必須返回Object, 其中每個(gè)Object可以指派為這個(gè)測(cè)試方法的參數(shù)列表。 從這個(gè)DataProvider接收數(shù)據(jù)Test方法需要使用一個(gè)和當(dāng)前注釋相同名稱的dataProvider名稱 name 這個(gè)DataProvider的名稱Factory 標(biāo)記方法作為一個(gè)返回對(duì)象的工廠，這些對(duì)象將被TestNG用于作為測(cè)試類。這個(gè)方法必須返回ObjectParameters 描述如何傳遞參數(shù)給Test方法 value 用于填充這個(gè)方法的參數(shù)的變量列表Test 標(biāo)記一個(gè)類或方法作為測(cè)試的一部分 alwaysRun 如果設(shè)置為true，這個(gè)測(cè)試方法將總是運(yùn)行，甚至當(dāng)它依賴的方法失敗時(shí)。 dataProvider 這個(gè)測(cè)試方法的data provider的名稱 dataProviderClass 用于查找data provider的類。 如果不指定，將在當(dāng)前測(cè)試方法所在的類或者它的基類上查找data provider。 如果這個(gè)屬性被指定, 則data provider方法需要是指定類的static方法。 dependsOnGroups 當(dāng)前方法依賴的組列表 dependsOnMethods 當(dāng)前方法依賴的方法列表 description 當(dāng)前方法的描述 enabled 當(dāng)前類的方法/方法是否被激活 expectedExceptions 測(cè)試方法期望拋出的異常列表。如果沒有異?；蛘邟伋龅牟皇橇斜碇械娜魏我粋€(gè)，當(dāng)前方法都將標(biāo)記為失敗. groups 當(dāng)前類/方法所屬的組列表 invocationCount 當(dāng)前方法被調(diào)用的次數(shù) successPercentage 當(dāng)前方法期望的成功率 sequential 如果設(shè)置為true，當(dāng)前測(cè)試類上的所有方法保證按照順序運(yùn)行。甚至測(cè)試們?cè)趐arallel=true的情況下. 這個(gè)屬性只能用于類級(jí)別，如果用于方法級(jí)別將被忽略。 timeOut 當(dāng)前方法容許花費(fèi)的最大時(shí)間，單位毫秒。 threadPoolSize 當(dāng)前方法的線程池大小。方法將被多線程調(diào)用，次數(shù)由invocationCount參數(shù)指定 注意：如果invocationCount沒有指定則這個(gè)屬性將被忽略注： 上面是TestNG中用到的annotation列表，從中我們可以看到TestNG提供的一些特性1. before方法和after方法 帶來了足夠豐富的測(cè)試生命周期控制2. dependsOnGroups/dependsOnMethods 提供了依賴檢查機(jī)制，并可以嚴(yán)格控制執(zhí)行順序3. DataProvider 使得對(duì)同一個(gè)方法的測(cè)試覆蓋變的非常輕松，非常適合進(jìn)行邊界測(cè)試，只要給出多種測(cè)試數(shù)據(jù)就可以針對(duì)一個(gè)測(cè)試方法進(jìn)行覆蓋4. expectedExceptions 使得異常測(cè)試變的非常輕松5. invocationCount/threadPoolSize 終于可以簡(jiǎn)單的直接進(jìn)行多線程測(cè)試了，這個(gè)絕對(duì)是junit的超級(jí)弱項(xiàng)，回想junit中那個(gè)萬惡的System.exist(0).6. timeOut 終于不用死等然后手工強(qiáng)行關(guān)閉測(cè)試，TestNG想的太周到了TestNG官方文檔中文版(3)-testng.xml TestNG的官方文檔的中文翻譯版第3章，原文請(qǐng)見 /doc/documentation-main.html 3 - testng.xml 調(diào)用TestNG由幾種不同方法： * 使用testng.xml文件 * 使用ant * 從命令行 這節(jié)描述testng.xml的格式（文檔的后面會(huì)講到ant和命令行）。 當(dāng)前testng.xml的DTD文件可以從官方找到：/testng-1.0.dtd。（為了方便使用，你可能更喜歡瀏覽HTML版本）。 下面是testng.xml文件的一個(gè)例子： 你可以指定包名替代類名： 在這個(gè)例子中，TestNG將在包test.sample中查找所有的類，并只保留帶有TestNG annotation的類。 你同樣可以指定包含或不包含的組和方法: 你同樣可以在testng.xml中定義新的組，指定屬性的額外詳細(xì)情況，比如是否并行運(yùn)行測(cè)試，使用多少線程，是否運(yùn)行junit測(cè)試，等等. 請(qǐng)查看DTD文件了解完整的特性列表。TestNG官方文檔中文版(4)-運(yùn)行TestNG 4 - 運(yùn)行TestNGTestNG可以以不同的方式調(diào)用： * Command line * ant * Eclipse * IntelliJs IDEA1) 命令行假設(shè)你已經(jīng)將TestNG加入到class path，調(diào)用TestNG最簡(jiǎn)單的方法事下面的：java org.testng.TestNG testng1.xml testng2.xml testng3.xml .必須指定最少一個(gè)描述你試圖測(cè)試的TestNG suite的xml文件。另外，下面的命令行參數(shù)可以使用：命令行參數(shù)列表選項(xiàng) 參數(shù) 文檔說明-d 一個(gè)目錄 生成報(bào)告的目錄（ test-output）-sourcedir 分號(hào)隔開的目錄列表 帶有javadoc注釋的測(cè)試源文件目錄. 這個(gè)選項(xiàng)只在使用javadoc類型的annotation時(shí)才有效. (例如 src/test or src/test/org/testng/eclipse-plugin;src/test/org/testng/testng).-testclass 可以在classpath路徑中找到的逗號(hào)分隔的類列表。逗號(hào)分隔的類文件列表(例如 org.foo.Test1,org.foo.test2).-groups 逗號(hào)分隔的組列表 要運(yùn)行的組列表(例如 windows,linux,regression).-excludegroups 逗號(hào)分隔的組列表 不想包含在這次運(yùn)行中的組列表-testrunfactory 可以在classpath中找到的java類 指定測(cè)試的runner.這個(gè)類需要實(shí)現(xiàn)接口org.testng.ITestRunnerFactory .-listener 可以在classpath路徑中找到的逗號(hào)分隔的類列表。 指定測(cè)試的listener. 這個(gè)類需要實(shí)現(xiàn)接口org.testng.ITestListener-parallel methods|tests 如果指定, 設(shè)置運(yùn)行測(cè)試時(shí)如何使用并發(fā)線程的默認(rèn)機(jī)制.如果不設(shè)置，默認(rèn)機(jī)制是完全不使用并發(fā)線程。這個(gè)設(shè)置可以被suite定義覆蓋.-threadcount 并發(fā)測(cè)試運(yùn)行時(shí)默認(rèn)使用的線程數(shù) 用于設(shè)置并發(fā)測(cè)試時(shí)默認(rèn)的線程數(shù). 只在并發(fā)模式被選擇時(shí)才生效 (例如, 打開 -parallel 選項(xiàng)). 這個(gè)設(shè)置可以被suite定義覆蓋.-suitename 測(cè)試套件使用的默認(rèn)名稱. 指定在命令行上定義的測(cè)試套件的名稱。如果suite.xml文件或源代碼指定了另外一個(gè)不同的套件名稱，這個(gè)選項(xiàng)將被忽略?？梢詣?chuàng)建帶空格的套件名稱，如果在名稱前后加雙引號(hào)如like this.-testname 測(cè)試使用的默認(rèn)名稱. 指定在命令行上定義的測(cè)試的名稱。如果suite.xml文件或源代碼指定了另外一個(gè)不同的測(cè)試名稱，這個(gè)選項(xiàng)將被忽略?？梢詣?chuàng)建帶空格的測(cè)試名稱，如果在名稱前后加雙引號(hào)如like this.-reporter 擴(kuò)展配置用于自定義報(bào)告listenner. 類似 -listener 選項(xiàng), 除了容許reporter示例上由javabean形式的配置. 例如: -reporter com.test.MyReporter:methodFilter=*insert*,enableFiltering=true可以通過不帶任何參數(shù)直接調(diào)用TestNFG來獲得這個(gè)文檔。可以將命令行開關(guān)寫到txt文件中，例如c:command.txt, 然后告訴TestNG使用這個(gè)文件類找到參數(shù): C: more c:command.txt -d test-output testng.xml C: java org.testng.TestNG c:command.txt另外，可以通過jvm的命令行來傳遞參數(shù)給TestNG，例如java -Dtestng.test.classpath=c:/build;c:/java/classes; org.testng.TestNG testng.xmlTestNG能夠理解的參數(shù)屬性 類型 文檔testng.test.classpath 分號(hào)分隔的包含測(cè)試類的一系列目錄 如果這個(gè)屬性被設(shè)置，TestNG將使用它替代從class path來查找測(cè)試類. 如果你正在使用在xml文件里面的包標(biāo)簽并且在classpath路徑中由很多類而大部分都不是測(cè)試類的時(shí)候比較方便舉例:java org.testng.TestNG -groups windows,linux -testclass org.test.MyTest注意 ant 任務(wù)和testng.xml容許用更多的參數(shù)來啟動(dòng)TestNG（包含的方法，指定的參數(shù)，等等），因此可以認(rèn)為命令行適用于學(xué)習(xí)TestNG并且想快速入門。2) Ant 可以這樣定義TestNG的ant任務(wù)：這個(gè)任務(wù)運(yùn)行TestNG測(cè)試，并且通常是在單獨(dú)的jvm中。接受下面的屬性：屬性名 描述 是否必須annotations 字符串JDK或者Javadoc. 定義測(cè)試適用的注釋類型.如果使用Javadoc, 則需要同時(shí)指定sourcedir. 不是必須. 如果適用jkd5則默認(rèn)為JDK，如果適用jdk1.4則默認(rèn)為Javadocclassfilesetref 要運(yùn)行的測(cè)試類的FileSet結(jié)構(gòu)的引用. classpath 要運(yùn)行的測(cè)試的PATH-like 結(jié)構(gòu). classpathref 要運(yùn)行的測(cè)試的PATH-like 結(jié)構(gòu)的引用. dumpCommand 打印TestNG啟動(dòng)命令. 不是必須,默認(rèn)falseenableAssert 開啟JDK 1.4的斷言. 不是必須,默認(rèn)truefailureProperty 失敗發(fā)生時(shí)要設(shè)置的屬性的名稱. 只有haltonfailure沒有設(shè)置時(shí)才有效. 不是必須.haltonfailure 如果測(cè)試運(yùn)行期間發(fā)生失敗，停止構(gòu)造過程. 不是必須,默認(rèn)falsehaltonskipped 如果發(fā)生至少一次測(cè)試跳過，停止構(gòu)造過程. 不是必須,默認(rèn)falsegroups 要運(yùn)行的組列表，空格或逗號(hào)分隔 excludedgroups 排除在外的組列表，空格或逗號(hào)分隔jvm 使用的jvm，將被Runtime.exec()運(yùn)行 javalisteners 逗號(hào)或空格分隔的全路徑類列表，需要實(shí)現(xiàn)org.testng.ITestListener或org.testng.IReporter 不是必須outputdir 報(bào)告輸出目錄 不是必須,默認(rèn)輸出到test-output.skippedProperty 當(dāng)發(fā)生測(cè)試被跳過時(shí)設(shè)置的property的名稱.只有當(dāng)haltonskipped沒有設(shè)置時(shí)才使用 不是必須sourcedir 用于jdk1.4測(cè)試的PATH-like結(jié)構(gòu)(使用JavaDoc形式的annotations) sourcedirref 用于jdk1.4測(cè)試的PATH-like結(jié)構(gòu)的引用(使用JavaDoc形式的annotations) suiteRunnerClass TestNG啟動(dòng)器的全路徑名稱 不是必須. 默認(rèn)使用org.testng.TestNGparallel 運(yùn)行測(cè)試時(shí)使用的并行模式 - methods或者tests 不是必須 - 如果沒有指定，并行模式不被選擇threadCount 運(yùn)行時(shí)使用的線程數(shù)量。如果并行模式被同時(shí)指定否則忽略。 默認(rèn)1testJar 包含測(cè)試和套件定義的jar包路徑timeOut 所有測(cè)試必須運(yùn)行完成的最大超時(shí)時(shí)間，單位毫秒 useDefaultListeners 是否使用默認(rèn)監(jiān)聽器和報(bào)告器. 默認(rèn)true.workingDir 運(yùn)行TestNG前ant任務(wù)應(yīng)該轉(zhuǎn)移到的目錄。xmlfilesetref 用于要測(cè)試的套件定義的FileSet結(jié)構(gòu)的引用 suitename 設(shè)置測(cè)試套件的默認(rèn)名稱如果在suite的xml文件或者源代碼中都沒有被定義。 不是必須，默認(rèn)設(shè)置為Ant suitetestname 設(shè)置測(cè)試的默認(rèn)名稱如果在suite的xml文件或者源代碼中都沒有被定義。 不是必須，默認(rèn)設(shè)置為Ant test屬性classpath, classpathref或者內(nèi)嵌的必須設(shè)置一個(gè)，用于提供測(cè)試的classpath屬性xmlfilesetref, classfilesetref 或者內(nèi)嵌的 , 分別的必須使用用來提供測(cè)試注意：如果使用jdk1.4，屬性attributes sourcedir, sourcedirref 或者內(nèi)嵌的 必須提供.注意：使用 并不自動(dòng)按添加測(cè)試類到classpath: 需要報(bào)告這些在classpath中的任務(wù)要工作的類內(nèi)嵌元素classpath 任務(wù)支持一個(gè)內(nèi)嵌的 元素來提供PATH-like的結(jié)構(gòu).bootclasspathbootstrap類文件的位置可以用這個(gè)PATH形式的結(jié)構(gòu)指定-如果fork沒有設(shè)置則被忽略xmlfileset套餐定義（testng.xml）可以通過一個(gè)FiltSet結(jié)構(gòu)傳遞給任務(wù)classfilesetTestNG可以直接在類上運(yùn)行，同樣支持FiltSet結(jié)構(gòu)sourcedirPATH形式的結(jié)構(gòu)，用于jdk1.4的測(cè)試，使用javadoc annotationjvmarg通過內(nèi)嵌的元素將額外的參數(shù)傳遞給新的虛擬機(jī)，例如： sysproperty使用內(nèi)嵌的元素來指定類需要的系統(tǒng)屬性。在測(cè)試的執(zhí)行期間虛擬機(jī)可以獲取這些屬性。 這個(gè)元素的屬性和環(huán)境變量相同。 將運(yùn)行測(cè)試并且使得測(cè)試可以訪問basedir屬性reporter內(nèi)部的元素是一個(gè)可選的方式，用于注入自定義的報(bào)告監(jiān)聽器，容許用戶為調(diào)整運(yùn)行時(shí)的報(bào)告期行為而這個(gè)元素強(qiáng)制要求設(shè)置classname屬性，指示自定義監(jiān)聽器的類。為了設(shè)置報(bào)告期屬性，元素可以包含多個(gè)內(nèi)嵌的元素來提供name和value屬性，如下所示： . .public class MyReporter public String getMethodFilter() . public void setMethodFilter(String methodFilter) . public boolean isEnableFiltering() . public void setEnableFiltering(boolean enableFiltering) . .請(qǐng)注意這里僅僅支持有限的屬性類型：String, int, boolean, byte, char, double, float, long, short.env可以通過內(nèi)嵌的 元素給TestNG的單獨(dú)的虛擬機(jī)傳遞指定的環(huán)境變量。要查閱 元素屬性的詳細(xì)描述，請(qǐng)查看ant的exec任務(wù)的描述。舉例：Suite xml Class FileSet TestNG官方文檔中文版(5)-測(cè)試方法/類和組 5 - Test methods, Test classes and Test groups5.1 - Test groupsTestNG容許執(zhí)行復(fù)雜的測(cè)試方法分組。不僅可以申明方法屬于組，而且可以指定分組包含其他分組。然后TestNG可以被調(diào)用，并被要求包含某些分組和排除其他的分組。這將提供怎樣劃分測(cè)試的最大彈性，并且如果想運(yùn)行兩個(gè)不同的測(cè)試裝置不需要重新編譯。例如，非常普遍的需要至少兩個(gè)種類的測(cè)試 * Check-in tests. 這些測(cè)試將在提交新代碼之前運(yùn)行. 它們典型的被要求快速而且僅僅確認(rèn)沒有基礎(chǔ)功能被破壞。 * Functional tests. 這些測(cè)試將覆蓋所有的軟件功能，并且必須運(yùn)行至少1天，盡管理想的是連續(xù)運(yùn)行.代表性的，check-in測(cè)試是功能性測(cè)試的子集。TestNG容許用非常直接的方式說明這個(gè)。例如： 可以這樣構(gòu)造測(cè)試，申明完整的測(cè)試類屬于functest組，另外兩個(gè)方法屬于組checkintest:public class Test1 Test(groups = functest, checkintest ) public void testMethod1() Test(groups = functest, checkintest ) public void testMethod2() Test(groups = functest ) public void testMethod3() 調(diào)用TestNG，使用 將運(yùn)行在類中的所有測(cè)試方法，如果使用checkintest調(diào)用則將只運(yùn)行testMethod1()和testMethod2().這里由其他例子，這次使用正則表達(dá)式。假設(shè)某些測(cè)試方法可能無法在Linux上運(yùn)行，測(cè)試將是類似如此：Testpublic class Test1 Test(groups = windows.checkintest ) public void testWindowsOnly() Test(groups = linux.checkintest ) public void testLinuxOnly() Test(groups = windows.functest ) public void testWindowsToo() 你可以使用下面的testng.xml文件只啟動(dòng)Windows方法： 注意：TestNG使用正則表達(dá)，而不是wildmats。注意這個(gè)差別。Method groups同樣可以包含或排除個(gè)別方法： 這在需要使莫個(gè)單獨(dú)的方法失效而不想重新編譯時(shí)非常方便，但是不建議太多的使用這個(gè)機(jī)制，因?yàn)檫@將可能破壞你的測(cè)試框架 如果你開始重構(gòu)你的java代碼（標(biāo)簽中使用的正則表達(dá)式可能不再匹配你的方法）5.2 - Groups of groupsfunctest itself will contain the groups windows and linux while checkintest will only contain windows. Here is how you would define this in your property file:組可以包含其他組。這些組被稱為MetaGroups。例如，你可能想定義一個(gè)all組，包括checkintest 和functest。functest自身將包含組 windows 和 linux，而checkintest將包含windows. 5.3 - Exclusion groupsTestNG 容許包含組也容許排除組.例如，當(dāng)由因?yàn)樽罱男薷亩R時(shí)破壞的測(cè)試而又沒有時(shí)間去修復(fù)它們時(shí)非常有用。無論如何，你想要干凈的運(yùn)行功能性測(cè)試，因此你想要是這些測(cè)試失效，但是記住它們重新被激活。一個(gè)簡(jiǎn)單的解決這個(gè)問題的方法是創(chuàng)建一個(gè)稱為broken的組并讓這些測(cè)試方法歸屬它。例如，在上面的例子中，我知道testMethod2() 現(xiàn)在被破壞了，所有我想關(guān)閉它：Test(groups = checkintest, broken )public void testMethod2() 現(xiàn)在我所想要做的只是在運(yùn)行中排除這個(gè)組： 用這種方法，我將得到一個(gè)干凈的測(cè)試運(yùn)行，同時(shí)記錄了那些被破壞并想要后續(xù)修復(fù)的測(cè)試。注意：你也可以通過使用在Test and Before/After annotations上的enabled屬性在個(gè)體的層面上關(guān)閉測(cè)試，5.4 - Partial groups你可以在類的級(jí)別上定義組，然后在方法的層次上添加組：Test(groups = checkin-test )public class All Test(groups = func-test ) public void method1() . public void method2() . 在這個(gè)類中，method2() 屬于組checkin-test，在類的級(jí)別定義。而method1() 同時(shí)屬于 checkin-test 和 func-test.TestNG官方文檔中文版(6)-參數(shù) 5.5 - Parameters測(cè)試方法不要求是無參數(shù)的。你可以在每個(gè)測(cè)試方法上使用任意數(shù)量的參數(shù)，并指示testNG傳遞正確的參數(shù)。有兩種方式用于設(shè)置參數(shù)：使用testng.xml或者編程式。 5.5.1 - Parameters from testng.xml如果你要為你的參數(shù)使用簡(jiǎn)單值，你可以在你的testng.xml中明確指定：Parameters(first-name)TestpublicvoidtestSingleString(StringfirstName)System.out.println(InvokedtestString+firstName);assertCedric.equals(firstName);在這個(gè)代碼中，我們明確指定java方法的參數(shù)“firstName”應(yīng)該接收名為“first-name”xml參數(shù)的值。 這個(gè)xml參數(shù)在testng.xml中定義：同樣的方法可以用于注解Before/After和Factory:Parameters(datasource,jdbcDriver)BeforeMethodpublicvoidbeforeTest(Stringds,Stringdriver)m_dataSource=;/lookupthevalueofdatasourcem_jdbcDriver=driver;這次，兩個(gè)java參數(shù)ds和driver將分別接收被設(shè)置給屬性datasource和jdbc-driver的值。參數(shù)可以通過可選注解來聲明為可選：Parameters(db)TestpublicvoidtestNonExistentParameter(Optional(mysql)Stringdb)如果在testng.xml文件中沒有找到名為db的參數(shù)，測(cè)試方法將接受在Optional注解中指定的默認(rèn)值：mysqlParameters 注解可以在下面位置使用： * 在任何有Test, Before/After或者Factory注解的方法上 * 在測(cè)試類的最多一個(gè)構(gòu)造函數(shù)上。這種情況下，當(dāng)TestNG需要實(shí)例化測(cè)試類時(shí)，他將調(diào)用這個(gè)特別的帶有初始化為testng.xml中指定的值的參數(shù)的構(gòu)造函數(shù)。這個(gè)特性可以被用于初始化類內(nèi)部的值域?yàn)閷⒂糜跍y(cè)試方法的值。 注意: * xml參數(shù)被以在注解中出現(xiàn)的相同順序映射到j(luò)ava參數(shù)，如果參數(shù)數(shù)量不匹配testNG將發(fā)生錯(cuò)誤。 * 參數(shù)是有范圍的。在testng.xml中，你可以在標(biāo)簽或者標(biāo)簽下聲明參數(shù)。如果兩個(gè)參數(shù)同名，在標(biāo)簽下定義的參數(shù)優(yōu)先。非常適用于這樣的場(chǎng)合：需要指定一個(gè)應(yīng)用于所有測(cè)試的參數(shù)，但是又希望在特定測(cè)試用覆蓋它的值。 5.5.2 - Parameters with DataProviders在testng.xml中指定參數(shù)，對(duì)于以下情況是不夠的： * 不使用testng.xml * 需要傳遞復(fù)雜參數(shù)，或者參數(shù)需要從java中創(chuàng)建（復(fù)雜對(duì)象，從屬性文件或者數(shù)據(jù)庫中讀取的對(duì)象）在這種情況下，你可以使用Data Provider來提供你測(cè)試需要的數(shù)值。Data Provider是類中的一個(gè)返回對(duì)象數(shù)組的數(shù)組的方法。這個(gè)方法帶有DataProvider注解：/這個(gè)方法將提供數(shù)據(jù)給任何聲明它的DataProvider名為test1的測(cè)試方法DataProvider(name=test1)publicObjectcreateData1()returnnewObjectCedric,newInteger(36),Anne,newInteger(37),;/這個(gè)方法聲明它的數(shù)據(jù)將由名為test1的DataProvider提供Test(dataProvider=test1)publicvoidverifyData1(Stringn1,Integern2)System.out.println(n1+n2); 將打印 Cedric 36 Anne 37 Test方法用dataProvider屬性來指定它的Data Provider。這個(gè)名字必須符合同一個(gè)類中用DataProvider(name=.)注解的方法，它們要使用同一個(gè)匹配的名字。默認(rèn)，將在當(dāng)前類或者它的基類中查找data provider。如果你想將data provider放置到另一個(gè)類中，