JUnit 5 –设置

2015年11月， JUnit Lambda团队展示了他们的原型 。 此后，该项目更名为JUnit 5，并于2016年2月发布了Alpha版本。我们将在一系列简短文章中对其进行探讨：

• 设定
• 基本
• 建筑
• 条件
• 注射
• …

本章讨论JUnit 5的设置，以便您可以针对新API编写代码并在IDE或构建工具中运行测试。

总览

在新兴的《 JUnit 5用户指南》中可以找到您将在此处阅读的更多内容以及更多内容。 请注意，它基于Alpha版本，因此可能会发生变化。

确实，我们鼓励我们提出问题或提出请求，以便JUnit 5可以进一步改进。 请利用这个机会！ 这是帮助JUnit帮助我们的机会。

如有必要，此帖子将得到更新。 我在这里显示的代码示例可以在Github上找到。

写作测试

junit5-api构件中包含用于编写测试的API。 编写测试只需要使用您喜欢的构建工具将其包含在项目中即可。

• 群组ID ：org.junit5
• 工件ID ：junit5-api
• 版本 ：5.0.0-ALPHA

要处理一些事情，让我们快速创建第一个测试 ：

HelloWorldTest.java

package org.codefx.demo.junit5;
 
import org.junit.gen5.api.Test;
 
class HelloWorldTest {
 
	@Test
	void helloJUnit5() {
		System.out.println("Hello, JUnit 5.");
	}
 
}

见妈，不公开！ 酷吧？ 我目前不会讨论它，但是下一篇文章将讨论这个（以及其他基础知识），所以请继续关注。

运行测试

随着JUnit 5的不断发展，缺乏对本机工具的支持。 但是有一些准备工作可以使一切正常运行。

JUnit 4运行器

甲测试运行称为JUnit5可以用来作为JUnit 4运行的一部分来运行新的测试。 您将在自己的工件中找到它，必须将其添加到项目中：

• 群组ID ：org.junit5
• 工件ID ：junit4-runner
• 版本 ：5.0.0-ALPHA

运行程序将调用实际运行JUnit 5测试的引擎。 引擎还具有自己的工件，您必须添加以下工件：

• 群组ID ：org.junit5
• 工件ID ：junit5-engine
• 版本 ：5.0.0-ALPHA

要运行项目中的所有测试，最简单的为其创建测试套件的方法是：

package org.codefx.demo.junit5;
 
import org.junit.gen5.junit4.runner.JUnit5;
import org.junit.gen5.junit4.runner.Packages;
import org.junit.runner.RunWith;
 
@RunWith(JUnit5.class)
@Packages({ "org.codefx.demo.junit5" })
public class TestWithJUnit5 { }

注意，该类必须是常规的JUnit 4测试类，即，它必须遵守通用的命名约定，并且必须是公共的。 @ Packages-annotation将包解释为层次结构，因此它将在所有以org.codefx.demo.junit5为前缀的包中运行所有测试。 如果愿意，可以直接在JUnit 5测试类上使用相同的运行器。 在这种情况下，它们必须是公开的。

现在我们完成了！ 您最喜欢的IDE和构建工具将愉快地运行带有@RunWith（JUnit5.class）注释的类，从而运行新的JUnit 5测试。

在真正的JUnit 5支持出现之前，某些功能可能无法使用，例如，IDE将无法运行单独的测试方法。 但是暂时我发现这是最简单，最不依赖工具的解决方案。

生成工具支持

JUnit团队已经在努力实现对JUnit 5的构建工具支持，即不通过JUnit 4绕道而行。基本的Gradle插件和Maven Surefire提供程序已启动并正在运行。 这两个项目都计划在某个时候移交给各自的社区。

两者都有示例项目（ Gradle和Maven ）。 有关更多详细信息，请参阅用户指南 。

命令行的胜利！

如果这一切对您来说太花哨了，请尝试console console ，它可以让您直接从命令行运行测试。 要获取它，您可以下载此ZIP 。

不幸的是它不能开箱即用 。 我不得不将上述的junit5-api和junit5-engine工件放到lib中，然后在bin中的脚本中将类路径定义编辑为CLASSPATH = $ APP_HOME / lib / *，以使其工作。

忽略其他依赖项（例如，在其他测试库上），可以按以下方式使用它：

使用junit控制台

# run all tests
junit-console -p ${path_to_compiled_test_classes} -a
# run a specific test
junit-console
	-p ${path_to_compiled_test_classes}
	org.codefx.demo.junit5.HelloWorldTest

发布时间由托马斯LETH -奥尔森在CC-BY-SA 2.0

兼容性

您可能已经注意到，JUnit 5占用了一个新的名称空间：org.junit.gen5。 这意味着当在同一项目中使用不同的JUnit版本时，不会有冲突。

实际上，一个项目可以包含并运行来自不同版本的测试而不会出现问题，这允许缓慢迁移到JUnit5。我们在研究JUnit的新体系结构时将重新讨论该主题。

通过异常与JUnit通信的测试库（如Hamcrest和AssertJ）将继续在新版本中工作。 使用Mockito和AssertJ查看完整的HelloWorldTest版本示例。

反射

对于我们的JUnit 5设置，我们在项目中包括了junit5-api，junit5-engine和junit4-runner，编写了第一个最小测试用例，并将其作为JUnit 4测试套件的一部分运行。

下一篇文章将探讨如何在JUnit 5中编写测试的基础知识。

翻译自: https://www.javacodegeeks.com/2016/02/junit-5-setup.html