|
此版本仍在开发中,尚未稳定。如需最新的稳定版本,请使用 Spring Framework 7.0.6! |
ResponseEntity
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 = ...
val etag = ...
return ResponseEntity.ok().eTag(etag).build(body)
}
主体内容通常会作为值对象提供,以便由注册的HttpMessageConverters之一呈现为相应的响应表示(例如,JSON)。
数字ResponseEntity<Resource>可以表示文件内容,将提供的资源的InputStream
内容复制到响应的OutputStream中。请注意,为了在复制到响应后可靠地关闭它,InputStream
应该由Resource句柄惰性获取。如果您出于此目的使用了InputStreamResource,
请确保使用按需InputStreamSource
构建它(例如,通过一个lambda表达式来获取实际的InputStream)。此外,InputStreamResource
的自定义子类仅与避免为此目的消耗流的自定义contentLength()实现结合使用时才受支持。
Spring MVC 支持使用单个值 响应式类型
以异步方式生成 ResponseEntity,以及用于正文的单值和多值响应式
类型。这允许以下类型的异步响应:
-
ResponseEntity<Mono<T>>或ResponseEntity<Flux<T>>会立即使响应状态和头信息可知,而正文会在稍后异步提供。 如果正文包含 0..1 个值,请使用Mono,如果它能生成多个值,请使用Flux。 -
Mono<ResponseEntity<T>>提供了所有三个要素——响应状态、标头和正文,并在稍后异步提供。这允许根据异步请求处理的结果来改变响应状态和标头。