乐趣区

关于java:咱的Maven项目能用Junit5吗

jiezi

1. 简介

不同于 JUnit3 或者 JUnit4，JUnit 5 由多个模块组成，并三个外围的子项目：

JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage

查看一下官网 go JUnit5，下面有最新版本显示：

这版本号能够帮忙咱们填写上面的依赖 junit-platform-launcher AND junit-jupiter-engine AND junit-vintage-engine：

<dependencies>

    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-launcher</artifactId>
        <version>1.7.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.7.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.vintage</groupId>
        <artifactId>junit-vintage-engine</artifactId>
        <version>5.7.1</version>
        <scope>test</scope>
    </dependency>
</dependencies>

为了 mvn test 顺利执行 Junit5 测试用例，那么你须要 Maven 插件 maven-surefire-plugin:

<plugins>
    <plugin>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>2.22.2</version>
    </plugin>
</plugins>

2. 思考

这三个子项目，咱们每次都须要引入吗？

  • 答案： 不是的，理论还是须要因我的项目需要而异的。

3. 利用场景

首先我的项目必须 JDK8+

JUnit 5 requires Java 8 (or higher) at runtime.

  • 也就是说须要 JDK8+ 的我的项目能力用 JUnit5，否则老老实实选用 JUnit4 吧。

3.1 新我的项目用 JUnit5

如果，咱们是一个新开的我的项目，须要应用 Junit5，怎么选？

  • 答案：只须要引入 junit-jupiter-engine 即可。
<?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>

        <junit5.version>5.7.1</junit5.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>${junit5.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>

3.2 迁徙至 JUnit5

如果，咱们的我的项目是一个旧我的项目，用的是 JDK8 + JUnit4，当初新的测试用例想要用 JUnit5 来写，怎么办？

  • 答案：引入 junit-jupiter-engine AND junit-vintage-engine。原先的依赖 junit 能够思考移除，因为 junit-vintage-engine 会为咱们主动引入可传递依赖项 junit
<?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-migration-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>

        <junit5.version>5.7.1</junit5.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>${junit5.version}</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
            <version>${junit5.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>

4. 解读

要开始应用 JUnit5 Platform，您至多须要向我的项目中增加一个 TestEngine 实现。

junit-jupiter-engine 我的项目蕴含实现类 JupiterTestEngine，junit-vintage-engine 我的项目蕴含实现类 VintageTestEngine。

如果您想用 Jupiter 编写测试，请将测试件 junit-jupiter-engine 增加到 POM 中的依赖项中。这将引入所有必须的依赖项。在这些依赖关系中，就有 junit-jupiter-api，它蕴含测试源代码编译所需的类和接口。

咱们通常应用的 @Test，@Disabled 等注解，Assertions 等断言 API 都出自 junit-jupiter-api。

咱们在我的项目中引入依赖 junit-jupiter-engine 时，Maven 就会主动替咱们引入 junit-jupiter-api。

如果您想通过 JUnit 平台编写和执行 JUnit3 或 4 测试，请将 junit-vintage-engine 增加到依赖项中，该引擎可传递地引入（并须要）junit:junit:4.12

引入依赖 junit-vintage-engine 时，Maven 就会主动替咱们引入 junit

5. 为啥没用到 junit-platform-launcher？

IntelliJ IDEA 在 IDEA 2017.3 之前公布了 JUnit 5 的特定捆绑包版本。因而，如果您想应用较新版本的 Junit Jupiter，IDE 中的测试执行可能会因为版本抵触而失败。在这种状况下，请依照上面的阐明应用比 IntelliJ IDEA 捆绑的 JUnit 5 更新的版本。

junit-platform-launcher 更多的是服务于 IDE 的，如果呈现了版本抵触引起的测试执行失败，就须要增加，反之我感觉不怎么须要呢？

因而，加或者不加这个 junit-platform-launcher 依赖都有肯定的合理性。集体没有遇过这类问题，所以临时不加。

6. 参考文档

  • User Guide
  • Maven JUnitPlatform Support
  • junit5-jupiter-starter-maven
  • junit5-migration-maven
  • IDE AND junit-platform-launcher
退出移动版