关于代码

    为了演示 TestNG 的用法，我要为叫做 Jakarta Common Lang 的这个广泛应用的开源库（其中包含一些处理和操纵字符串、数字和 Java 对象的有用的类）编写一些单元测试。在下面的 参考资料 一节中，您可以找到 TestNG 和 Jakarta Common Lang 库的链接；如果您想在自己的机器上随着本文一起练习，这二者都需要下载。

    可以在两个不同的包中得到 TestNG：一个包要求 JDK 5.0，另一个包与 Java 语言 1.4 版本兼容。定义测试的时候，它们使用的语法略有差异：前者使用 JDK 5.0 标注，后者使用旧的 Javadoc 风格的标注。本文使用的是 JDK 5.0 版本，所以在继续阅读本文之前，需要对标注有基本的了解；您可以在 参考资料 中找到关于这个主题的 developerWorks 资源的链接。但是，您要知道 只有在编译和运行测试的时候 才需要 JDK 5.0，所以您仍然可以用自己喜欢的编译器来构建应用程序。实际上，您将用从 Jakarata 项目的 Web 站点下载的相同 JAR 文件来测试 Jakarta Common Lang 库。关于使用 Java 平台 1.4 版本的 TestNG 的更多细节，可以在 TestNG 的 Web 站点上找到。

    最后，请单击本文顶部或底部的 Code 图标，下载 j-testng-sample.zip 文件，其中包含一些示例，演示了如何用 TestNG 为 Jakarta Commons Lang 编写单元测试。在里面，可以找到这里给出的大多数代码，还有其他一些示例。阅读本文并不需要这些代码，但是它可以帮助您更加深入地理解在这里介绍的概念。

    TestNG 快速起步

    TestNG 的测试类是普通的老式 Java 对象；您不需要扩展任何特殊的类，也不需要使用测试方法的任何命名约定：您只要用标注 @Test 通知框架这个类的方法是测试。清单 1 演示了实用类 StringUtils 的一个最简单的测试。它测试 StringUtils 的两个方法： isEmpty（） 方法检测 String 是否为空； trim（） 方法从 String 两端删除控制字符。请注意，其中使用了 Java 指令 assert 来检测错误情况。

清单 1. 针对类 StringUtils 的一个测试用例

package tests;

import com.beust.testng.annotations.*;

import org.apache.commons.lang.StringUtils;

public class StringUtilsTest

{

@Test

public void isEmpty()

{

assert StringUtils.isBlank(null);

assert StringUtils.isBlank("");

}

@Test

public void trim()

{

assert "foo".equals(StringUtils.trim(" foo "));

}

}

但是，在运行测试之前，必须用特殊的 XML 文件配置 TestNG，习惯上把这个文件命名为 testng.xml。这个文件的语法非常简单，如清单 2 所示。这个文件首先定义测试套件 My test suite，这个套件只包含一个测试 First test，这个测试由 StringUtilsTest 类完成。