Spring Boot 3.4 中 MockMvcTester 的新特性解析

引言

在 Spring Boot 3.4 版本中，引入了一个全新的 MockMvcTester 类，使 MockMvc 测试可以直接支持 AssertJ 断言。本文将深入探讨这一新特性，分析它如何优化 MockMvc 测试并提升测试的可读性。

Spring MVC 示例

为了演示 MockMvcTester 的实际应用，我们首先创建一个基础的 Spring MVC 控制器，提供一个 /hello 端点。

通常情况下，Spring 开发者在测试中选择 AssertJ 来编写断言，但在 MockMvc 测试中，我们必须使用 Hamcrest 进行匹配。

例如：

mockMvc.perform(get("/hello")).andExpect(status().isOk()).andExpect(content().string(containsString("Hello")));

然而，在 MockMvc 断言中使用 AssertJ 可能会更直观和流畅。

MockMvcTester 是如何工作的？

从 Spring Boot 3.4 开始，MockMvcTester 被自动配置并提供了流畅的 API，使我们能够直接使用 AssertJ 进行断言。

MockMvcTester 构建在 MockMvc 之上，允许我们编写更简洁的测试代码，例如：

mockMvcTester.get("/hello").execute().assertThat(response -> response.status().isOk().content().string().contains("Hello"));

这样，我们可以将 MockMvc 结果直接包装在标准的 assertThat() 方法中，提升测试的可读性和可维护性。

MockMvcTester 相较于 MockMvc 的优势

MockMvcTester 相较于 MockMvc 主要有以下几个优势：

• 简化 API 调用：无需为 AssertJ 断言使用静态导入，所有请求和断言均可通过流畅 API 构建。
• 异常处理优化：未解决的异常会被一致处理，测试代码不再需要显式抛出或捕获 Exception。
• 异步处理更友好：默认情况下，MockMvcTester 断言的结果无论是同步还是异步，都会完整返回，无需额外处理。
• 兼容原始 MockMvc API：可以在现有 MockMvc API 基础上集成 MockMvcTester，增强测试能力。

结论

Spring Boot 3.4 对 MockMvc 测试的增强，使得偏好 AssertJ 的开发者能够更统一地编写测试代码。通过 AssertJ 提供的流畅断言，控制器测试的可读性和可维护性均得到了显著提升。如果你正在使用 Spring Boot 进行测试，不妨尝试 MockMvcTester，让测试代码更简洁、更优雅！