| 方向 | 名称 | 过程 | 举例 |
|---|---|---|---|
| Java → JSON | 序列化 | 把 Java 对象转成 JSON 字符串 | 返回 API 响应给前端 |
| JSON → Java | 反序列化 | 把 JSON 字符串转成 Java 对象 | 接收前端传来的请求体 |
大白话
Java 对象 → JSON(序列化)
在 Spring Boot 中,当你在 Controller 方法中返回一个 Java 对象(而不是 String、ResponseEntity 等原始类型),并且该方法被 @RestController 或 @ResponseBody 标注时,Spring 会自动将这个 Java 对象通过 Jackson(或其他配置的 JSON 库)序列化为 JSON 字符串,并作为 HTTP 响应体返回给客户端。
java
@RestController
public class UserController {
@GetMapping("/user")
public User getUser() {
User user = new User();
user.setId("123");
user.setName("Alice");
user.setCreateTime(LocalDateTime.now());
return user; // ← 返回的是 Java 对象
}
}
- Spring MVC 拦截到 getUser() 的返回值:User 对象。
- 因为有 @RestController,Spring 知道要把它转成 JSON。
- 使用 Jackson(默认)调用 ObjectMapper.writeValueAsString(user)。
- 将生成的 JSON 字符串写入 HTTP 响应体。
- 客户端收到:
java
{
"id": "123",
"name": "Alice",
"createTime": "2026-05-30T15:00:00"
}
JSON → Java(反序列化)
而 JSON → Java(反序列化) 发生在 你接收前端传来的 JSON 数据 时,比如:
java
@PostMapping("/user")
public Result createUser(@RequestBody User user) { // ← 这里是反序列化!
// user 是从 JSON 自动转换来的 Java 对象
return Result.success("创建成功", user);
}
java
{ "name": "Bob", "id": "999" }
Spring 用 Jackson 把它 反序列化 成 User 对象。
如果 User.id 字段标了 @JsonProperty(access = READ_ONLY),那么即使 JSON 里有 "id": "999",user.getId() 也会是 null!
| 场景 | 方向 | 是否用到 @JsonProperty(access = READ_ONLY) |
|---|---|---|
| Controller 返回对象 | Java → JSON(序列化) | ✅ READ_ONLY 字段会出现在响应中 |
Controller 接收 @RequestBody |
JSON → Java(反序列化) | ✅ READ_ONLY 字段会被忽略,不赋值 |
| 操作 | 用途 | Jackson 默认行为 |
|---|---|---|
| 序列化(Java → JSON) | 把 Java 对象转成 JSON 字符串 | 调用 getter 方法(如 getStatusName())或直接读取字段 |
| 反序列化(JSON → Java) | 把 JSON 字符串转成 Java 对象 | 调用 setter 方法(如 setStatus(String))或直接写入字段 |
主流 JSON 库(如 Jackson)在序列化时默认通过 getter 或字段读取值,在反序列化时默认通过 setter 或字段写入值,具体行为受可见性、注解和配置影响。