java 将json字符串转成list

原创

mob64ca12ecf3b4 2024-08-08 17:29:50 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12ecf3b4的原创作品，请联系作者获取转载授权，否则将追究法律责任

学习如何将 JSON 字符串转换为 List 类型

在现代开发中，JSON（JavaScript Object Notation）是一个非常流行的数据交换格式。Java 开发者往往需要将 JSON 字符串转换为 Java 对象，尤其是 List 类型的集合。本文将为刚入行的开发者提供一个简单明了的步骤指导，帮助你理解如何实现这一转换。

流程概述

我们将整个过程分为以下几个步骤：

步骤	描述
1	添加依赖项
2	创建数据类
3	JSON 字符串准备
4	使用库进行转换
5	处理异常及输出结果

步骤详解

步骤 1：添加依赖项

如果你使用 Maven 来管理 Java 项目，你需要在 pom.xml 中添加库的依赖。我们推荐使用 Jackson 或 Gson 作为 JSON 处理库。

以下是添加 Jackson 的示例：

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

这段代码会将 Jackson 的数据绑定库添加到项目中，以便我们后续的 JSON 转换。

步骤 2：创建数据类

接下来，我们需要创建一个模型类来映射 JSON 数据。假设我们有一个表示用户的类：

public class User {
    private String name;
    private int age;

    // 构造函数
    public User() {}

    // 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;
    }
}

这个 User 类有两个属性：name 和 age，并且提供了对应的 getter 和 setter 方法。通过这些方法，JSON 字符串将能够正确映射到这个类的实例中。

步骤 3：准备 JSON 字符串

我们可以使用一个示例 JSON 字符串来模拟数据：

String jsonString = "[{\"name\":\"Alice\",\"age\":30},{\"name\":\"Bob\",\"age\":25}]";

上面这个 JSON 字符串表示一个用户列表，其中包含两个用户对象。

步骤 4：使用库进行转换

现在，我们来使用 Jackson 库将 JSON 字符串转换为 List：

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;
import java.util.List;

public class JsonToListExample {
    public static void main(String[] args) {
        String jsonString = "[{\"name\":\"Alice\",\"age\":30},{\"name\":\"Bob\",\"age\":25}]";
        ObjectMapper objectMapper = new ObjectMapper();

        try {
            // 将 JSON 字符串转换为 User 对象的 List
            List<User> userList = objectMapper.readValue(jsonString, new TypeReference<List<User>>() {});
            
            // 输出结果
            for (User user : userList) {
                System.out.println("Name: " + user.getName() + ", Age: " + user.getAge());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

在这段代码中，我们首先创建了一个 ObjectMapper 实例，这是 Jackson 处理的核心对象。接下来，调用 readValue 方法将 JSON 字符串解析成 User 类型的 List。最后用一个 for-each 循环打印出每个用户的名字和年龄。如果解析过程中出现异常，将会打印异常信息。

步骤 5：处理异常及输出结果

我们在代码中做了基本的异常处理，确保在解析 JSON 时任何错误都会被捕获并打印。这样在生产环境中，我们可以更容易地发现问题。

关系图

下面展示 JSON 字符串与 Java 对象之间的关系：

erDiagram
    JSON_STRING {
        string name
        int age
    }
    User {
        string name
        int age
    }
    JSON_STRING ||--o| User : maps_to

序列图

接下来看一下整个过程的序列图：

sequenceDiagram
    participant User
    participant JSON
    participant ObjectMapper
    User->>JSON: 请求数据
    JSON-->>User: 返回 JSON 字符串
    User->>ObjectMapper: 请求将 JSON 转换为 List
    ObjectMapper-->>User: 返回 List<User> 实例