TestNG使用说明.docx

1、TestNG使用说明介绍 TestNG是一个设计用来简化广泛的测试需求的测试框架，从单元测试（隔离测试一个类）到集成测试（测试由有多个类多个包甚至多个外部框架组成的整个系统，例如运用服务器）。测试的过程的三个典型步骤，注意和junit(4.0)相比，多了一个将测试信息添加到testng.xml文件或者build.xml。测试信息尤其是测试数据不再写死在测试代码中，好处就是修改测试数据时不需要修改代码/编译了，从而有助于将测试人员引入单元测试/集成测试。编写一个测试的过程有三个典型步骤：编写测试的业务逻辑并在代码中插入TestNG annotation。将测试信息添加到testng.xml文件或

2、者build.xml中。运行TestNG基本概念：suite由xml文件描述。它包含一个或多个测试并被定义为标签test由描述并包含一个或者多个TestNG类TestNG类是包含至少一个TestNG annotation的Java类，由标签描述并包含一个或多个测试方法测试方法是源文件中带有Testd注释的java方法基本概念，相比junit的TestCase/TestSuite，TestNG有suite/test/test method三个级别，即将test/test method明确区分开了。junit中的TestCase将test/test method混合，比较容易让人概念不清晰，尤其是

3、新手。TestNG测试可以被BeforeXXX 和 AfterXXX annotations配置，容许在特定点的前后执行一些java逻辑，这些点上面已经列出。这份手册的剩余部分将讲述以下内容：所有的annotation列表并带有简短说明，为TestNG的多种功能性提供参考, 你可能需要参考为每个annotation提供的代码片段来学习细节。testng.xml文件描述，它的语法和如果指定它。多个特性的详细列表和怎样结合annotation和testng.xml来使用它们安装TestNG在线安装安装testNG插件打开Eclipse Help -Install New Software , 然后

4、Add：离线安装首先下载testng离线包:1. 将解压后的文件.eclipse-testng离线包featuresorg.testng.eclipse_6.9.9.201510270734文件夹放到eclipse-features目录下2. 将解压后的文件.eclipse-testng离线包pluginsorg.testng.eclipse_6.9.8.201510130443文件夹放到 eclipse-plugins目录下3. 重启eclipse4. 验证是否安装成功，file-new-other-TestNgJar包下载地址下载地址：TestNG的官方文档原文请见http:/testng

5、.org/doc/documentation-main.htmlAnnotation注释BeforeSuiteAfterSuiteBeforeTestAfterTestBeforeGroupsAfterGroupsBeforeClassAfterClassBeforeMethodAfterMethodConfiguration information for a TestNG class:BeforeSuite:被注释的方法将在所有测试运行前运行AfterSuite:被注释的方法将在所有测试运行后运行BeforeTest:被注释的方法将在测试运行前运行，此方法在标记将要运行前。AfterTes

6、t: 被注释的方法将在测试运行后运行BeforeGroups: 被配置的方法将在列表中的gourp前运行。这个方法保证在第一个属于这些组的测试方法调用前立即执行。AfterGroups: 被配置的方法将在列表中的gourp后运行。这个方法保证在最后一个属于这些组的测试方法调用后立即执行。BeforeClass: 被注释的方法将在当前类的第一个测试方法调用前运行。AfterClass:被注释的方法将在当前类的所有测试方法调用后运行。BeforeMethod: 被注释的方法将在每一个测试方法调用前运行。AfterMethod: 被注释的方法将在每一个测试方法调用后运行。alwaysRun对于每个b

7、ufore方法(beforeSuite, beforeTest, beforeTestClass 和 beforeTestMethod, 但是不包括 beforeGroups): 如果设置为true，被配置的方法将总是运行而不管它属于哪个组。对于after方法(afterSuite, afterClass, .): 如果设置为true，被配置的方法甚至在一个或多个先调用的方法失败或被忽略时也将运行。dependsOnGroups这个方法依赖的组列表dependsOnMethods这个方法依赖的方法列表enabled这个类的方法是否激活groups这个类或方法所属的分组列表inheritGrou

8、ps如果设置为true，这个方法被属于在类级别被Test annotation指定的组DataProvider标记一个方法用于为测试方法提供数据。被注释的方法必须返回Object, 其中每个Object可以指派为这个测试方法的参数列表。从这个DataProvider接收数据Test方法需要使用一个和当前注释相同名称的dataProvider名称name 这个DataProvider的名称name这个DataProvider的名称。如果未定义，dataprovider将自动命名为方法名。parallel如果设置为true，测试中的data provider会同时运行。默认值为false。Fact

9、ory标记方法作为一个返回对象的工厂，这些对象将被TestNG用于作为测试类。这个方法必须返回Object。Listeners在一个测试类中定义监听器。value一串数组类扩展org.testng.ITestNGListener.Parameters描述如何传递参数给Test方法。value用于填充这个方法的参数的变量列表Test标记一个类或方法作为测试的一部分alwaysRun如果设置为true，这个测试方法将总是运行，甚至当它依赖的方法失败时。dataProvider这个测试方法的data provider的名称dataProviderClass用于查找data provider的类。如果

10、不指定，将在当前测试方法所在的类或者它的基类上查找data provider。如果这个属性被指定, 则data provider方法需要是指定类的static方法。dependsOnGroups当前方法依赖的组列表dependsOnMethods当前方法依赖的方法列表description当前方法的描述enabled当前类的方法/方法是否被激活expectedExceptions测试方法期望抛出的异常列表。如果没有异常或者抛出的不是列表中的任何一个，当前方法都将标记为失败.groups当前类/方法所属的组列表invocationCount当前方法被调用的次数invocationTimeOut该

11、测试所被调用次数的最大耗时，单位毫秒。如果调用次数未定义忽略本属性。priority测试方法优先级，低优先级的优先预订。successPercentage当前方法期望的成功率。singleThreaded如果设置为true，即使测试集现在运行方法设置为parallel=methods，测试类中的所有方法运行在同一个线程中。本属性只可以在类一级使用，忽略在方法一级的使用。注：依次调用本属性（已过时）timeOut当前方法容许花费的最大时间，单位毫秒。threadPoolSize当前方法的线程池大小。方法将被多线程调用，次数由invocationCount参数指定注意：如果invocationCo

12、unt没有指定则这个属性将被忽略注：上面是TestNG中用到的annotation列表，从中我们可以看到TestNG提供的一些特性1. before方法和after方法，带来了足够丰富的测试生命周期控制2. dependsOnGroups/dependsOnMethods 提供了依赖检查机制，并可以严格控制执行顺序3. DataProvider 使得对同一个方法的测试覆盖变的非常轻松，非常适合进行边界测试，只要给出多种测试数据就可以针对一个测试方法进行覆盖4. expectedExceptions 使得异常测试变的非常轻松5. invocationCount/threadPoolSize 终于

13、可以简单的直接进行多线程测试了，这个绝对是junit的超级弱项，回想junit中那个万恶的System.exist(0).6. timeOut 终于不用死等然后手工强行关闭测试，TestNG想的太周到了testng.xml调用TestNG由几种不同方法： * 使用testng.xml文件 * 从命令行这节描述testng.xml的格式。当前testng.xml的DTD文件可以从官方找到：http:/testng.org/testng-1.0.dtd.php。下面是testng.xml文件的一个例子：你可以指定包名替代类名：在这个例子中，TestNG将在包test.sample中查找所有的类，并

14、只保留带有TestNG annotation的类。你同样可以指定包含或不包含的组和方法:你同样可以在testng.xml中定义新的组，指定属性的额外详细情况，比如是否并行运行测试，使用多少线程，是否运行junit测试，等等.请查看DTD文件了解完整的特性列表。运行TestNGTestNG可以以不同的方式调用： * Command line * Eclipse * IntelliJs IDEA1) 命令行假设你已经将TestNG加入到class path，调用TestNG最简单的方法事下面的：java org.testng.TestNG testng1.xml testng2.xml testn

15、g3.xml .必须指定最少一个描述你试图测试的TestNG suite的xml文件。另外，下面的命令行参数可以使用：命令行参数列表操作参数说明-configfailurepolicyskip|continueTestNG是否继续执行suite中剩下的测试集，或者跳过Before*失败方法。模式习惯跳过。-dA directoryThe directory where the reports will be generated (defaults totest-output).-dataproviderthreadcountThe default number of threads to us

16、e for data providers when running tests in parallel.This sets the default maximum number of threads to use for data providers when running tests in parallel. It will only take effect if the parallel mode has been selected (for example, with the -parallel option). This can be overridden in the suite

17、definition.-excludegroupsA comma-separated list of groups.The list of groups you want to be excluded from this run.-groupsA comma-separated list of groups.The list of groups you want to run (e.g.windows,linux,regression).-listenerA comma-separated list of Java classes that can be found on your class

18、path.Lets you specify your own test listeners. The classes need to implementorg.testng.ITestListener-methodsA comma separated list of fully qualified class name and method. For examplecom.example.Foo.f1,com.example.Bar.f2.Lets you specify individual methods to run.-methodselectorsA comma-separated l

19、ist of Java classes and method priorities that define method selectors.Lets you specify method selectors on the command line. For example:com.example.Selector1:3,com.example.Selector2:2-parallelmethods|tests|classesIf specified, sets the default mechanism used to determine how to use parallel thread

20、s when running tests. If not set, default mechanism is not to use parallel threads at all. This can be overridden in the suite definition.-reporterThe extended configuration for a custom report listener.Similar to the-listeneroption, except that it allows the configuration of JavaBeans-style propert

21、ies on the reporter instance.Example:-reporter com.test.MyReporter:methodFilter=*insert*,enableFiltering=trueYou can have as many occurences of this option, one for each reporter that needs to be added.-sourcedirA semi-colon separated list of directories.The directories where your javadoc annotated

22、test sources are. This option is only necessary if you are using javadoc type annotations. (e.g.src/testorsrc/test/org/testng/eclipse-plugin;src/test/org/testng/testng).-suitenameThe default name to use for a test suite.This specifies the suite name for a test suite defined on the command line. This

23、 option is ignored if the suite.xml file or the source code specifies a different suite name. It is possible to create a suite name with spaces in it if you surround it with double-quotes like this.-testclassA comma-separated list of classes that can be found in your classpath.A list of class files

24、separated by commas (e.g.org.foo.Test1,org.foo.test2).-testjarA jar file.Specifies a jar file that contains test classes. If atestng.xmlfile is found at the root of that jar file, it will be used, otherwise, all the test classes found in this jar file will be considered test classes.-testnameThe def

25、ault name to use for a test.This specifies the name for a test defined on the command line. This option is ignored if the suite.xml file or the source code specifies a different test name. It is possible to create a test name with spaces in it if you surround it with double-quotes like this.-testnam

26、esA comma separated list of test names.Only tests defined in a tag matching one of these names will be run.-testrunfactoryA Java classes that can be found on your classpath.Lets you specify your own test runners. The class needs to implementorg.testng.ITestRunnerFactory.-threadcountThe default numbe

27、r of threads to use when running tests in parallel.This sets the default maximum number of threads to use for running tests in parallel. It will only take effect if the parallel mode has been selected (for example, with the -parallel option). This can be overridden in the suite definition.-xmlpathinjarThe path of the XML file inside the jar file.This attribute should contain the path to a valid XML file inside the test jar (e.g.resources/testng.xml). The default istestng.xml, which means a file called testng.xml at the root of the jar file. This option will be ignored unless-testjaris specif