【转载】TestNG指南4-运行TestNG

ゝ一世哀愁。 2022-05-14 09:26 191阅读 0赞

可用两种方式调用TestNG:

*  命令行
 *  [ant][]
 *  [Eclipse][]
 *  [IntelliJ's IDEA][IntelliJ_s IDEA]

本节仅解释如何从命令行调用TestNG，如果你对其它调用方式感兴趣，请点击以上相应链接。

假设TestNG已经加入了在你的类路径中，可以用下面的简单方式调用TestNG:

java org.testng.TestNG testng1.xml [testng2.xml testng3.xml ...]

必须指定最少一个XML文件，描述你想要运行的TestNG 测试套件。另外，可以使用下面的命令行开关：

<table style="color:#333333;font-size:14px;line-height:26px;text-align:left;text-indent:0px;border:medium none;border-collapse:collapse;width:650px;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;" colspan="3"> 命令行参数 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> 选项 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 参数 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 说明 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -d </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 目录&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 生成测试报告的目录（默认为test-output）。 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -sourcedir </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 用分号分隔的目录列表 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 带有javadoc注解的测试源文件目录，这个选项只在使用javadoc类型的注解时才有必要。(例如：“src/test”或 “src/test/org/testng/eclipse-plugin; src/test/org/testng/testng”) </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -testclass </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 用逗号分隔的类列表，可以在类路径中找到 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 用逗号分隔的类文件列表（例如： “org.foo.Test1,org.foo.test2”） </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -groups </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 用逗号分隔的组列表 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 希望运行的组列表（例如：“windows,linux,regression”） </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -excludegroups </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 用逗号分隔的组列表 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 不希望运行的组列表 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -testrunfactory </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 在类路径中能够找到的Java类 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 指定测试的runner，这个类需要实现 <a style="color:#336699;text-decoration:none;" href="http://testng.org/javadocs/org/testng/ITestRunnerFactory.html" rel="nofollow">org.testng.ITestRunnerFactory&nbsp;</a>接口。 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -listener </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 用逗号分隔的Java类，可以在类路径中找到 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 指定测试的监听器，这个类需要实现 <a style="color:#336699;text-decoration:none;" href="http://testng.org/javadocs/org/testng/ITestListener.html" rel="nofollow">org.testng.ITestListener&nbsp;</a>接口。 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -parallel </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> methods|tests </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 如果指定,&nbsp;设置运行测试时如何使用并行线程的默认机制.如果不设置，默认机制是完全不使用并行线程。本设置可被测试套件定义覆盖。 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -threadcount </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 并行运行测试时默认使用的线程数 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 设置并行运行测试使用的默认最大线程数。仅在选择并行模式时才有效（例如，使用-parallel选项）。本设置可被测试套件定义覆盖。 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -suitename </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 测试套件使用的默认名称 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 指定在命令行上定义的测试套件名称。如果suite.xml文件或源代码指定了不同的测试套件名称，则本选项将被忽略。如果在名称前后加双引号，则可以创建带空格的测试套件名称，如“like this”。 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -testname </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 测试使用的默认名称 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 指定在命令行上定义的测试名称。如果suite.xml文件或源代码指定了不同的测试名称，则本选项将被忽略。如果在名称前后加双引号，则可以创建带空格的测试名称，如“like this”。 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;width:62.6pt;"> -reporter </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:78.45pt;"> 为自定义报告监听器使用的扩展配置 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:285.05pt;"> 类似-listener选项，除了在reporter实例上允许配置JavaBeans形式的属性。 例如：-reporter com.test.MyReporter: methodFilter=*insert*, enableFiltering=true You can have as many occurences of this option, one for each reporter that needs to be added. </td> 
 </tr> 
 </tbody> 
</table>

可以通过不带任何参数调用TestNG来获得本文档。

也可以将命令行开关写到txt文件中，例如：c:/command.txt, 然后告诉TestNG使用这个文件类取回参数:

C:> more c:/command.txt
    
      -d test-output testng.xml
    
      C:> java org.testng.TestNG @c:/command.txt

另外，TestNG可以通过Java虚拟机的命令行来传递属性，例如：

java -Dtestng.test.classpath="c:/build;c:/java/classes;" org.testng.TestNG testng.xml

下面是TestNG能够理解的属性：

<table style="font-family:Arial;color:#333333;font-size:14px;line-height:26px;text-align:left;text-indent:0px;border:medium none;width:654px;border-collapse:collapse;"> 
 <tbody> 
 <tr> 
 <td style="width:410.4pt;" colspan="3"> 系统属性 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;"> 属性 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;"> 类型 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:197.85pt;"> 说明 </td> 
 </tr> 
 <tr> 
 <td style="border-style:none solid solid;border-width:medium 1pt 1pt;"> testng.test.classpath </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;"> 用分号分隔的包含测试类的一系列目录 </td> 
 <td style="border-style:none solid solid none;border-width:medium 1pt 1pt medium;width:197.85pt;"> 如果设置了本属性，TestNG将使用它代替从类路径中查找测试类。这在XML文件中使用包标签，并且在类路径中有大量的类而大多数类并非测试类的时候很方便。 </td> 
 </tr> 
 </tbody> 
</table>

**例如：**

java org.testng.TestNG -groups windows,linux -testclass org.test.MyTest

注意： [ant 任务][ant]和[testng.xml][]允许使用更多的参数来启动TestNG（包含的方法、指定的参数，等等），因此，当你打算学习TestNG并想要快速运行TestNG时，应该考虑使用命令行。

[ant]: http://testng.org/doc/ant.html
[Eclipse]: http://testng.org/doc/eclipse.html
[IntelliJ_s IDEA]: http://testng.org/doc/idea.html
[testng.xml]: http://blog.csdn.net/yawolf/archive/2008/08/02/2758890.aspx