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

概述

在本快速导航中，我们主要来聊聊的 AssertJ 的异常（exception）断言。

有关 AssertJ 的项目，请访问 AssertJ / Fluent assertions for java 页面。

不使用 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()

从断言中将异常分离

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

分离的办法就是添加一个 when 和 then 逻辑段：

        // 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 进行是如何进行异常断言的。