junit5 新特性与使用

一、摘要说明

    本JUnit 5教程讲解了如何使JUnit 5改编成java 8编码风格和其他几个特性。了解JUnit5与JUnit 3或4的不同之处。
    JUnit 5是Java应用程序中使用最广泛的测试框架。 很久以来，JUnit一直在做得很好。 在之间，JDK 8在java中引起了非常令人兴奋的功能，最引人注目的是lambda表达式。 JUnit 5旨在适应java 8风格的编码和几个其他功能，这就是为什么需要java 8在JUnit 5中创建和执行测试（尽管可以执行用JUnit 3或JUnit 4编写的测试用于向下兼容）。
    本文将讲解以下内容:

1. 架构体系
2. 环境搭建
3. 注解
4. 编写动态测试
5. 测试套件
6. 断言
7. 假设
8. 向下兼容性
9. 回顾总结

二、JUnit 5架构体系

  与JUnit 4不同，JUnit 5不再是单个库，而是模块化结构的集合，JUnit 5由三个不同的子项目组成

JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage

1.JUnit Platform
JUnit平台作为在JVM上启动测试框架的基础。 它还定义了用于开发在平台上运行的测试框架的TestEngine API。 此外，该平台提供了一个控制台启动器，从命令行启动平台，为Gradle和Maven构建插件以及基于JUnit 4的Runner，用于在平台上运行任何TestEngine。
2.JUnit Jupiter
JUnit Jupiter是用于在JUnit 5中编写测试和扩展的新编程模型和扩展模型的组合.Jupiter子项目提供了一个用于在平台上运行基于Jupiter的测试的TestEngine。
3.JUnit Vintage
JUnit Vintage提供了一个用于在平台上运行JUnit 3和JUnit 4的测试的TestEngine。

三、环境搭建

引入2个最基础的依赖（即Jupiter引擎依赖关系和平台运行程序依赖关系）在您的maven或gradle项目中使用JUnit 5。

//pom.xml

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

//build.gradle

testRuntime("org.junit.jupiter:junit-jupiter-engine:5.0.0-M4")
testRuntime("org.junit.platform:junit-platform-runner:1.0.0-M4")

如果有疑问，请参照官方的build.gradle和pom.xml：

四、JUnit 5注解

JUnit 5提供了以下注释来编写测试。
ANNOTATION    DESCRIPTION
@BeforeEach    注释方法将在测试类中的每个测试方法之前运行。
@AfterEach    注释方法将在测试类中的每个测试方法之后运行。
@BeforeAll    注释方法将在测试类中的所有测试方法之前运行。 此方法必须是静态的。
@AfterAll    注释方法将在测试类中的所有测试方法之后运行。 此方法必须是静态的。
@Test    它用于将方法标记为junit测试
@DisplayName    用于为测试类或测试方法提供任何自定义显示名称
@Disable    它用于禁用或忽略来自测试套件的测试类或方法。
@Nested    用于创建嵌套测试类
@Tag    使用用于测试发现和过滤的标签来标记测试方法或测试类
@TestFactory    标记方法是动态测试的测试工厂

五、使用JUnit 5中编写动态测试

JUnit 4和JUnit 5在测试写作风格中没有太大变化。 这里是他们的生命周期方法的样本测试。

import org.junit.jupiter.api.AfterAll;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Disabled;
import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;
 
import com.howtodoinjava.junit5.examples.Calculator;
 
public class AppTest {
     
    @BeforeAll
    static void setup(){
        System.out.println("@BeforeAll executed");
    }
     
    @BeforeEach
    void setupThis(){
        System.out.println("@BeforeEach executed");
    }
     
    @Tag("DEV")
    @Test
    void testCalcOne() 
    {
        System.out.println("======TEST ONE EXECUTED=======");
        Assertions.assertEquals( 4 , Calculator.add(2, 2));
    }
     
    @Tag("PROD")
    @Disabled
    @Test
    void testCalcTwo() 
    {
        System.out.println("======TEST TWO EXECUTED=======");
        Assertions.assertEquals( 6 , Calculator.add(2, 4));
    }
     
    @AfterEach
    void tearThis(){
        System.out.println("@AfterEach executed");
    }
     
    @AfterAll
    static void tear(){
        System.out.println("@AfterAll executed");
    }
}

六、测试套件

使用JUnit 5测试套件，您可以将测试扩展到多个测试类和不同的软件包。 JUnit 5提供了两个注解：@SelectPackages和@SelectClasses来创建测试套件。
要执行该套件，您将使用@RunWith（JUnitPlatform.class）。

​​​​​​​@RunWith(JUnitPlatform.class)
@SelectPackages("com.howtodoinjava.junit5.examples")
public class JUnit5TestSuiteExample 
{
}

此外，您可以使用以下注解来过滤测试包，类甚至测试方法。
1.@IncludePackages 和 @ExcludePackages 过滤测试包
2.@IncludeClassNamePatterns 和 @ExcludeClassNamePatterns 过滤测试类
3.@IncludeTags 和 @ExcludeTags 过滤测试方法

@RunWith(JUnitPlatform.class)
@SelectPackages("com.howtodoinjava.junit5.examples")
@IncludePackages("com.howtodoinjava.junit5.examples.packageC")
@ExcludeTags("PROD")
public class JUnit5TestSuiteExample 
{
}

七、Junit5中的断言

  断言有助于使用测试用例的实际输出验证预期输出。 为了保持简单，所有JUnit Jupiter断言是org.junit.jupiter.Assertions类中的静态方法，例如 assertEquals（），assertNotEquals（）。

void testCase() 
{
    //Test will pass
    Assertions.assertNotEquals(3, Calculator.add(2, 2));
      
    //Test will fail 
    Assertions.assertNotEquals(4, Calculator.add(2, 2), "Calculator.add(2, 2) test failed");
      
    //Test will fail 
    Supplier<String> messageSupplier  = ()-> "Calculator.add(2, 2) test failed";
    Assertions.assertNotEquals(4, Calculator.add(2, 2), messageSupplier);
}

八、假设

    Assumptions类提供了静态方法来支持基于假设的条件测试执行。 失败的假设导致测试被中止。 无论何时继续执行给定的测试方法没有意义，通常使用假设。 在测试报告中，这些测试将被标记为已通过。
    JUnit jupiter Assumptions类有两个这样的方法：putsFalse（），putsTrue（）。

public class AppTest {
    @Test
    void testOnDev() 
    {
        System.setProperty("ENV", "DEV");
        Assumptions.assumeTrue("DEV".equals(System.getProperty("ENV")), AppTest::message);
    }
      
    @Test
    void testOnProd() 
    {
        System.setProperty("ENV", "PROD");
        Assumptions.assumeFalse("DEV".equals(System.getProperty("ENV")));  
    }
      
    private static String message () {
        return "TEST Execution Failed :: ";
    }
}

九、兼容性

JUnit 3或JUnit 4的向下兼容性

JUnit 4已经在这里了很长时间，并且有许多测试以junit 4写成.JUnit Jupiter还需要支持这些测试。 为此，开发了JUnit Vintage子项目。

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

十、总结

    JUnit 5还在开发中。 看起来如此令人兴奋，功能丰富。 而现在它被第三方工具和API扩展开放。 作为测试作者，您可能不会觉得有什么不同，但是当您要扩展或尝试开发任何IDE插件时，您会赞美它。

    作为开发人员，您还可以考虑将测试模板添加到eclipse IDE中以提高开发速度。

Java编程 junit5

http://blog.xqlee.com/article/225.html