JUnit 4.7 的新特性：Rule

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