TestNG官方文档中文版(4)-运行TestNG

转自：http://www.blogjava.net/aoxj/archive/2008/03/22/187938.html

4 - 运行TestNG

TestNG可以以不同的方式调用：

* Command line

* ant

* Eclipse

* IntelliJ's IDEA

1) 命令行

假设你已经将TestNG加入到class path，调用TestNG最简单的方法事下面的：

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

必须指定最少一个描述你试图测试的TestNG suite的xml文件。另外，下面的命令行参数可以使用：

命令行参数列表

选项 参数 文档说明

-d 一个目录 生成报告的目录（ test-output）

-sourcedir 分号隔开的目录列表 带有javadoc注释的测试源文件目录. 这个选项只在使用javadoc类型的annotation时才有效.

(例如 "src/test" or "src/test/org/testng/eclipse-plugin;src/test/org/testng/testng").

-testclass 可以在classpath路径中找到的逗号分隔的类列表。逗号分隔的类文件列表(例如 "org.foo.Test1,org.foo.test2").

-groups 逗号分隔的组列表 要运行的组列表(例如 "windows,linux,regression").

-excludegroups 逗号分隔的组列表 不想包含在这次运行中的组列表

-testrunfactory 可以在classpath中找到的java类 指定测试的runner.这个类需要实现接口org.testng.ITestRunnerFactory .

-listener 可以在classpath路径中找到的逗号分隔的类列表。 指定测试的listener. 这个类需要实现接口org.testng.ITestListener

-parallel methods|tests 如果指定, 设置运行测试时如何使用并发线程的默认机制.如果不设置，默认机制是完全不使用并发线程。这个设置可以被suite定义覆盖.

-threadcount 并发测试运行时默认使用的线程数 用于设置并发测试时默认的线程数. 只在并发模式被选择时才生效 (例如, 打开 -parallel 选项). 这个设置可以被suite定义覆盖.

-suitename 测试套件使用的默认名称.
指定在命令行上定义的测试套件的名称。如果suite.xml文件或源代码指定了另外一个不同的套件名称，这个选项将被忽略。可以创建带空格的套件名称，
如果在名称前后加双引号如"like this".

-testname 测试使用的默认名称. 指定在命令行上定义的测试的名称。如果suite.xml文件或源代码指定了另外一个不同的测试名称，这个选项将被忽略。可以创建带空格的测试名称，如果在名称前后加双引号如"like this".

-reporter 扩展配置用于自定义报告listenner. 类似 -listener 选项, 除了容许reporter示例上由javabean形式的配置.

例如: -reporter com.test.MyReporter:methodFilter=*insert*,enableFiltering=true

可以通过不带任何参数直接调用TestNFG来获得这个文档。

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

C:> more c:/command.txt

-d test-output testng.xml

C:> java org.testng.TestNG @c:/command.txt

另外，可以通过jvm的命令行来传递参数给TestNG，例如

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

TestNG能够理解的参数

属性 类型 文档

testng.test.classpath 分号分隔的包含测试类的一系列目录
如果这个属性被设置，TestNG将使用它替代从class path来查找测试类.
如果你正在使用在xml文件里面的包标签并且在classpath路径中由很多类而大部分都不是测试类的时候比较方便

举例:

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

注意 ant 任务和testng.xml容许用更多的参数来启动TestNG（包含的方法，指定的参数，等等），因此可以认为命令行适用于学习TestNG并且想快速入门。

2) Ant

可以这样定义TestNG的ant任务：

<taskdef resource="testngtasks"

classpath="testng.jar"/>

这个任务运行TestNG测试，并且通常是在单独的jvm中。接受下面的属性：

属性名 描述 是否必须

annotations 字符串"JDK"或者"Javadoc". 定义测试适用的注释类型.如果使用"Javadoc",
则需要同时指定"sourcedir". 不是必须. 如果适用jkd5则默认为"JDK"，如果适用jdk1.4则默认为"Javadoc"

classfilesetref 要运行的测试类的FileSet结构的引用.

classpath 要运行的测试的PATH-like 结构.

classpathref 要运行的测试的PATH-like 结构的引用.

dumpCommand 打印TestNG启动命令. 不是必须,默认false

enableAssert 开启JDK 1.4的断言. 不是必须,默认true

failureProperty 失败发生时要设置的属性的名称. 只有haltonfailure没有设置时才有效. 不是必须.

haltonfailure 如果测试运行期间发生失败，停止构造过程. 不是必须,默认false

haltonskipped 如果发生至少一次测试跳过，停止构造过程. 不是必须,默认false

groups 要运行的组列表，空格或逗号分隔

excludedgroups 排除在外的组列表，空格或逗号分隔

jvm 使用的jvm，将被Runtime.exec()运行 java

listeners 逗号或空格分隔的全路径类列表，需要实现org.testng.ITestListener或org.testng.IReporter 不是必须

outputdir 报告输出目录 不是必须,默认输出到test-output.

skippedProperty 当发生测试被跳过时设置的property的名称.只有当haltonskipped没有设置时才使用 不是必须

sourcedir 用于jdk1.4测试的PATH-like结构(使用JavaDoc形式的annotations)

sourcedirref 用于jdk1.4测试的PATH-like结构的引用(使用JavaDoc形式的annotations)

suiteRunnerClass TestNG启动器的全路径名称 不是必须. 默认使用org.testng.TestNG

parallel 运行测试时使用的并行模式 - methods或者tests 不是必须 - 如果没有指定，并行模式不被选择

threadCount 运行时使用的线程数量。如果并行模式被同时指定否则忽略。 默认1

testJar 包含测试和套件定义的jar包路径

timeOut 所有测试必须运行完成的最大超时时间，单位毫秒

useDefaultListeners 是否使用默认监听器和报告器. 默认true.

workingDir 运行TestNG前ant任务应该转移到的目录。

xmlfilesetref 用于要测试的套件定义的FileSet结构的引用

suitename 设置测试套件的默认名称如果在suite的xml文件或者源代码中都没有被定义。 不是必须，默认设置为"Ant suite"

testname 设置测试的默认名称如果在suite的xml文件或者源代码中都没有被定义。 不是必须，默认设置为"Ant test"

属性classpath, classpathref或者内嵌的<classpath>必须设置一个，用于提供测试的classpath

属性xmlfilesetref, classfilesetref 或者内嵌的 <xmlfileset>, 分别的<classfileset>必须使用用来提供测试

注意：如果使用jdk1.4，属性attributes sourcedir, sourcedirref 或者内嵌的 <sourcedir> 必须提供.

注意：使用<classfileset> 并不自动按添加测试类到classpath: 需要报告这些在classpath中的任务要工作的类

内嵌元素

classpath

<testng> 任务支持一个内嵌的<classpath> 元素来提供PATH-like的结构.

bootclasspath

bootstrap类文件的位置可以用这个PATH形式的结构指定-如果fork没有设置则被忽略

xmlfileset

套餐定义（testng.xml）可以通过一个FiltSet结构传递给任务

classfileset

TestNG可以直接在类上运行，同样支持FiltSet结构

sourcedir

PATH形式的结构，用于jdk1.4的测试，使用javadoc annotation

jvmarg

通过内嵌的<jvmarg>元素将额外的参数传递给新的虚拟机，例如：

<testng>

<jvmarg value="-Djava.compiler=NONE" />

<!-- ... -->

</testng>

sysproperty

使用内嵌的<sysproperty>元素来指定类需要的系统属性。在测试的执行期间虚拟机可以获取这些属性。 这个元素的属性和环境变量相同。

<testng>

<sysproperty key="basedir" value="${basedir}"/>

<!-- ... -->

</testng>

将运行测试并且使得测试可以访问basedir属性

reporter

内部的<reporter>元素是一个可选的方式，用于注入自定义的报告监听器，容许用户为调整运行时的报告期行为而

这个元素强制要求设置classname属性，指示自定义监听器的类。为了设置报告期属性，<reporter>元素可以包含多个内嵌的<property>元素来提供name和value属性，如下所示：

<testng ...>

...

<reporter classname="com.test.MyReporter">

<property name="methodFilter" value="*insert*"/>

<property name="enableFiltering" value="true"/>

</reporter>

...

</testng>

public class MyReporter {

public String getMethodFilter() {...}

public void setMethodFilter(String methodFilter) {...}

public boolean isEnableFiltering() {...}

public void setEnableFiltering(boolean enableFiltering) {...}

...

}

请注意这里仅仅支持有限的属性类型：String, int, boolean, byte, char, double, float, long, short.

env

可以通过内嵌的 <env>元素给TestNG的单独的虚拟机传递指定的环境变量。

要查阅<env> 元素属性的详细描述，请查看ant的exec任务的描述。

举例：

Suite xml

<testng classpathref="run.cp"

outputDir="${testng.report.dir}"

sourcedir="${test.src.dir}"

haltOnfailure="true">

<xmlfileset dir="${test14.dir}" includes="testng.xml"/>

</testng>

Class FileSet

<testng classpathref="run.cp"

outputDir="${testng.report.dir}"

haltOnFailure="true"M verbose="2">

<classfileset dir="${test.build.dir}" includes="**/*.class" />

</testng>