AssertJ 的异常(Exception )断言

本页面主要来说说 AssertJ 的异常断言。

概述

在本快速导航中,我们主要来聊聊的 AssertJ 的异常(exception)断言。

有关 AssertJ 的项目,请访问 AssertJ - fluent assertions java library 页面。

不使用 AssertJ

如果不使用 AssertJ,我们需要先捕获一个异常,然后再在异常中进行断言。

例如下面的伪代码,我们捕获了一个异常,然后再进行判断。

try {
    // ...
} catch (Exception e) {
    // assertions
}

但是,如果程序在执行的时候没有抛出异常,在上面的用例中,测试将会通过。

为了让断言能够被执行,为什么我们还需要手动触发一个异常呢?

使用 AssertJ

在 Java 8 以后的版本,我们可以通过使用 AssertJ 和 lambda 表达式,非常容易的对异常进行断言处理。

使用 assertThatThrownBy() 方法

让我们看看下面的代码将会抛出 IndexOutOfBoundsException 异常:

这是因为我们定义一个 List 的长度是 2 ,但是我们有一行代码将会访问 List 的第 3 个元素,上面的代码必然会抛出一个异常。

        assertThatThrownBy(() -> {
            ArrayList<String> myStringList = new ArrayList<String>(Arrays.asList("Strine one", "String two"));
            myStringList.get(2);
        }).isInstanceOf(IndexOutOfBoundsException.class)
                .hasMessageStartingWith("Index 2");

需要注意上面的代码片段有可能会抛出一个 lambda 表达式异常。

当然,我们还可以使用 AssertJ 来提供一个链式断言,这个就是为什么我们不使用 Junit 自带断言的原因。

                .hasMessageStartingWith("Index 2")
                .hasMessageContaining("2")
                .hasMessageEndingWith("length 2")
                .hasMessageContaining("Index 2")
                .hasNoCause();

使用 assertThatExceptionOfType 方法

这个方法与上面使用的方法类似,因为我们知道这个程序执行就会抛出异常,因此我们在程序的最开始就指定了异常:

        assertThatExceptionOfType(ArithmeticException.class).isThrownBy(() -> {
                    int numerator = 10;
                    int denominator = 0;
                    int quotient = numerator / denominator;
                })
                .withMessageContaining("/ by zero");

上面的方法,因为我们使用了 0 为除数,因此必定会抛出异常。

在程序最开始的时候我们就断言了这个异常。

使用 assertThatIOException 和其他的一些常用类型

AssertJ 针对 一些常用的异常进行了包装,你可以直接使用这些被包装过的异常:

assertThatIOException().isThrownBy(() -> {
    // ...
});

和其他一些类似的异常:

  • assertThatIllegalArgumentException()
  • assertThatIllegalStateException()
  • assertThatIOException()
  • assertThatNullPointerException()

从断言中将异常分离

可选的,我们可以将异常从断言中进行分离。

分离的办法就是添加一个 whenthen 逻辑段:

        // when
        Throwable thrown = catchThrowable(() -> {
            int numerator = 10;
            int denominator = 0;
            int quotient = numerator / denominator;
        });

        // then
        assertThat(thrown).isInstanceOf(ArithmeticException.class)
                .hasMessageContaining("/ by zero");
    }

上面的代码首先是抛出异常,然后对抛出的异常再进行断言判断。

结论

在这篇短文中,我们对 AssertJ 是如何进行异常断言的情况进行了简单的介绍,同时讨论了 AssertJ 进行是如何进行异常断言的。

测试源代码

相关的测试源代码,请访问链接:

您也可以 Fork 代码后提交更新。