在同一个构建中执行JUnit 4和JUnit 5测试

时间:2017-11-07 12:56:46

标签: java maven junit4 junit5

在Maven项目中,我有一些现有的测试依赖于JUnit 4.由于多种原因,我无法在JUnit 5中迁移这些测试。
实质上,一些测试依赖于使用JUnit 4 runner的库,代码迁移可能需要一些时间。

我希望所有相同的JUnit 5都能创建新的测试类,现在已经发布,并提供了新的有趣功能 怎么做?

2 个答案:

答案 0 :(得分:27)

JUnit 5提供a way out of the box

  

JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage

每个项目都是一个独特的项目,使用它们可以在同一个项目中编译和执行JUnit 4和JUnit 5测试。

  

JUnit Jupiter 是用于在JUnit 5中编写测试和扩展的新编程模型和扩展模型的组合。

     

JUnit Vintage 提供了一个TestEngine,用于在平台上运行基于JUnit 3和JUnit 4的测试。

     

JUnit平台是在JVM上启动测试框架的基础

更新:来自Maven Surefire 2.22.0

来自the JUnit 5 documentation

  

从版本2.22.0开始,Maven Surefire提供原生支持   用于在JUnit平台上执行测试。

因此配置更加简单 请注意,junit-4 api依赖项是可选的,因为现在需要的engine依赖项已经提取了默认的api版本(junit 4和5都是这种情况)。

以下是pom.xml示例。

<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>david</groupId>
    <artifactId>jupiter-4-and-5-same-build</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <junit-jupiter.version>5.1.0</junit-jupiter.version>
        <!-- optional : if we want to use a junit4 specific version -->
        <junit.version>4.12</junit.version>
    </properties>
    <dependencies>
        <!--JUnit Jupiter Engine to depend on the JUnit5 engine and JUnit 5 API -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>${junit-jupiter.version}</version>
            <scope>test</scope>
        </dependency>
        <!--JUnit Jupiter Engine to depend on the JUnit4 engine and JUnit 4 API  -->
        <dependency>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
            <version>${junit-jupiter.version}</version>
        </dependency>
        <!-- Optional : override the JUnit 4 API version provided by junit-vintage-engine -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.22.0</version>
            </plugin>
        </plugins>
    </build>

</project>

在我的GitHub空间中,我添加了一个可以浏览/克隆的工作示例maven项目。 网址:https://github.com/ebundy/junit4-and-5-minimal-maven-project

旧方式:对于2.22.0以下的Maven Surefire

以下是与Maven一起配置项目以编译和运行JUnit4和JUnit5测试的最小配置:

<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>mygroup</groupId>
    <artifactId>minimal-conf-junit4-5</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <properties>
        <!-- JUnit 5 depends on JDK 1.8 -->
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <!--  JUnit dependency versions -->
        <junit.version>4.12</junit.version>
        <junit-vintage-engine>4.12.1</junit-vintage-engine>
        <junit-jupiter.version>5.0.1</junit-jupiter.version>
        <junit-platform.version>1.0.1</junit-platform.version>
    </properties>

    <dependencies>
        <!--JUnit Jupiter API to write and compile tests with JUnit5 -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>${junit-jupiter.version}</version>
            <scope>test</scope>
        </dependency>
        <!-- JUnit 4 to make legacy JUnit 4 tests compile -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.19.1</version> <!-- matters until now-->
                <dependencies>
                    <!-- to let surefire to run JUnit 4 but also JUnit 5 tests -->
                    <dependency>
                        <groupId>org.junit.platform</groupId>
                        <artifactId>junit-platform-surefire-provider</artifactId>
                        <version>${junit-platform.version}</version>
                    </dependency>
                    <!-- JUnit vintage engine to run JUnit 3 or JUnit 4 tests -->
                    <dependency>
                        <groupId>org.junit.vintage</groupId>
                        <artifactId>junit-vintage-engine</artifactId>
                        <version>${junit-vintage-engine}</version>
                    </dependency>
                    <!-- JUnit 5 engine to run JUnit 5 tests -->
                    <dependency>
                        <groupId>org.junit.jupiter</groupId>
                        <artifactId>junit-jupiter-engine</artifactId>
                        <version>${junit-jupiter.version}</version>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
    </build>
</project>

现在mvn test编译并运行JUnit 4和JUnit 5测试。

注1:junit-vintage-engine4.12.1)和junit4.12)依赖关系未指定相同的确切版本。
这根本不是问题:

  • 他们的发布与他们之间没有关系

  • junit-vintage-engine旨在运行任何JUnit 3 4 测试。

注2:带有2.19.1版本的maven-surefire-plugin对于编译JUnit 5测试类或JUnit 4和JUnit 5测试类都很重要。
下一版本的插件在JUnit 5测试执行期间确实会导致一些异常,但2.22.0最终解决了问题(请参阅答案的第一部分:“更新:来自Maven Surefire 2.22.0 “)。

答案 1 :(得分:0)

JUnit 在 https://github.com/junit-team/junit5-samples

有许多示例项目

我有一个 Gradle 项目,关注 https://github.com/junit-team/junit5-samples/tree/main/junit5-migration-gradle 对我有用。

https://github.com/junit-team/junit5-samples/tree/main/junit5-migration-maven 与 Maven 等效 - 我没有尝试过,但我想它也能工作。