JUnit5 快速入门指南

1. 安装

在pom中添加依赖

<properties>
  <junit.jupiter.version>5.3.2</junit.jupiter.version>
</properties>

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

2. JUnit5 构成结构

JUnit Platform：jvm上启动测试框架的基础，定义了测试引擎的API，可以在cmd命令行启动这个平台

JUnit Jupiter：新编程模块和扩展模块在junit5上写测试和扩展的组合，Jupiter子工程提供在平台上跑Jupiter的测试引擎。

JUnit Vintage：提供跑junit3和junit4的测试引擎 jdk8 以上

3. JUnit5 注解

@BeforeAll 当前类中的所有测试方法之前执行 通【BeforeClass（junit4）】

@BeforeEach 初始化方法 通【Before（junit4）】

@Test 测试方法，在这里可以测试期望异常和超时时间

@AfterEach 释放资源，每种测试方法后执行 通【After （junit4）】

@AfterAll 在当前类中的所有测试方法之后执行 通【AfterClass （junit4）】

@DisplayName 注解测试方法

@Nested 依赖嵌套单元测试

@disable 禁用测试方法

@RepeatedTest(5) 重复测试

@RunWith(JUnitPlatform.class) 套件测试

@SelectPackages({"com.packageA" , "com.packageB"})

@IricludePackages("包名")

@SelectClasses( { xx.class,xxx.class,xxxx.class } )

@IncludeTags("production")

@ExcludeTags("PROD")

@ParameterizedTest 参数化

4. JUnit5 编写单元测试

4.1. 基本的单元测试类和方法

junit5执行顺序，以及基本的单元测试类 ，disable禁用注解

@DisplayName("junit5执行顺序")
public class junit5Demo1 {
    @BeforeAll
    static void beforeAll(){
        System.out.println("beforeAll---执行前");
    }
    @BeforeEach
    void beforeEach() {
        System.out.println("beforeEach");
    }
    @AfterEach
    void afterEach() {
        System.out.println("afterEach");
    }
    @DisplayName("fun 测试方法")
    void fun() {
        System.out.println("测试方法~1");
    }
    @Test
    @Disabled  //执行时，跳过此方法
    @DisplayName("fun1 测试方法")
    void skippedTest() {
        System.out.println("忽略测试方法~2");
    }
    @AfterAll
    static void afterAll() {
        System.out.println("afterAll");
    }
}

4.2. 断言

public class junit5DemoAssert {
    @Test
    @DisplayName("断言是否相等")
    void addTest(){
        int result= Calculator.add(1,1);
        System.out.println("1+1等于"+result);
        assertEquals(3,result);
    }

    @Test
    @DisplayName("断言是否不相等")
    void addTest1(){
        int result= Calculator.add(1,1);
        System.out.println("1+1等于"+result);
        assertNotEquals(3,result);
    }
    @Test
    @DisplayName("断言是否为空")
    void addTest2(){
        int result= Calculator.add(1,1);
        System.out.println("1+1等于"+result);
        assertNotEquals(3,result);
    }
    //查看两个对象的引用是否相等。类似于使用“=="比较两个对象
    @Test
    @DisplayName("断言两个值是否相等")
    void quasls(){
        int a=123;
        int b=123;
        System.out.println("断言int类型");
        assertSame(a,b);
        String s1="123";
        String s2="123";
        String s3 = new String("123");
        System.out.println("断言string类型");
        assertSame(s1,s2);
        System.out.println("断言string类型");
        assertSame(s1,s3);
    }   

}

4.3 重复执行

public class Junit5DemoNest {
    @DisplayName("重复执行")
    @RepeatedTest(value = 3,name = "{displayName},执行第{currentRepetition}次}")
    void repetition(){
        System.out.println("重复执行执行");
    } 

4.4 顺序执行

public class Junit5DemoNest {
    @Nested
    @DisplayName("第二个执行")
    class TWO{
        @Test
        void putINTWO(){
            System.out.println("放入第二个箱子");
        }
    }
    //分组执行是从代码最后往前走
    @Nested
    @DisplayName("第一次执行")
    class One{
        @Test
        void putInONE(){
            System.out.println("放入第一个箱子");
        }
    }
}