Spring Boot 3.4 中 MockMvcTester 的新特性解析

救救孩子把2025-02-10 17:50

引言

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

Spring MVC 示例

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

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

例如：

java 复制代码

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

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

MockMvcTester 是如何工作的？

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

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

java 复制代码

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，让测试代码更简洁、更优雅！