JUnit5学习之三：Assertions类 (2)

assertAll方法可以将多个判断逻辑放在一起处理，只要有一个报错就会导致整体测试不通过，并且执行结果中会给出具体的失败详情：

@Test @DisplayName("批量判断(必须全部通过，否则就算失败)") void groupedAssertions() { // 将多个判断放在一起执行，只有全部通过才算通过，如果有未通过的，会有对应的提示 assertAll("单个测试方法中多个判断", () -> assertEquals(1, 1), () -> assertEquals(2, 1), () -> assertEquals(3, 1) ); }

上述代码执行结果如下：

异常断言

Assertions.assertThrows方法，用来测试Executable实例执行execute方法时是否抛出指定类型的异常；

如果execute方法执行时不抛出异常，或者抛出的异常与期望类型不一致，都会导致测试失败；

写段代码验证一下，如下，1除以0会抛出ArithmeticException异常，符合assertThrows指定的异常类型，因此测试可以通过：

@Test @DisplayName("判断抛出的异常是否是指定类型") void exceptionTesting() { // assertThrows的第二个参数是Executable， // 其execute方法执行时，如果抛出了异常，并且异常的类型是assertThrows的第一个参数(这里是ArithmeticException.class)， // 那么测试就通过了，返回值是异常的实例 Exception exception = assertThrows(ArithmeticException.class, () -> Math.floorDiv(1,0)); log.info("assertThrows通过后，返回的异常实例：{}", exception.getMessage()); }

以上是Assertions的常规用法，接下来要重点关注的就是和超时相关的测试方法；

超时相关的测试

超时测试的主要目标是验证指定代码能否在规定时间内执行完，最常用的assertTimeout方法内部实现如下图，可见被测试的代码通过ThrowingSupplier实例传入，被执行后再检查耗时是否超过规定时间，超过就调用fail方法抛AssertionFailedError异常：

assertTimeout的用法如下，期望时间是1秒，实际上Executable实例的execute用了两秒才完成，因此测试失败：

@Test @DisplayName("在指定时间内完成测试") void timeoutExceeded() { // 指定时间是1秒，实际执行用了2秒 assertTimeout(ofSeconds(1), () -> { try{ Thread.sleep(2000); } catch (InterruptedException e) { e.printStackTrace(); } }); }

执行结果如下图：

3. 上面的演示中，assertTimeout的第二个入参类型是Executable，此外还有另一个assertTimeout方法，其第二个入参是ThrowingSupplier类型，该类型入参的get方法必须要有返回值，假设是XXX，而assertTimeout就拿这个XXX作为它自己的返回值，使用方法如下：

@Test @DisplayName("在指定时间内完成测试") void timeoutNotExceededWithResult() { // 准备ThrowingSupplier类型的实例， // 里面的get方法sleep了1秒钟，然后返回一个字符串 ThrowingSupplier<String> supplier = () -> { try{ Thread.sleep(1000); } catch (InterruptedException e) { e.printStackTrace(); } return "我是ThrowingSupplier的get方法的返回值"; }; // 指定时间是2秒，实际上ThrowingSupplier的get方法只用了1秒 String actualResult = assertTimeout(ofSeconds(2), supplier); log.info("assertTimeout的返回值：{}", actualResult); }

上述代码执行结果如下，测试通过并且ThrowingSupplier实例的get方法的返回值也被打印出来：

4. 刚才咱们看过了assertTimeout的内部实现代码，是将入参Executable的execute方法执行完成后，再检查execute方法的耗时是否超过预期，这种方法的弊端是必须等待execute方法执行完成才知道是否超时，assertTimeoutPreemptively方法也是用来检测代码执行是否超时的，但是避免了assertTimeout的必须等待execute执行完成的弊端，避免的方法是用一个新的线程来执行execute方法，下面是assertTimeoutPreemptively的源码：

public static void assertTimeoutPreemptively(Duration timeout, Executable executable) { AssertTimeout.assertTimeoutPreemptively(timeout, executable); }