Java 中 JSON 转 POJO 全解析

简介

在 Java 开发中，JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，而 POJO（Plain Old Java Object）是普通的 Java 对象。将 JSON 数据转换为 POJO 对象是一个常见的需求，特别是在处理网络数据传输、配置文件读取等场景。本文将详细介绍在 Java 中如何将 JSON 转换为 POJO，包括基础概念、使用方法、常见实践以及最佳实践。

基础概念

JSON

JSON 是一种基于文本的数据格式，用于在不同系统之间交换数据。它由键值对组成，支持对象、数组、字符串、数字、布尔值和 null 等数据类型。例如：

{
    "name": "John",
    "age": 30,
    "isStudent": false
}

POJO

POJO 是一个普通的 Java 对象，不依赖于特定的框架或接口。它通常包含私有属性、公共的 getter 和 setter 方法，以及一个无参构造函数。例如：

public class Person {
    private String name;
    private int age;
    private boolean isStudent;

    // 无参构造函数
    public Person() {}

    // 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 boolean isStudent() {
        return isStudent;
    }

    public void setStudent(boolean student) {
        isStudent = student;
    }
}

JSON 转 POJO 的意义

将 JSON 转换为 POJO 可以使数据处理更加方便和类型安全。通过 POJO，我们可以使用面向对象的方式访问和操作 JSON 数据，提高代码的可读性和可维护性。

使用方法

使用 Jackson 进行转换

Jackson 是一个流行的 Java 库，用于处理 JSON 数据。以下是使用 Jackson 将 JSON 转换为 POJO 的示例：

import com.fasterxml.jackson.databind.ObjectMapper;

public class JacksonExample {
    public static void main(String[] args) {
        String json = "{\"name\":\"John\",\"age\":30,\"isStudent\":false}";
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            Person person = objectMapper.readValue(json, Person.class);
            System.out.println("Name: " + person.getName());
            System.out.println("Age: " + person.getAge());
            System.out.println("Is Student: " + person.isStudent());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

使用 Gson 进行转换

Gson 是 Google 提供的一个 Java 库，用于将 Java 对象与 JSON 数据进行相互转换。以下是使用 Gson 将 JSON 转换为 POJO 的示例：

import com.google.gson.Gson;

public class GsonExample {
    public static void main(String[] args) {
        String json = "{\"name\":\"John\",\"age\":30,\"isStudent\":false}";
        Gson gson = new Gson();
        Person person = gson.fromJson(json, Person.class);
        System.out.println("Name: " + person.getName());
        System.out.println("Age: " + person.getAge());
        System.out.println("Is Student: " + person.isStudent());
    }
}

常见实践

处理嵌套 JSON

当 JSON 数据包含嵌套对象时，我们可以定义嵌套的 POJO 类来处理。例如：

{
    "name": "John",
    "age": 30,
    "address": {
        "street": "123 Main St",
        "city": "New York"
    }
}

对应的 POJO 类如下：

public class Person {
    private String name;
    private int age;
    private Address address;

    // 无参构造函数
    public Person() {}

    // 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 Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }
}

class Address {
    private String street;
    private String city;

    // 无参构造函数
    public Address() {}

    // getter 和 setter 方法
    public String getStreet() {
        return street;
    }

    public void setStreet(String street) {
        this.street = street;
    }

    public String getCity() {
        return city;
    }

    public void setCity(String city) {
        this.city = city;
    }
}

使用 Jackson 进行转换的示例：

import com.fasterxml.jackson.databind.ObjectMapper;

public class NestedJsonExample {
    public static void main(String[] args) {
        String json = "{\"name\":\"John\",\"age\":30,\"address\":{\"street\":\"123 Main St\",\"city\":\"New York\"}}";
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            Person person = objectMapper.readValue(json, Person.class);
            System.out.println("Name: " + person.getName());
            System.out.println("Age: " + person.getAge());
            System.out.println("Street: " + person.getAddress().getStreet());
            System.out.println("City: " + person.getAddress().getCity());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

处理数组 JSON

当 JSON 数据是一个数组时，我们可以将其转换为 POJO 数组或列表。例如：

[
    {
        "name": "John",
        "age": 30
    },
    {
        "name": "Jane",
        "age": 25
    }
]