文
章
目
录
章
目
录
在JUnit 5中,要编写预期会抛出异常的测试代码,我们应该使用Assertions.assertThrows()
。以下测试预期将抛出ApplicationException
或其子类型的异常。
@Test
void testExpectedException() {
ApplicationException thrown = Assertions.assertThrows(ApplicationException.class, () -> {
//测试代码
});
Assertions.assertEquals("some message", thrown.getMessage());
}
请注意,在JUnit 4中,我们需要使用@Test(expected = NullPointerException.class)
语法。
1.Assertions.assertThrows()API
1.1 语法
assertThrows()
方法断言提供的可执行块或lambda表达式将抛出预期类型的异常。
static <T extends Throwable>T assertThrows(Class<T> expectedType, Executable executable)
static <T extends Throwable>T assertThrows(Class<T> expectedType, Executable executable, String message)
static <T extends Throwable>T assertThrows(Class<T> expectedType, Executable executable, Supplier<String> messageSupplier)
这是一个重载方法,需要以下参数:
expectedType
:测试代码预期抛出的异常类型。message
:如果可执行代码没有抛出任何异常,此消息将与FAIL结果一起打印。messageSupplier
:在测试失败时从中检索消息。
1.2.匹配异常类型
assertThrows()
将失败的情况如下:
- 可执行块没有抛出任何异常
- 抛出了与预期类型不同的异常
assertThrows()
将通过的情况如下:
- 代码块抛出了指定类型或其子类型的异常。例如,如果我们期望
IllegalArgumentException
,而测试抛出了NumberFormatException
,那么测试也将通过,因为NumberFormatException
扩展了IllegalArgumentException
类。
注意,如果我们传递Exception.class
作为预期的异常类型,可执行块中抛出的任何异常都将使断言通过,因为Exception
是所有异常的超类型。
2.Demo – 预期抛出异常
下面的测试是一个非常简单的测试,它期望在执行提供的代码块时抛出NumberFormatException
。
// 两个测试都将通过
@Test
void testExpectedException() {
NumberFormatException thrown = Assertions.assertThrows(NumberFormatException.class, () -> {
Integer.parseInt("One");
}, "NumberFormatException was expected");
Assertions.assertEquals("For input string: \"One\"", thrown.getMessage());
}
@Test
void testExpectedExceptionWithParentType() {
Assertions.assertThrows(IllegalArgumentException.class, () -> {
Integer.parseInt("One");
});
}
- 在
testExpectedException
中,可执行代码是Integer.parseInt("One")
,如果方法参数不是有效的数字,则该代码会抛出NumberFormatException
。assertThrows()
方法期望捕获到这个异常,因此测试结果是PASS。 - 在
testExpectedExceptionWithParentType
中,我们执行相同的代码,但这次我们期望的是IllegalArgumentException
,它是NumberFormatException
的父类。这个测试也会通过。
3.Demo – 抛出了不同类型的异常,或者没有抛出异常
如果可执行代码抛出了任何其他类型的异常,那么测试将失败。即使可执行代码没有抛出任何异常,测试也会失败。
例如,在下面这个示例中,”1″是一个有效的数字,所以不会抛出任何异常。这个测试将以控制台中的消息失败。
@Test
void testExpectedExceptionFail() {
NumberFormatException thrown = Assertions
.assertThrows(NumberFormatException.class, () -> {
Integer.parseInt("1");
}, "NumberFormatException error was expected");
Assertions.assertEquals("Some expected message", thrown.getMessage());
}
在这篇文章中,我们学习了如何编写一个测试来期望抛出异常。这些测试有助于测试catch块中编写的代码。