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

@RequestBody

您可以使用 @RequestBody 注解来读取和反序列化请求体为一个 对象 通过一个 转换器。 以下示例使用了一个 参数spring-doc.cadn.net.cn

@PostMapping("/accounts")
public void handle(@RequestBody Account account) {
	// ...
}
@PostMapping("/accounts")
fun handle(@RequestBody account: Account) {
	// ...
}

您可以使用消息转换器选项来配置或自定义消息转换。spring-doc.cadn.net.cn

您可以使用 @RequestBody 结合 jakarta.validation.Valid 或 Spring 的 @Validated 注解,这两种方式都会导致 Standard Bean Validation 被应用。默认情况下,验证错误会导致 MethodArgumentNotValidException,这会被转换为 400 (BAD_REQUEST) 响应。或者,您也可以在控制器中通过 ErrorsBindingResult 参数本地处理验证错误,如下例所示:spring-doc.cadn.net.cn

@PostMapping("/accounts")
public void handle(@Valid @RequestBody Account account, BindingResult result) {
	// ...
}
@PostMapping("/accounts")
fun handle(@Valid @RequestBody account: Account, result: BindingResult) {
	// ...
}