JUnit 4.7的新特性：Rule

作者 Geoffrey Wiseman 译者 张龙 发布于 2009年7月23日

领域

架构 & 设计,

语言 & 开发

主题

扩展性 ,

Java

标签

JUnit

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、在blog、friendfeed及twitter上了解其他用户对JUnit 4.7的一些反馈。

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

译者 张龙 热衷于编程，乐于分享，对新技术有强烈的探索欲，对Java轻量级框架有一定研究。

1. 返回顶部

   请教

   发表人 Xiang Eric

   ErrorCollector的存在有什么具体的作用？如果一个Test Method内存在多个多个断言，不是违背了Test Method的唯一目的性么？笨笨的请教一下。

   回复

2. 返回顶部

   Re: 请教

   发表人 张 凯峰

   test method的唯一目的性指的就是只能有一个断言？

   回复

• 更早的 >