关于Maven依赖项设置的JUnit5文档的澄清

Question

JUnit5页面要求将澄清问题发布在StackOverflow上，所以就在这里。

用户指南说JUnit 5=JUnit Platform JUnit Jupiter JUnit Vintage，JUnit Platform是“启动测试框架的基础”。所以JUnit平台听起来很重要。

它还说，“要了解哪些工件可供下载并包含在项目中，请参阅依赖元数据。”当您访问时，请参阅关于JUnit平台的信息，10.1.1.JUnit Platform，组ID:org.JUnit。平台，版本：1.6.2首先列出。所以这听起来像是你必须把它包括在你的依赖中。

然而，用户指南也建议去建立支持。在那里，Maven指令推荐包含< code > Maven-surefire-plugin 、< code > Maven-fail safe-plugin 、< code>junit-jupiter-api和< code > JUnit-Jupiter-engine 。

用户指南还建议查看示例项目。在这里，Maven示例只包含工件< code>junit-jupiter。

所以我的问题是：遵循哪个建议？实际的指示是什么？

对于普通的最终用户来说，似乎最好的选择是遵循示例项目。然而，它显示为用户指南页面中的最后一个建议，并且似乎与之前的解释相矛盾。这会产生一些不必要的猜测，我建议简化用户指南的这部分，以便更直接地。

Answer 1

您可以使用 junit-jupiter，这是一个模块，它将包括 junit-jupiter-api 和 junit-jupiter-engine。

/**
 * Aggregates all JUnit Jupiter modules.
 *
 * @since 5.4
 */
module org.junit.jupiter {
    requires transitive org.junit.jupiter.api;
    requires transitive org.junit.jupiter.engine;
    requires transitive org.junit.jupiter.params;
}

这个pom看起来可以开始了(在这里找到)，链接来自:

对于Maven，请查看junit5-jupiter-starter-maven项目。

xml prettyprint-override"><?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>junit5-jupiter-starter-maven</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>${maven.compiler.source}</maven.compiler.target>
        <junit.jupiter.version>5.6.2</junit.jupiter.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>${junit.jupiter.version}</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
            </plugin>
            <plugin>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.22.2</version>
            </plugin>
        </plugins>
    </build>

</project>

所以:

1. 创建pom.xml如上
2. 在src/test/java/org/example/MyExampleTest.java中创建测试类：

package org.example;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class MyExampleTest {

  @Test
  void thisFailsTest() {
    fail(); //start here
  }

}

[INFO] --- maven-surefire-plugin:2.22.2:test (default-test) @ junit5-jupiter-starter-maven ---
[INFO] 
[INFO] -------------------------------------------------------
[INFO]  T E S T S
[INFO] -------------------------------------------------------
[INFO] Running org.example.MyExampleTest
[ERROR] Tests run: 1, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.017 s <<< FAILURE! - in org.example.MyExampleTest
[ERROR] thisFailsTest  Time elapsed: 0.014 s  <<< FAILURE!
org.opentest4j.AssertionFailedError: 
    at org.example.MyExampleTest.thisFailsTest(MyExampleTest.java:10)

[INFO] 
[INFO] Results:
[INFO] 
[ERROR] Failures: 
[ERROR]   MyExampleTest.thisFailsTest:10
[INFO] 
[ERROR] Tests run: 1, Failures: 1, Errors: 0, Skipped: 0
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------