TestNG中文文档(03) -- test.xml

一、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的类。

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

<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测试等等……

默认情况下，TestNG将按照在XML文件中找到的顺序运行测试。如果要以不可预测的顺序运行此文件中列出的类和方法，请将preserve-order 属性设置为false

<test name="Regression1" preserve-order="false">
  <classes>
 
    <class name="test.Test1">
      <methods>
        <include name="m1" />
        <include name="m2" />
      </methods>
    </class>
 
    <class name="test.Test2" />
 
  </classes>
</test>

请参阅DTD获取完整的功能列表，或者继续阅读本文