spring-webmvc @RequestBody 典型用法

典型用法

接收 JSON 请求体并转换为 Java 对象

@PostMapping("/users")
public String createUser(@RequestBody User user) {return "User created: " + user.getName();
}// 客户端请求示例（JSON）：{"name": "Alice","email": "alice@example.com"}
// Spring 自动使用 HttpMessageConverter（如 Jackson）将 JSON 转换为 User 对象。

接收原始 JSON 字符串（String 类型）

如果你不想立即反序列化对象，也可以直接接收原始 JSON，适用于需要手动解析或转发的场景。

@PostMapping("/data")
public String receiveJson(@RequestBody String rawJson) {return "Received JSON: " + rawJson;
}

接收 Map 结构（灵活处理动态字段）

当请求结构不确定时，可以使用 Map 接收数据

@PostMapping("/map")
public String handleMap(@RequestBody Map<String, Object> data) {return "Received name: " + data.get("name");
}// 请求示例：{"name": "Bob","age": 30}

结合 @Valid 进行参数校验

你可以配合 @Valid 注解对请求体进行校验,需要在 User 类中添加 JSR 380 校验注解（如 @NotBlank, @Email 等）

@PostMapping("/validate")
public String validateUser(@Valid @RequestBody User user, BindingResult result) {if (result.hasErrors()) {return "Validation failed";}return "Valid user: " + user.getName();
}

接收嵌套结构（List / 复杂对象）

@PostMapping("/batch")
public String createUsers(@RequestBody List<User> users) {return "Total users: " + users.size();
}// 请求示例：[{"name": "Alice"},{"name": "Bob"}]