Jackson 使用方法详解

Jackson 是 Java 生态中最流行的 JSON 处理库，也是 Spring Boot 的默认 JSON 解析器。它提供了高性能的 JSON 序列化（对象 → JSON）和反序列化（JSON → 对象）功能。以下是 Jackson 的全面使用指南。

---

1. 基础依赖

Maven 依赖

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.0</version> <!-- 使用最新版本 -->
</dependency>

Spring Boot 项目无需手动引入，默认已集成。

---

2. 核心类：ObjectMapper

ObjectMapper 是 Jackson 的核心类，负责序列化和反序列化操作。

import com.fasterxml.jackson.databind.ObjectMapper;

ObjectMapper mapper = new ObjectMapper();

---

3. 基础用法

3.1 序列化（对象 → JSON）

Person person = new Person("Alice", 30);
String json = mapper.writeValueAsString(person);
// 输出: {"name":"Alice","age":30}

3.2 反序列化（JSON → 对象）

String json = "{\"name\":\"Alice\",\"age\":30}";
Person person = mapper.readValue(json, Person.class);
System.out.println(person.getName()); // 输出: Alice

3.3 序列化到文件/从文件反序列化

// 写入文件
mapper.writeValue(new File("person.json"), person);

// 从文件读取
Person person = mapper.readValue(new File("person.json"), Person.class);

---

4. 常用注解

Jackson 提供注解来控制序列化/反序列化行为。

4.1 字段控制

注解	作用	示例
@JsonProperty	自定义 JSON 字段名	@JsonProperty("user_name")
@JsonIgnore	忽略字段	@JsonIgnore private String password
@JsonInclude	仅包含非空字段	@JsonInclude(Include.NON_NULL)

4.2 日期格式化

public class Event {
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date createTime;
}

4.3 忽略未知字段

@JsonIgnoreProperties(ignoreUnknown = true)
public class Person {
    private String name;
}

---

5. 复杂对象处理

5.1 嵌套对象

public class Order {
    private String orderId;
    private Person customer; // 嵌套对象
}

String json = "{\"orderId\":\"123\",\"customer\":{\"name\":\"Alice\"}}";
Order order = mapper.readValue(json, Order.class);

5.2 集合类型

// List 序列化/反序列化
List<Person> people = Arrays.asList(new Person("Alice"), new Person("Bob"));
String json = mapper.writeValueAsString(people);

List<Person> parsedList = mapper.readValue(json, new TypeReference<List<Person>>() {});

5.3 Map 类型

Map<String, Person> personMap = new HashMap<>();
personMap.put("alice", new Person("Alice"));

String json = mapper.writeValueAsString(personMap);
Map<String, Person> parsedMap = mapper.readValue(json, new TypeReference<Map<String, Person>>() {});

---

6. 高级配置

6.1 美化输出（Pretty Print）

String prettyJson = mapper.writerWithDefaultPrettyPrinter()
                          .writeValueAsString(person);

6.2 自定义序列化/反序列化

// 自定义序列化器
public class CustomSerializer extends JsonSerializer<Person> {
    @Override
    public void serialize(Person value, JsonGenerator gen, SerializerProvider provider) {
        gen.writeString(value.getName().toUpperCase());
    }
}

// 注册自定义序列化器
SimpleModule module = new SimpleModule();
module.addSerializer(Person.class, new CustomSerializer());
mapper.registerModule(module);

---

7. 与 Spring Boot 集成

Spring Boot 自动配置了 ObjectMapper，可通过以下方式自定义：

7.1 全局配置

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));
        mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
        return mapper;
    }
}

7.2 REST 控制器示例

@RestController
public class PersonController {
    @GetMapping("/person")
    public Person getPerson() {
        return new Person("Alice", 30); // 自动转为JSON
    }

    @PostMapping("/person")
    public Person createPerson(@RequestBody Person person) { // 自动从JSON反序列化
        return person;
    }
}

---

8. 性能优化建议

1. 重用 ObjectMapper
   避免重复创建，推荐作为单例使用。

2. 使用 TypeReference 处理泛型

   List<Person> people = mapper.readValue(json, new TypeReference<List<Person>>() {});
   

3. 启用缓存

   mapper.enable(SerializationFeature.USE_EQUALITY_FOR_OBJECT_ID);
   

---

9. 常见问题

Q1: 如何处理循环引用？

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class User {
    private int id;
    private User friend; // 可能循环引用
}

Q2: 日期格式全局配置

mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));

Q3: 忽略 null 字段

mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);

---

总结

Jackson 提供了强大而灵活的 JSON 处理能力：

• 基础操作：ObjectMapper + readValue/writeValue
• 注解控制：@JsonProperty、@JsonIgnore 等
• 高级特性：自定义序列化、泛型处理、Spring 集成

掌握这些用法后，你可以高效安全地处理任何 JSON 数据场景！