JSON反序列化为Java对象的常见问题与解决方法

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《JSON数组反序列化为Java对象：常见问题与解决方案 》，聊聊，我们一起来看看吧！

当尝试将JSON数组反序列化为单个Java对象时，常会遇到“Can't deserialize JSON array into class”错误。这通常是因为JSON字符串以数组形式（`[`开头）存在，而目标Java类型却是一个普通的类。本文将详细介绍两种有效的解决方案：将其反序列化为目标类的数组，或利用`TypeToken`反序列化为`ArrayList`，从而正确处理JSON数组结构。

理解JSON反序列化错误：数组与对象不匹配

在Java开发中，使用JSONB（或Jackson、Gson等）库进行JSON反序列化时，一个常见的陷阱是JSON结构与目标Java类型不匹配。当JSON字符串以 [ 开头，表示它是一个JSON数组，包含一个或多个JSON对象。然而，如果尝试将其直接反序列化为一个普通的Java类（例如 MocktailDto.class），反序列化器会因为类型不匹配而抛出 Can't deserialize JSON array into class 错误。

例如，给定的JSON字符串如下，它是一个包含单个 MocktailDto 对象的数组：

[
    {
        "id": 3,
        "name": "Mojito",
        "zutaten": [
            {
                "anzahl": 1,
                "id": 5,
                "name": "Rum"
            },
            {
                "anzahl": 1,
                "id": 6,
                "name": "GingerAle"
            }
        ]
    }
]

而代码中尝试将其反序列化为单个 MocktailDto 对象：

@POST
public Response createMocktail(String m){
    MocktailDto mocktail = jsonb.fromJson(m, MocktailDto.class); // 错误发生在这里
    return Response.ok(mocktailManager.createMocktail(mocktail)).build();
}

这种情况下，jsonb.fromJson(m, MocktailDto.class) 会失败，因为 m 是一个数组，而不是单个 MocktailDto 对象。

解决方案一：反序列化为目标类的数组

最直接的解决方案是将JSON数组反序列化为目标Java类的数组。这意味着如果JSON字符串是一个 MocktailDto 对象的数组，那么就应该将其反序列化为 MocktailDto[]。

示例代码：

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;

// 假设 MocktailDto 是你的Java类
// public class MocktailDto { ... }

public class JsonDeserializationExample {

    public static void main(String[] args) {
        String jsonString = "[{\"id\": 3,\"name\": \"Mojito\",\"zutaten\": [{\"anzahl\": 1,\"id\": 5,\"name\": \"Rum\"},{\"anzahl\": 1,\"id\": 6,\"name\": \"GingerAle\"}]}]";

        Jsonb jsonb = JsonbBuilder.create();

        // 将JSON数组反序列化为 MocktailDto 数组
        MocktailDto[] data = jsonb.fromJson(jsonString, MocktailDto[].class);

        // 如果你只需要数组中的第一个元素
        if (data != null && data.length > 0) {
            MocktailDto firstMocktail = data[0];
            System.out.println("成功反序列化第一个Mocktail: " + firstMocktail.getName());
            // 进一步处理 firstMocktail
        } else {
            System.out.println("JSON数组为空或反序列化失败。");
        }
    }
}

优点：

• 简单直观，适用于已知JSON数组中包含固定类型的对象。

注意事项：

• 反序列化后得到的是一个Java数组，需要通过索引（如 data[0]）来访问其中的元素。
• 如果JSON数组可能为空，需要进行空检查和长度检查。

解决方案二：反序列化为 ArrayList

当处理泛型集合（如 ArrayList）时，直接使用 ArrayList.class 作为目标类型通常不起作用，因为Java的类型擦除机制使得运行时无法获取泛型参数 MocktailDto 的具体信息。为了解决这个问题，需要使用 TypeToken（如 javax.json.bind.spi.TypeAdapter.TypeToken 或 com.google.gson.reflect.TypeToken，具体取决于使用的JSON库）。TypeToken 提供了一种在运行时保留泛型类型信息的方法。

示例代码：

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;
import javax.json.bind.spi.TypeAdapter; // 注意：这里可能需要根据具体jsonb实现调整TypeToken的导入
import java.lang.reflect.Type;
import java.util.ArrayList;

// 假设 MocktailDto 是你的Java类
// public class MocktailDto { ... }

public class JsonDeserializationExample {

    public static void main(String[] args) {
        String jsonString = "[{\"id\": 3,\"name\": \"Mojito\",\"zutaten\": [{\"anzahl\": 1,\"id\": 5,\"name\": \"Rum\"},{\"anzahl\": 1,\"id\": 6,\"name\": \"GingerAle\"}]}]";

        Jsonb jsonb = JsonbBuilder.create();

        // 使用 TypeToken 获取 ArrayList 的完整类型信息
        // 注意：这里使用的是 javax.json.bind.spi.TypeAdapter.TypeToken，
        // 如果你使用的是 Gson，则应使用 com.google.gson.reflect.TypeToken
        Type listType = new TypeAdapter.TypeToken>(){}.getType();

        ArrayList data = jsonb.fromJson(jsonString, listType);

        // 如果你只需要列表中的第一个元素
        if (data != null && !data.isEmpty()) {
            MocktailDto firstMocktail = data.get(0);
            System.out.println("成功反序列化第一个Mocktail: " + firstMocktail.getName());
            // 进一步处理 firstMocktail
        } else {
            System.out.println("JSON列表为空或反序列化失败。");
        }
    }
}

优点：

• 提供了更灵活的集合类型（如 ArrayList），方便进行动态增删改查。
• 正确处理了Java泛型的类型擦除问题，确保了类型安全。

注意事项：

• TypeToken 的具体导入路径可能因你使用的JSON库而异（例如，Gson库有自己的 com.google.gson.reflect.TypeToken）。请根据你的项目配置进行调整。
• 与数组类似，需要进行空检查和大小检查。

总结

当遇到“Can't deserialize JSON array into class”错误时，核心问题在于JSON输入是一个数组，而你试图将其反序列化为一个单一的Java对象。解决此问题的关键是确保反序列化的目标类型与JSON结构相匹配。你可以选择：

1. 反序列化为目标对象的数组 (YourClass[])：适用于直接获取对象数组的情况。
2. 反序列化为 ArrayList 并使用 TypeToken：适用于需要更灵活的集合操作，并且需要保留泛型类型信息的情况。

选择哪种方法取决于你的具体需求和对反序列化后数据结构的操作习惯。理解JSON结构与Java类型之间的对应关系是成功进行JSON反序列化的基础。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。