AssertJ 的异常(Exception )断言
本页面主要来说说 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 进行是如何进行异常断言的。