ResponseEntity

查看 Servlet 栈中的等效内容

ResponseEntity 类似于 @ResponseBody，但包含状态和头信息。例如

  • Java

  • Kotlin

@GetMapping("/something")
public ResponseEntity<String> handle() {
	String body = ... ;
	String etag = ... ;
	return ResponseEntity.ok().eTag(etag).body(body);
}
@GetMapping("/something")
fun handle(): ResponseEntity<String> {
	val body: String = ...
	val etag: String = ...
	return ResponseEntity.ok().eTag(etag).build(body)
}

WebFlux 支持使用单值 reactive 类型异步生成 ResponseEntity，和/或使用单值和多值 reactive 类型作为响应体。这使得使用 ResponseEntity 可以实现多种异步响应，如下所示

  • ResponseEntity<Mono<T>> 或 ResponseEntity<Flux<T>> 使得响应状态和头信息立即可知，而响应体则在稍后异步提供。如果响应体包含 0 到 1 个值，则使用 Mono；如果它可以产生多个值，则使用 Flux。

  • Mono<ResponseEntity<T>> 在稍后异步提供所有三项内容：响应状态、头信息和响应体。这使得响应状态和头信息可以根据异步请求处理的结果而变化。

  • Mono<ResponseEntity<Mono<T>>> 或 Mono<ResponseEntity<Flux<T>>> 是另一种可能的替代方案，尽管不太常见。它们首先异步提供响应状态和头信息，然后第二次异步提供响应体。