JUnit5学习之二：Assumptions类

欢迎访问个人GitHub

https://github.com/zq2599/blog_demos

内容：全部原创文章分类汇总及配套源码，涉及Java、Docker、Kubernetes、DevOPS等；

关于《JUnit5学习》系列

《JUnit5学习》系列旨在经过实战提高SpringBoot环境下的单元测试技能，一共八篇文章，连接以下：

1. 基本操做
2. Assumptions类
3. Assertions类
4. 按条件执行
5. 标签(Tag)和自定义注解
6. 参数化测试(Parameterized Tests)基础
7. 参数化测试(Parameterized Tests)进阶
8. 综合进阶（终篇）

本篇概览

本文是《JUnit5学习》系列的第二篇，学习一个重要的知识点：Assumptions类，只有了解了它们，才好继续后面的学习，全篇章节以下：

1. Assertions和Assumptions简介
2. 写一段代码对比效果
3. Assumptions编码
4. 查看执行结果

源码下载

1. 若是您不想编码，能够在GitHub下载全部源码，地址和连接信息以下表所示：

名称	连接	备注
项目主页	https://github.com/zq2599/blog_demos	该项目在GitHub上的主页
git仓库地址(https)	https://github.com/zq2599/blog_demos.git	该项目源码的仓库地址，https协议
git仓库地址(ssh)	git@github.com:zq2599/blog_demos.git	该项目源码的仓库地址，ssh协议

2. 这个git项目中有多个文件夹，本章的应用在junitpractice文件夹下，以下图红框所示：

3. junitpractice是父子结构的工程，本篇的代码在assertassume子工程中，以下图：

Assertions和Assumptions简介

Assumptions和Assertions容易混淆，所以这里经过对比它们来学习：

1. Assertions即断言类，里面提供了不少静态方法，例如assertTrue，若是assertTrue的入参为false，就会抛出AssertionFailedError异常，Junit对抛出此异常的方法断定为失败；
2. Assumptions即假设类，里面提供了不少静态方法，例如assumeTrue，若是assumeTrue的入参为false，就会抛出TestAbortedException异常，Junit对抛出此异常的方法断定为跳过；
3. 简单的说，Assertions的方法抛出异常意味着测试不经过，Assumptions的方法抛出异常意味着测试被跳过(为何称为"跳过"？由于mvn test的执行结果被标记为Skipped)；

写一段代码对比效果

1. 用代码来验证的效果最好，以下所示，一共四个方法，assertSuccess不抛出AssertionFailedError异常，assertFail抛出AssertionFailedError异常，assumpSuccess不抛出TestAbortedException异常，assumpFail抛出TestAbortedException异常

package com.bolingcavalry.assertassume.service.impl;

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assumptions.assumeTrue;

@SpringBootTest
@Slf4j
public class AssertAssumpTest {

    /**
     * 最简单的成功用例
     */
    @Test
    void assertSuccess() {
        assertEquals(2, Math.addExact(1,1));
    }

    /**
     * 最简单的失败用例
     */
    @Test
    void assertFail() {
        assertEquals(3, Math.addExact(1,1));
    }

    /**
     * assumeTrue不抛出异常的用例
     */
    @Test
    void assumpSuccess() {
        // assumeTrue方法的入参若是为true，就不会抛出异常，后面的代码才会继续执行
        assumeTrue(true);
        // 若是打印出此日志，证实assumeTrue方法没有抛出异常
        log.info("assumpSuccess的assumeTrue执行完成");
        // 接下来是常规的单元测试逻辑
        assertEquals(2, Math.addExact(1,1));
    }

    /**
     * assumeTrue抛出异常的用例
     */
    @Test
    void assumpFail() {
        // assumeTrue方法的入参若是为false，就会抛出TestAbortedException异常，后面就不会执行了
        assumeTrue(false, "未经过assumeTrue");
        // 若是打印出此日志，证实assumpFail方法没有抛出异常
        log.info("assumpFail的assumeTrue执行完成");
        // 接下来是常规的单元测试逻辑，但由于前面抛出了异常，就再也不执行了
        assertEquals(2, Math.addExact(1,1));
    }
}

2. 点击下图红框位置执行单元测试：

3. 执行结果以下：

4. 另外，在target目录，能够看到surefire插件生成的单元测试报告TEST-com.bolingcavalry.assertassume.service.impl.AssertAssumpTest.xml，以下图所示，testcase节点中出现了skipped节点：

• 上述对比验证再次说明Assertions和Assumptions的区别：都用来对比预期值和实际值，当预期值和实际值不一致时，Assertions的测试结果是执行失败，Assumptions的测试结果是跳过(或者忽略)；

Assumptions实战

弄清楚的Assertions和Assumptions的区别，接下来趁热打铁，学习Assumptions类中几个重要的静态方法：assumeTrue、assumingThat

1. 最简单的用法以下，可见只有assumeTrue不抛出异常，后面的log.info才会执行：

@Test
    @DisplayName("最普通的assume用法")
    void tryAssumeTrue() {
        assumeTrue("CI".equals(envType));

        log.info("CI环境才会打印的assumeTrue");
    }

2. assumeTrue能够接受Supplier类型做为第二个入参，若是assumeTrue失败就会将第二个参数的内容做为失败提示：

@Test
    @DisplayName("assume失败时带自定义错误信息")
    void tryAssumeTrueWithMessage() {
        // 第二个入参是Supplier实现，返回的内容用做跳过用例时的提示信息
        assumeTrue("CI".equals(envType),
                () -> "环境不匹配而跳过，当前环境：" + envType);

        log.info("CI环境才会打印的tryAssumeTrueWithMessage");
    }

效果以下图：

3. 还有个assumingThat方法，能够接受Executable类型做为第二个入参，若是第一个入参为true就会执行Executable的execute方法，注意assumingThat方法的特色：不抛出异常，所以其所在的方法不会被跳过，这是和assumeTrue相比最大的区别(assumeTrue一旦入参为false就会抛出异常，其所在方法就被标记为跳过)：

@Test
    @DisplayName("assume成功时执行指定逻辑")
    void tryAssumingThat() {
        // 第二个入参是Executable实现，
        // 当第一个参数为true时，执行第二个参数的execute方法
        assumingThat("CI".equals(envType),
                () -> {
                    log.info("这一行内容只有在CI环境才会打印");
                });

        log.info("不管什么环境都会打印的tryAssumingThat");
    }

• 接下来我们执行上述代码，看看效果；

执行Assumptions代码

1. 先作准备工做，本次实战的springboot工程名为assertassume，我们在工程的resources目录下添加两个配置文件：application.properties和application-test.properties，位置以下图：

2. application-test.properties内容以下：

envType:CI

3. application.properties内容以下：

envType:PRODUCTION

4. 完整的单元测试类以下，经过注解ActiveProfiles，指定了使用application-test.properties的配置，所以envType的值为CI：

package com.bolingcavalry.assertassume.service.impl;

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.ActiveProfiles;
import static org.junit.jupiter.api.Assumptions.assumeTrue;
import static org.junit.jupiter.api.Assumptions.assumingThat;

@SpringBootTest
@Slf4j
@ActiveProfiles("test")
public class AssumptionsTest {

    @Value("${envType}")
    private String envType;

    @Test
    @DisplayName("最普通的assume用法")
    void tryAssumeTrue() {
        assumeTrue("CI".equals(envType));

        log.info("CI环境才会打印的assumeTrue");
    }

    @Test
    @DisplayName("assume失败时带自定义错误信息")
    void tryAssumeTrueWithMessage() {
        // 第二个入参是Supplier实现，返回的内容用做跳过用例时的提示信息
        assumeTrue("CI".equals(envType),
                () -> "环境不匹配而跳过，当前环境：" + envType);

        log.info("CI环境才会打印的tryAssumeTrueWithMessage");
    }

    @Test
    @DisplayName("assume成功时执行指定逻辑")
    void tryAssumingThat() {
        // 第二个入参是Executable实现，
        // 当第一个参数为true时，执行第二个参数的execute方法
        assumingThat("CI".equals(envType),
                () -> {
                    log.info("这一行内容只有在CI环境才会打印");
                });

        log.info("不管什么环境都会打印的tryAssumingThat");
    }
}

5. 执行结果以下图，可见assume经过，全部信息都被打印出来了：

6. 接下来把代码中的ActiveProfiles注解那一行注释掉，以下图红框：

7. 执行结果以下，可见tryAssumingThat方法被标记为成功，不过从日志可见assumingThat的第二个入参executable没有被执行：

• 至此，Assumptions类的经常使用方法体验完成，接下来的章节会继续学习其余经常使用类；

你不孤单，欣宸原创一路相伴

1. Java系列
2. Spring系列
3. Docker系列
4. kubernetes系列
5. 数据库+中间件系列
6. DevOps系列

欢迎关注公众号：程序员欣宸

微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界...
https://github.com/zq2599/blog_demos