Bootstrap

Spring Boot 3.4 中 MockMvcTester 的新特性解析

d2b5ca33bd20250125113843

引言

在 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,让测试代码更简洁、更优雅!

;