java如何json转列表

Java中JSON字符串转换为List的完整指南

在Java开发中,经常需要将JSON格式的数据转换为Java集合对象，尤其是List，本文将详细介绍几种在Java中将JSON转换为List的常用方法，包括使用Jackson、Gson和org.json等主流库的实现方式。

使用Jackson库转换JSON为List

Jackson是Java生态中最流行的JSON处理库之一,提供了强大的JSON处理能力。

添加依赖

首先需要在项目中添加Jackson的依赖（Maven）：

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

基本转换示例

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
public class JacksonJsonToList {
    public static void main(String[] args) throws Exception {
        String json = "[{\"name\":\"张三\",\"age\":25},{\"name\":\"李四\",\"age\":30}]";
        ObjectMapper objectMapper = new ObjectMapper();
        // 使用TypeReference指定List的类型
        List<User> userList = objectMapper.readValue(json, new TypeReference<List<User>>() {});
        userList.forEach(System.out::println);
    }
}
class User {
    private String name;
    private int age;
    // 构造方法、getter和setter省略
    @Override
    public String toString() {
        return "User{name='" + name + "', age=" + age + "}";
    }
}

使用Gson库转换JSON为List

Google的Gson库是另一个广泛使用的JSON处理库。

添加依赖

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.9</version>
</dependency>

基本转换示例

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.List;
public class GsonJsonToList {
    public static void main(String[] args) {
        String json = "[{\"name\":\"张三\",\"age\":25},{\"name\":\"李四\",\"age\":30}]";
        Gson gson = new Gson();
        // 使用TypeToken指定List的类型
        List<User> userList = gson.fromJson(json, new TypeToken<List<User>>() {}.getType());
        userList.forEach(System.out::println);
    }
}
// User类同上

使用org.json库转换JSON为List

org.json是一个轻量级的JSON处理库，适合简单的JSON操作。

添加依赖

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20220320</version>
</dependency>

基本转换示例

import org.json.JSONArray;
import java.util.ArrayList;
import java.util.List;
public class OrgJsonToList {
    public static void main(String[] args) {
        String json = "[{\"name\":\"张三\",\"age\":25},{\"name\":\"李四\",\"age\":30}]";
        JSONArray jsonArray = new JSONArray(json);
        List<User> userList = new ArrayList<>();
        for (int i = 0; i < jsonArray.length(); i++) {
            JSONObject jsonObject = jsonArray.getJSONObject(i);
            User user = new User();
            user.setName(jsonObject.getString("name"));
            user.setAge(jsonObject.getInt("age"));
            userList.add(user);
        }
        userList.forEach(System.out::println);
    }
}
// User类同上

处理复杂类型的List

当List中的元素是复杂类型（如嵌套对象或泛型类型）时，需要特别注意类型信息的传递。

示例：处理包含泛型的List

// 假设有如下JSON
String json = "[{\"id\":1,\"name\":\"项目A\",\"tasks\":[{\"taskName\":\"任务1\"},{\"taskName\":\"任务2\"}]}]";
// 使用Jackson处理
ObjectMapper mapper = new ObjectMapper();
List<Project> projects = mapper.readValue(json, new TypeReference<List<Project>>() {});
// Project类可能如下
class Project {
    private int id;
    private String name;
    private List<Task> tasks;
    // getter和setter
}
class Task {
    private String taskName;
    // getter和setter
}

异常处理

在实际开发中,JSON转换可能会抛出各种异常，需要进行适当的处理：

try {
    List<User> userList = objectMapper.readValue(json, new TypeReference<List<User>>() {});
} catch (JsonParseException e) {
    System.err.println("JSON解析错误: " + e.getMessage());
} catch (JsonMappingException e) {
    System.err.println("JSON映射错误: " + e.getMessage());
} catch (IOException e) {
    System.err.println("IO错误: " + e.getMessage());
}

性能考虑

对于大量数据的JSON转换,性能是一个重要考虑因素：

1. 重用ObjectMapper/Gson实例：这些实例是线程安全的，可以重用
2. 考虑流式API：对于超大JSON文件，可以使用Jackson的JsonParser逐条处理
3. 避免不必要的转换：如果可能，直接在业务逻辑中使用JSON数据

在Java中将JSON转换为List有多种实现方式：

1. Jackson：功能强大，性能优秀，适合复杂场景
2. Gson：API简洁，易于使用，Google出品
3. org.json：轻量级，适合简单场景

选择哪种库取决于项目需求、性能要求和团队熟悉度，无论选择哪种方式，正确处理类型信息和异常都是保证代码健壮性的关键。