JUnit 5 简介

著名的Java单元测试框架Junit 4已经出来很长时间了，当时我发现JUnit 5已经处于测试版，就准备写文章来介绍JUnit 5.不过因为还是测试版，所以有些地方还不太完善，我也有点懒没有好好写。这几天突然想起这事了，在到官网上查看，发现就在9月10日，JUnit 5的正式版终于出来了！那么我就正好把文章重新好好写写，为大家介绍这个最新的JUnit框架。

框架结构

和JUnit 4相比，JUnit 5的结构非常清晰，为自定义插件、IDE测试执行等扩展功能做了很好的支持。这一点从项目结构就可以看出来。

JUnit Platform

这一组的包名是org.junit.platform，从名字就可以看到，这一组的主要功能就是作为测试框架的基础平台。这个包下的模块包含基础API、执行引擎及执行器、基本的命令行执行功能、命令行界面、Maven及Gradle的测试插件等最基本的功能。

JUnit Jupiter

Jupiter 是JUnit 5的代号，这个包下的模块包含JUnit 5的主要功能。如果我们要使用JUnit 5，那么必然要包含这一组模块。

JUnit Vintage

Vintage 是旧版本JUnit 的代号，这个包下的模块可以让我们在新的JUnit平台上运行旧的JUnit 3 和 4 的测试。

导入类库

在JUnit 5还在测试阶段的时候，官方文档上还有在Maven和Gradle中集成JUnit 5的例子。但是到了正式版，这一部分的内容消失了，仅仅留下两个示例项目的链接，让我们自己参考（复制粘贴）。

使用Maven

junit5-maven-consumer 是官方的Maven例子。本来我准备把相关的POM配置贴到这里，但是一看Maven的配置太长了，所以还是算了。如果有需求的话请自己查看这个项目的POM配置。

使用Gradle

如果用Gradle的话，那么这个问题就简单多了。在junit5-gradle-consumer 示例项目中也有比较详细的说明。

首先，Gradle默认不支持JUnit 5,，所以需要启用JUnit Platform Gradle 插件来支持。

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'org.junit.platform:junit-platform-gradle-plugin:1.0.0'
    }
}

apply plugin: 'org.junit.platform.gradle.plugin'

然后是关于这个Gradle插件的配置。默认情况下所有的引擎和标签都会被执行。如果你想选择只执行某些引擎和标签的测试，可以取消下面的注释并按照你自己的需求进行修改。当然假如你没有这些高级需求，可以把这一部分删掉。

junitPlatform {
    // platformVersion '1.0.0'
    filters {
        engines {
            // include 'junit-jupiter', 'junit-vintage'
            // exclude 'custom-engine'
        }
        tags {
            // include 'fast'
            exclude 'slow'
        }
        // includeClassNamePattern '.*Test'
    }
    // enableStandardTestTask true
    // reportsDir file('build/test-results/junit-platform') // this is the default
    // logManager 'org.apache.logging.log4j.jul.LogManager'
}

如果你只需要运行JUnit 5测试，只需要导入下面两个依赖项。JUnit Platform的依赖会自动导入。

dependencies {
    testCompile("org.junit.jupiter:junit-jupiter-api:5.0.0")
    testRuntime("org.junit.