json如何转换为list集合

JSON如何转换为List集合：从字符串到结构化数据的转换指南

在Java开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，被广泛应用于前后端数据交互，将JSON字符串转换为List集合是处理复杂数据结构的常见需求，本文将详细介绍如何使用不同的Java库实现JSON到List集合的转换，包括核心步骤、代码示例及注意事项。

JSON转换为List的核心步骤

将JSON字符串转换为List集合通常包含以下三个核心步骤：

1. 引入JSON处理库：选择合适的JSON处理库（如Jackson、Gson、Fastjson等）
2. 解析JSON字符串：将JSON字符串解析为Java对象
3. 类型转换：将解析结果强制转换为List集合

使用Jackson库转换JSON为List

Jackson是Java生态中最流行的JSON处理库之一,提供了高效的JSON解析和生成功能。

添加依赖

Maven项目中添加Jackson依赖：

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

转换示例

示例1：简单JSON数组转List

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 {
        ObjectMapper objectMapper = new ObjectMapper();
        // JSON数组字符串
        String json = "[1, 2, 3, 4, 5]";
        // 转换为List<Integer>
        List<Integer> list = objectMapper.readValue(json, new TypeReference<List<Integer>>() {});
        System.out.println(list); // 输出: [1, 2, 3, 4, 5]
    }
}

示例2：复杂JSON对象数组转List

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
import java.util.Map;
public class JacksonComplexJsonToList {
    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        // 复杂JSON对象数组字符串
        String json = "[{\"name\":\"张三\",\"age\":25},{\"name\":\"李四\",\"age\":30}]";
        // 转换为List<Map>
        List<Map<String, Object>> list = objectMapper.readValue(json, new TypeReference<List<Map<String, Object>>>() {});
        System.out.println(list);
        // 输出: [{name=张三, age=25}, {name=李四, age=30}]
    }
}

使用Gson库转换JSON为List

Google的Gson库是另一个流行的JSON处理选择,以其简洁易用著称。

添加依赖

Maven项目中添加Gson依赖：

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

转换示例

示例1：简单JSON数组转List

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.List;
public class GsonJsonToList {
    public static void main(String[] args) {
        Gson gson = new Gson();
        // JSON数组字符串
        String json = "[\"apple\", \"banana\", \"orange\"]";
        // 转换为List<String>
        List<String> list = gson.fromJson(json, new TypeToken<List<String>>() {}.getType());
        System.out.println(list); // 输出: [apple, banana, orange]
    }
}

示例2：复杂JSON对象数组转List

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.List;
import java.util.Map;
public class GsonComplexJsonToList {
    public static void main(String[] args) {
        Gson gson = new Gson();
        // 复杂JSON对象数组字符串
        String json = "[{\"id\":1,\"product\":\"手机\"},{\"id\":2,\"product\":\"电脑\"}]";
        // 转换为List<Map>
        List<Map<String, Object>> list = gson.fromJson(json, new TypeToken<List<Map<String, Object>>>() {}.getType());
        System.out.println(list);
        // 输出: [{id=1, product=手机}, {id=2, product=电脑}]
    }
}

使用Fastjson库转换JSON为List

Fastjson是阿里巴巴开源的JSON处理库,以其高性能著称。

添加依赖

Maven项目中添加Fastjson依赖：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
</dependency>

转换示例

import com.alibaba.fastjson.JSON;
import java.util.List;
public class FastjsonJsonToList {
    public static void main(String[] args) {
        // JSON数组字符串
        String json = "[{\"name\":\"王五\",\"age\":28},{\"name\":\"赵六\",\"age\":32}]";
        // 直接转换为List
        List<Object> list = JSON.parseArray(json);
        System.out.println(list);
        // 输出: [{"name":"王五","age":28},{"name":"赵六","age":32}]
        // 转换为指定类型的List
        List<Person> personList = JSON.parseArray(json, Person.class);
        System.out.println(personList);
        // 输出: [Person{name='王五', age=28}, Person{name='赵六', age=32}]
    }
    static class Person {
        private String name;
        private int age;
        // 构造方法、getter和setter省略
        @Override
        public String toString() {
            return "Person{name='" + name + "', age=" + age + "}";
        }
    }
}

转换过程中的注意事项

1. 类型安全：确保JSON数据结构与目标List中的元素类型匹配,否则会抛出异常。
2. 异常处理：JSON解析可能抛出异常（如JSON格式错误）,应进行适当的异常捕获。
3. 性能考虑：对于大量数据，选择性能较好的库（如Fastjson或Jackson）。
4. 日期处理：JSON中的日期可能需要特殊处理,各库都提供了日期格式化的配置选项。
5. 空值处理：JSON中的null值在转换为List时会保留为Java中的null。

将JSON转换为List集合是Java开发中的常见任务,本文介绍了三种主流JSON库的实现方法：

• Jackson：功能全面，性能优秀，适合复杂场景
• Gson：API简洁，易于使用，适合简单场景
• Fastjson：性能极高，但API设计相对简单

选择哪种库取决于项目需求、性能要求和团队熟悉度，无论选择哪种库，核心步骤都是相似的：引入库、解析JSON、类型转换，这些技术将帮助开发者更高效地处理JSON数据,构建健壮的应用程序。