TestNG官方文档中文版(3)-testng.xml

TestNG的官方文档的中文翻译版第3章，原文请见 http://testng.org/doc/documentation-main.html
3 - testng.xml

调用TestNG由几种不同方法：

* 使用testng.xml文件
* 使用ant
* 从命令行

这节描述testng.xml的格式（文档的后面会讲到ant和命令行）。

当前testng.xml的DTD文件可以从官方找到：http://testng.org/testng-1.0.dtd。（为了方便使用，你可能更喜欢浏览HTML版本）。
下面是testng.xml文件的一个例子：

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >

<suite name="Suite1" verbose="1" >
<test name="Nopackage" >
<classes>
<class name="NoPackageTest" />
</classes>
</test>

<test name="Regression1" >
<classes>
<class name="test.sample.ParameterSample" />
<class name="test.sample.ParameterTest" />
</classes>
</test>
</suite>

你可以指定包名替代类名：

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >

<suite name="Suite1" verbose="1" >
<test name="Regression1" >
<packages>
<package name="test.sample" />
</packages>
</test>
</suite>

在这个例子中，TestNG将在包test.sample中查找所有的类，并只保留带有TestNG annotation的类。

你同样可以指定包含或不包含的组和方法:

<test name="Regression1">
<groups>
<run>
<exclude name="brokenTests" />
<include name="checkinTests" />
</run>
</groups>

<classes>
<class name="test.IndividualMethodsTest">
<methods>
<include name="testMethod" />
</methods>
</class>
</classes>
</test>

你同样可以在testng.xml中定义新的组，指定属性的额外详细情况，比如是否并行运行测试，使用多少线程，是否运行junit测试，等等...
请查看DTD文件了解完整的特性列表。

via：http://www.blogjava.net/aoxj