深入理解与使用Jackson：Java JSON处理的得力助手

凤鸣觑

694人浏览 · 2025-11-20 23:11:47

凤鸣觑 · 2025-11-20 23:11:47 发布

深入理解与使用Jackson：Java JSON处理的得力助手

摘要：本文全面介绍了Jackson库在Java开发中处理JSON数据的使用方法，涵盖了Jackson的基础概念、核心功能以及高级应用，旨在帮助开发者快速掌握并熟练运用Jackson进行高效的JSON操作。

一、引言

在当今的软件开发中，JSON（JavaScript Object Notation）已成为数据交换的标准格式之一。Java开发者经常需要在Java对象与JSON之间进行转换。Jackson作为一个流行且功能强大的Java JSON处理库，为我们提供了高效、灵活的解决方案。本文将详细介绍Jackson的使用。

二、Jackson简介

什么是Jackson
Jackson是由FasterXML开发的一套用于处理JSON数据的Java库。它提供了一组丰富的API，用于将Java对象序列化为JSON格式的字符串，以及将JSON字符串反序列化为Java对象。
优势与特点
- 高性能：经过优化，处理速度快，内存占用低，适合处理大规模JSON数据。
- 灵活性：支持多种定制化配置，能够满足各种复杂的JSON处理需求。
- 广泛支持：与众多Java框架（如Spring）集成良好，被广泛应用于各类Java项目中。

三、环境搭建

Maven依赖
在pom.xml文件中添加Jackson依赖：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson - databind</artifactId>
    <version>2.13.3</version>
</dependency>

Jackson主要由三个模块组成：jackson - core提供了底层的JSON处理功能，jackson - annotations包含了用于定制序列化和反序列化行为的注解，jackson - databind则是核心模块，整合了前两者并提供了高级的对象映射功能。

四、核心功能 - 序列化

基本对象序列化
创建一个简单的Java对象，并使用ObjectMapper将其序列化为JSON字符串。

import com.fasterxml.jackson.databind.ObjectMapper;

public class SerializationExample {
    public static void main(String[] args) {
        try {
            // 创建一个简单的Java对象
            Person person = new Person("John", 30);

            // 创建ObjectMapper实例
            ObjectMapper objectMapper = new ObjectMapper();

            // 将Java对象转换为JSON字符串
            String json = objectMapper.writeValueAsString(person);
            System.out.println(json);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

class Person {
    private String name;
    private int age;

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    // 省略getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

自定义序列化行为
- 使用注解：通过@JsonProperty注解可以指定JSON字段名，@JsonIgnore注解可忽略特定字段。

import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;

public class CustomSerializationExample {
    public static void main(String[] args) {
        try {
            Employee employee = new Employee("Jane", 35, 5000);

            ObjectMapper objectMapper = new ObjectMapper();
            String json = objectMapper.writeValueAsString(employee);
            System.out.println(json);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

class Employee {
    private String name;
    private int age;
    @JsonProperty("salary_amount")
    private double salary;
    @JsonIgnore
    private String department;

    public Employee(String name, int age, double salary) {
        this.name = name;
        this.age = age;
        this.salary = salary;
        this.department = "Engineering";
    }

    // 省略getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public double getSalary() {
        return salary;
    }

    public void setSalary(double salary) {
        this.salary = salary;
    }

    public String getDepartment() {
        return department;
    }

    public void setDepartment(String department) {
        this.department = department;
    }
}

- **自定义序列化器**：当默认序列化方式无法满足需求时，可创建自定义序列化器。例如，自定义日期格式的序列化。

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.JsonSerializer;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.module.SimpleModule;

import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;

public class CustomDateSerializer extends JsonSerializer<Date> {
    @Override
    public void serialize(Date date, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException {
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy - MM - dd");
        String formattedDate = dateFormat.format(date);
        jsonGenerator.writeString(formattedDate);
    }
}

注册自定义序列化器：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;

import java.util.Date;

public class CustomDateSerializationExample {
    public static void main(String[] args) {
        try {
            DateHolder dateHolder = new DateHolder(new Date());

            ObjectMapper objectMapper = new ObjectMapper();

            SimpleModule module = new SimpleModule();
            module.addSerializer(Date.class, new CustomDateSerializer());
            objectMapper.registerModule(module);

            String json = objectMapper.writeValueAsString(dateHolder);
            System.out.println(json);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

class DateHolder {
    private Date date;

    public DateHolder(Date date) {
        this.date = date;
    }

    // 省略getter和setter方法
    public Date getDate() {
        return date;
    }

    public void setDate(Date date) {
        this.date = date;
    }
}

五、核心功能 - 反序列化

基本反序列化
将JSON字符串转换为Java对象。

import com.fasterxml.jackson.databind.ObjectMapper;

public class DeserializationExample {
    public static void main(String[] args) {
        try {
            // 一个JSON字符串
            String json = "{\"name\":\"John\",\"age\":30}";

            // 创建ObjectMapper实例
            ObjectMapper objectMapper = new ObjectMapper();

            // 将JSON字符串转换为Java对象
            Person person = objectMapper.readValue(json, Person.class);
            System.out.println("Name: " + person.getName() + ", Age: " + person.getAge());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

class Person {
    private String name;
    private int age;

    public Person() {}

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    // 省略getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

处理复杂JSON结构
当JSON字符串包含嵌套对象或数组时，Jackson同样能够轻松处理。

import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.List;

public class ComplexDeserializationExample {
    public static void main(String[] args) {
        try {
            String json = "{\"name\":\"Company X\",\"employees\":[{\"name\":\"Alice\",\"age\":25},{\"name\":\"Bob\",\"age\":30}]}";

            ObjectMapper objectMapper = new ObjectMapper();
            Company company = objectMapper.readValue(json, Company.class);

            System.out.println("Company Name: " + company.getName());
            for (Employee employee : company.getEmployees()) {
                System.out.println("Employee Name: " + employee.getName() + ", Age: " + employee.getAge());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

class Company {
    private String name;
    private List<Employee> employees;

    // 省略getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public List<Employee> getEmployees() {
        return employees;
    }

    public void setEmployees(List<Employee> employees) {
        this.employees = employees;
    }
}

class Employee {
    private String name;
    private int age;

    // 省略getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

六、高级应用

与Spring框架集成
在Spring Boot项目中，Jackson通常被默认用于处理JSON数据。例如，在控制器方法中，返回的Java对象会自动被Jackson序列化为JSON格式响应给客户端，传入的JSON数据也会被反序列化为Java对象。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class ExampleController {

    @GetMapping("/person")
    public Person getPerson() {
        return new Person("Tom", 28);
    }
}

class Person {
    private String name;
    private int age;

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    // 省略getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

处理大型JSON文档
对于大型JSON文档，可以使用JsonParser和JsonGenerator进行流式处理，以减少内存占用。

import com.fasterxml.jackson.core.JsonFactory;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.core.JsonToken;

import java.io.IOException;

public class StreamingExample {
    public static void main(String[] args) {
        try {
            JsonFactory jsonFactory = new JsonFactory();
            JsonParser jsonParser = jsonFactory.createParser("{\"name\":\"John\",\"age\":30}");

            while (!jsonParser.isClosed()) {
                JsonToken jsonToken = jsonParser.nextToken();
                if (jsonToken == JsonToken.FIELD_NAME) {
                    String fieldName = jsonParser.getCurrentName();
                    jsonToken = jsonParser.nextToken();
                    if (jsonToken == JsonToken.VALUE_STRING && "name".equals(fieldName)) {
                        String name = jsonParser.getText();
                        System.out.println("Name: " + name);
                    } else if (jsonToken == JsonToken.VALUE_NUMBER_INT && "age".equals(fieldName)) {
                        int age = jsonParser.getIntValue();
                        System.out.println("Age: " + age);
                    }
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

七、总结

Jackson作为Java领域中强大的JSON处理库，提供了丰富的功能和高度的灵活性。从基本的对象序列化与反序列化到复杂的自定义配置和高级应用，Jackson能够满足各种JSON处理需求。通过本文的介绍，希望读者能够熟练掌握Jackson的使用，并在实际项目中充分发挥其优势，提高开发效率和系统性能。

AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

AI Agent 对比和选型

AI Agent技术社区

2026企业微信AI Agent实测：7款技术方案对比

会话审计、敏感词管理、聊天质检、敏感行为识别、舆情、属性、词频及竞品分析覆盖服务风险；线索公海、客户、产品、商机、订单、回款、发票和业绩目标则连接销售全过程。快创助手负责快速建运营任务，策略生成把目标拆成方案，智能客服回答系统使用咨询，数据报表处理自然语言查数，AI洞察联合标签、订单和会话分析客户。我们设计了客户筛选、订单关联、销售交接、会话质检和异常恢复任务，配合技术访谈与行业公开资料复核。准备