对于最新稳定版本,请使用 Spring Framework 7.0.6spring-doc.cadn.net.cn

异步请求

本节展示了如何单独使用 MockMvc 来测试异步请求处理。 如果通过 WebTestClient 使用 MockMvc,则无需进行任何特殊操作即可使异步请求正常工作,因为 WebTestClient 会自动执行本节所描述的操作。spring-doc.cadn.net.cn

Servlet 异步请求(Spring MVC 中支持的功能)的工作原理是退出 Servlet 容器线程,允许应用程序异步计算响应,之后再通过一次异步分派(async dispatch)回到 Servlet 容器线程以完成处理。spring-doc.cadn.net.cn

在 Spring MVC Test 中,可以通过先断言生成的异步值,然后手动执行异步分发,最后验证响应来测试异步请求。 以下是一个针对返回 DeferredResultCallable 或响应式类型(例如 Reactor 的 Mono)的控制器方法的测试示例:spring-doc.cadn.net.cn

// static import of MockMvcRequestBuilders.* and MockMvcResultMatchers.*

@Test
void test() throws Exception {
       MvcResult mvcResult = this.mockMvc.perform(get("/path"))
               .andExpect(status().isOk()) (1)
               .andExpect(request().asyncStarted()) (2)
               .andExpect(request().asyncResult("body")) (3)
               .andReturn();

       this.mockMvc.perform(asyncDispatch(mvcResult)) (4)
               .andExpect(status().isOk()) (5)
               .andExpect(content().string("body"));
   }
1 检查响应状态是否仍然未更改
2 异步处理必须已启动
3 等待并断言异步结果
4 手动执行一次异步分发(因为没有正在运行的容器)
5 验证最终响应
@Test
fun test() {
	var mvcResult = mockMvc.get("/path").andExpect {
		status { isOk() } (1)
		request { asyncStarted() } (2)
		// TODO Remove unused generic parameter
		request { asyncResult<Nothing>("body") } (3)
	}.andReturn()


	mockMvc.perform(asyncDispatch(mvcResult)) (4)
			.andExpect {
				status { isOk() } (5)
				content().string("body")
			}
}
1 检查响应状态是否仍然未更改
2 异步处理必须已启动
3 等待并断言异步结果
4 手动执行一次异步分发(因为没有正在运行的容器)
5 验证最终响应