【译】TestNG官方文档中文版（03）—— testng.xml

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 annotations的类。

你也可以指定要包含和排除掉的组和方法：

<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定义新的group，并且在属性中指明额外的详细信息，例如是否并行运行，使用多少个线程，并且是否正在运行JUnit测试等等……请参阅DTD获取完整的功能列表，或者继续阅读本文。