怎么把json数组转成list对象

JSON数组转List对象：全面解析与实践指南

在Java开发中,处理JSON数据是一项常见任务，将JSON数组转换为List对象是其中非常基础且重要的操作，本文将详细介绍如何使用不同的工具库实现这一转换，包括Jackson、Gson和Fastjson等主流方案，并提供完整的代码示例和注意事项。

使用Jackson库实现转换

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

添加依赖

首先确保项目中包含Jackson核心库：

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

基本转换方法

假设我们有一个JSON数组和对应的Java实体类：

// JSON字符串示例
String jsonArrayStr = "[{\"id\":1,\"name\":\"张三\"},{\"id\":2,\"name\":\"李四\"}]";
// 实体类
class User {
    private int id;
    private String name;
    // getters和setters
}

转换代码：

ObjectMapper objectMapper = new ObjectMapper();
List<User> userList = objectMapper.readValue(
    jsonArrayStr, 
    new TypeReference<List<User>>() {}
);

处理复杂类型

对于更复杂的场景,如嵌套对象或泛型集合：

// 处理List<Map>结构
List<Map<String, Object>> mapList = objectMapper.readValue(
    jsonArrayStr, 
    new TypeReference<List<Map<String, Object>>>() {}
);

使用Gson库实现转换

Google的Gson库是另一个流行的选择,语法简洁直观。

添加依赖

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

基本转换方法

Gson gson = new Gson();
List<User> userList = gson.fromJson(jsonArrayStr, new TypeToken<List<User>>() {}.getType());

自定义序列化

Gson允许注册自定义类型适配器：

Gson gson = new GsonBuilder()
    .registerTypeAdapter(User.class, new UserDeserializer())
    .create();

使用Fastjson库实现转换

Fastjson是阿里巴巴开源的高性能JSON库,在国内应用广泛。

添加依赖

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

基本转换方法

List<User> userList = JSON.parseArray(jsonArrayStr, User.class);

Fastjson提供了更简洁的API,特别适合简单场景。

常见问题与解决方案

字段名不匹配

当JSON字段与Java类属性名不一致时：

• Jackson：使用@JsonProperty注解
• Gson：使用@SerializedName注解
• Fastjson：使用@JSONField注解

示例：

class User {
    @JsonProperty("user_id") // Jackson
    @SerializedName("user_id") // Gson
    @JSONField(name = "user_id") // Fastjson
    private int id;
}

日期格式处理

JSON中的日期字符串需要特殊处理：

// Jackson配置
objectMapper.registerModule(new JavaTimeModule());
objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
// Gson配置
Gson gson = new GsonBuilder()
    .setDateFormat("yyyy-MM-dd HH:mm:ss")
    .create();

空值处理

不同库对null值的处理方式不同,可以通过配置调整：

// Jackson
objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
// Gson
Gson gson = new GsonBuilder().serializeNulls().create();

性能对比与选择建议

选择建议：

• 新项目优先考虑Jackson,功能全面且稳定
• 简单场景或Android开发可选Gson
• 对性能要求极高的场景可考虑Fastjson（注意安全更新）

完整示例代码

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import com.alibaba.fastjson.JSON;
import java.util.List;
public class JsonToListConverter {
    public static void main(String[] args) {
        String jsonStr = "[{\"id\":1,\"name\":\"张三\"},{\"id\":2,\"name\":\"李四\"}]";
        // Jackson方式
        try {
            ObjectMapper mapper = new ObjectMapper();
            List<User> jacksonList = mapper.readValue(
                jsonStr, 
                new TypeReference<List<User>>() {}
            );
            System.out.println("Jackson转换结果: " + jacksonList);
        } catch (Exception e) {
            e.printStackTrace();
        }
        // Gson方式
        Gson gson = new Gson();
        List<User> gsonList = gson.fromJson(
            jsonStr, 
            new TypeToken<List<User>>() {}.getType()
        );
        System.out.println("Gson转换结果: " + gsonList);
        // Fastjson方式
        List<User> fastjsonList = JSON.parseArray(jsonStr, User.class);
        System.out.println("Fastjson转换结果: " + fastjsonList);
    }
}
class User {
    private int id;
    private String name;
    // getters和setters
    @Override
    public String toString() {
        return "User{id=" + id + ", name='" + name + "'}";
    }
}

将JSON数组转换为List对象是Java开发中的基础技能,本文介绍了三种主流实现方式：

1. Jackson：功能最全面，适合复杂场景
2. Gson：API简洁，适合简单需求和Android开发
3. Fastjson：性能最优，适合国内高并发场景

选择时需考虑项目需求、团队熟悉度和性能要求，无论选择哪种方式，都应注意字段映射、日期格式和异常处理等细节问题，这些技能将大大提升你在处理JSON数据时的效率和代码质量。