在本文中,我将为自动的编译和测试过程采取实用的方法。使用 Ant 1.3 和 JUnit 测试框架,将像您展示如何自动化一个过程,这个过程捕获每个测试套件运行的相关信息、生成有吸引力的报告并用电子邮件发送这个报告。虽然这些性能有许多隐含在 Ant 中,但我还是修改了许多核心任务来更好地满足要求。这些修改是本文的中心,它们将全部结合到 Ant 的下一个发行版中。可以在本文附带的源文件中找到所有补丁(请参阅参考文件)。您可能需要在阅读时回顾一下代码。此外,如果不熟悉 Ant 1.3,可能需要在继续这篇文章时学习官方的 Ant 文档(请参阅参考资料)。
为什么使用 Ant 和 JUnit?
Ant 1.3 是编译工具中的实际标准。由于用 Java 语言编写,Ant 是开放源代码的,可以在多种平台上运行,并为编译过程带来了很大的灵活性。JUnit 测试框架也是开放源代码的,它被广泛使用,并与 Ant 的编译过程集成(想学更多关于 Ant 和 JUnit 的知识,请参阅参考资料)。
Ant 1.3 加上可选的 <junit> 以及 <junitreport> 任务,不经修改就可以启动基本编译和测试的自动过程。这一过程如下:
运行 JUnit 测试实用程序
捕获测试结果
创建吸引人的 HTML 总结报告
一旦捕获结果,就可以使用 XML 格式化器将每个测试套件运行的故障和错误数,连同软件包和类名还有测试套件的执行时间一起引入。对于每个测试套件,都有以下信息被捕获:
执行 JUnit 测试
将结果记录到 XML 文件或其它格式的文件
将结果转化为基于 XSL 格式的测试报告
将这个报告转化为 HTML 格式
用电子邮件发送报告
请给我更多数据
除了将 Ant 和 JUnit 扩展到能自动进行编译和测试的过程的程度外,我还添加了测试期间捕获的标准数据。即,我需要知道使用的是什么操作系统、测试的日期/时间、支持测试运行的 JVM 版本以及 classpath。
为捕获这个信息,我对 Ant 的 JUnit 相关类中的四个类:JUnitTask、JUnitTest、JUnitTestRunner 以及 XMLJUnitResultFormatter 做了简单修改。您会在附带的源文件中发现这些变化。
作为附带的优点,当扩展捕获的数据时,最终捕获的不仅是在测试套件运行时特定状态的信息,而且还包括了整个 Ant 的操作属性集。其中包含系统属性和内部 Ant 属性(例如用户定义的属性)。
让数据报告自动化
对 Ant 的 <junit> 任务进行扩展,使之能提供额外状态的信息之后,下一步就是启用自动化的数据报告。
使用 Ant 的最大优势之一是它的可扩展性。对于使用带有 XML 格式化器(<formatter type="xml"/>)的 <junit> 任务运行的每个测试类,都创建了一个 XML 文件。<junitreport> 任务提供了一种很好的将所有收集的数据聚集到一起的方法。使用 XSLT,它会将测试数据转化为一种可以被轻松理解的 HTML 格式报告。
<mimemail> 具有清楚的自解释的语法。提供的代码中包含了这项任务的 Ant 风格的帮助文件(请参阅参考资料)。不仅 HTML 报告被发送(使用 messageFile 属性以便附加到消息的正文部分),而且原始的 XML 结果文件也作为标准 MIME 附件用 <fileset> 被发送了。
<junitreport> 在前面创建了一个名叫 overview-summary.html 的文件(因为指定了“noframes” 选项)。
排障、测试和部署
我为 Ant 开发团体提供了刚才讨论的所有的代码修正,他们已经认可将其包含到以后的发行版中去。但是,因为官方的 Ant 发行版还没有包含这篇文章中使用的技巧,在让这些技巧为您服务之前还需要采取一些措施。
让代码生效
第一,这些代码的修正是基于 Ant 1.3 发行版的;这是我将推荐的用于这代码的唯一 Ant 版本。提供的代码包含了 JUnitMail.jar 和用于生成 jar 文件的源代码。这个 jar 文件必须存在于启动 Ant 环境中的 classpath 里 — 在 Ant 的 optional.jar 之前。
如果您是个典型的 Ant 用户,您通过 $ANT_HOME/bin 中的包装脚本之一运行 Ant。这些包装脚本在启动 Ant 前将所有 $ANT_HOME/lib 中的 jar 文件放入 classpath。在 Windows 平台下只要将 JUnitMail.jar 放入 $ANT_HOME/lib 目录,用 ant.bat 就可以处理 classpath 问题。
如果遇到过古怪的行为(例如,也许从 <junit> 捕获的额外参数没有在 XML 文件中出现),那么就调试在包装脚本中用到的 classpath(例如,ant.bat 中的 %LOCALCLASSPATH% )