JUnit 4.7 的新特性:Rule

  • Geoffrey Wiseman
  • 张龙

2009 年 7 月 23 日

话题:Java语言 & 开发架构

JUnit 4.7 RC 版已经发布了,该版本具有一个重要的新特性:Rule。

本质上,Rule 是 JUnit 的另一种扩展机制,可在每次测试中为 JUnit 增加新功能。Rule 可以替换掉大多数使用旧版本 JUnit 所编写的客户化运行器。关于该特性,之前有博客对其进行了探讨:

在 JUnit3 中,我们也可以用各种方式操控测试的运行过程。JUnit 4 简单性的一个代价就是丧失了这种元测试(meta-testing)的能力。对简单的测试倒是无所谓,但对于那些复杂的测试来说限制就太大了。JUnit 3 的对象框架风格默认情况下就是可扩展的,而 JUnit 4 的 DSL 风格却不是这样。昨晚我们又回归到了元测试,但要比以前更加简单、整洁。

除了增加 Rule 特性,新版 JUnit 还添加了很多核心 Rule:

  • TemporaryFolder:测试可以创建文件与目录并且会在测试运行结束后将其删除。这对于那些与文件系统打交道且独立运行的测试来说很有用。
  • ExternalResource:这是一种资源使用模式,它会提前建立好资源并且会在测试结束后将其销毁。这对于那些使用 socket、嵌入式服务器等资源的测试来说很有用。
  • ErrorCollector:可以让测试在失败后继续运行并在测试结束时报告所有错误。这对于那些需要验证大量独立条件的测试来说很有用(尽管这本身可能是个“test smell”)。
  • ExpectedException:可以在测试中指定期望的异常类型与消息。
  • Timeout:为类中的所有测试应用相同的超时时间。

来看看 Rule 的使用示例吧,下面的测试使用了 TemporaryFolder 和 ExpectedException Rule:

public class DigitalAssetManagerTest {

	@Rule
	public TemporaryFolder tempFolder = new TemporaryFolder();

	@Rule
	public ExpectedException exception = ExpectedException.none();

	@Test
	public void countsAssets() throws IOException {
		File icon = tempFolder.newFile("icon.png");
		File assets = tempFolder.newFolder("assets");
		createAssets(assets, 3);

		DigitalAssetManager dam = new DigitalAssetManager(icon, assets);
		assertEquals(3, dam.getAssetCount());
	}

	private void createAssets(File assets, int numberOfAssets) throws IOException {
		for (int index = 0; index < numberOfAssets; index++) {
			File asset = new File(assets, String.format("asset-%d.mpg", index));
			Assert.assertTrue("Asset couldn't be created.", asset.createNewFile());
		}
	}

	@Test
	public void throwsIllegalArgumentExceptionIfIconIsNull() {
		exception.expect(IllegalArgumentException.class);
		exception.expectMessage("Icon is null, not a file, or doesn't exist.");
		new DigitalAssetManager(null, null);
	}
}

为了简化开发,JUnit 还为这些 Rule 添加了几个基类:

  • Verifier:ErrorCollector 之类的 Rule 的基类,即使验证失败,测试也能通过。
  • TestWatchman:那些观测测试的运行而不会对结果进行修改的 Rule 的基类。

在 JUnit 4.7 的早期构建版中,Rule 在首次出现时被称作拦截器(Interceptor)。除了 Rule 以外,JUnit 4.7 还有以下变化:

  • 匹配器(matcher)的一些变化。
  • 显示超时测试的堆栈信息;这有助于诊断超时的原因。
  • 改进了 javadoc 并修复了几个 bug。

JUnit 4.7 的发布声明中对这些特性进行了详细的介绍。之前的发布声明中说要支持 Hamcrest 1.2,但这次却将其移除了。

在最终版发布前,你可以从 github 上下载 JUnit 4.7 RC 版尝尝鲜、看看 org.junit.rules gear、填下调查问卷、读读 Kent Beck 的 JUnit Max deadpooling、在blogfriendfeedtwitter上了解其他用户对 JUnit 4.7 的一些反馈。

查看英文原文:JUnit 4.7: Per-Test rules

Java语言 & 开发架构