使用Gson将JSON对象正确反序列化为Java对象教程-java教程-PHP中文网

使用Gson将JSON对象正确反序列化为Java对象教程

心靈之曲

发布： 2025-10-05 13:36:02

原创

647人浏览过

使用gson将json对象正确反序列化为java对象教程

本文旨在解决使用Gson库将JSON字符串反序列化为Java对象时常见的IllegalStateException: Expected BEGIN_OBJECT but was STRING错误。通过分析错误的根源——JSON结构与Java对象映射的误解，并提供正确的反序列化方法，帮助开发者理解如何将整个JSON对象直接映射到对应的Java类，从而避免不必要的迭代和类型不匹配问题，确保数据转换的准确性与效率。

理解JSON到Java对象的映射挑战

在Java开发中，将JSON数据转换为对应的Java对象（即反序列化）是常见的操作。Gson是一个流行的Java库，用于实现这一功能。然而，如果不正确地理解JSON数据的结构与Java对象模型之间的对应关系，很容易遇到运行时错误，例如java.lang.IllegalStateException: Expected BEGIN_OBJECT but was STRING at path $。这个错误通常意味着Gson在尝试解析一个JSON对象时，却发现了一个字符串（或其他非对象类型），或者尝试将一个JSON的子元素当作整个对象进行解析。

考虑以下JSON数据结构：

{
  "type":"set",
  "key":"person",
  "value":{
    "name":"Elon Musk",
    "car":{
      "model":"Tesla Roadster",
      "year":"2018"
    },
    "rocket":{
      "name":"Falcon 9",
      "launches":"87"
    }
  }
}

登录后复制

为了将上述JSON数据映射到Java对象，我们首先需要定义匹配的Java类。根据JSON的层级结构，我们可以定义Person和Value两个类：

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;

@Getter
@Setter
@Data
@NoArgsConstructor
@AllArgsConstructor
@ToString
public class Person  {
    String type;
    String key;
    Value value; // 注意这里是Value类型，对应JSON中的"value"对象
}

登录后复制

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;
import java.util.Map;

@Data
@Setter
@NoArgsConstructor
@AllArgsConstructor
@Getter
@ToString
public class Value  {
    String name;
    Map<String, String> car;    // 对应JSON中的"car"对象
    Map<String, String> rocket; // 对应JSON中的"rocket"对象
}

登录后复制

错误的反序列化尝试及原因分析

假设我们已经通过JsonParser将JSON字符串解析为了JsonObject：

立即学习“Java免费学习笔记（深入）”；

北极象沉浸式AI翻译

免费的北极象沉浸式AI翻译 - 带您走进沉浸式AI的双语对照体验

查看详情

import com.google.gson.Gson;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.io.StringReader;
import java.util.Map;

// 假设 input.readUTF() 提供了上述JSON字符串
String jsonString = "{\n" +
        "  \"type\":\"set\",\n" +
        "  \"key\":\"person\",\n" +
        "  \"value\":{\n" +
        "    \"name\":\"Elon Musk\",\n" +
        "    \"car\":{\n" +
        "      \"model\":\"Tesla Roadster\",\n" +
        "      \"year\":\"2018\"\n" +
        "    },\n" +
        "    \"rocket\":{\n" +
        "      \"name\":\"Falcon 9\",\n" +
        "      \"launches\":\"87\"\n" +
        "    }\n" +
        "  }\n" +
        "}";
JsonObject jsonObject = JsonParser.parseString(jsonString).getAsJsonObject();
Gson gson = new Gson();

// 错误的尝试
// for (Map.Entry<String, JsonElement> entry : jsonObject.entrySet()) {
//     Person person = gson.fromJson(entry.getValue(), Person.class); // 这里会抛出IllegalStateException
//     System.out.println(person);
// }

登录后复制

上述被注释掉的代码片段展示了一个常见的错误模式。开发者可能误以为需要遍历JsonObject的每个条目（entry），然后将每个条目的值反序列化为Person对象。然而，这与我们的JSON结构不符：

JSON结构: 整个JSON对象本身就代表了一个Person对象，它的顶级键（type, key, value）直接对应Person类的字段。
entry.getValue()的类型: 当遍历jsonObject.entrySet()时，entry.getValue()会返回不同类型的JsonElement：
- 对于"type"和"key"，entry.getValue()将是JsonPrimitive（代表JSON字符串"set"和"person"）。
- 对于"value"，entry.getValue()将是JsonObject，但它代表的是Value类，而非Person类。
错误根源: 当gson.fromJson(entry.getValue(), Person.class)被调用，并且entry.getValue()是一个JsonPrimitive（例如字符串"set"）时，Gson会期望它是一个完整的JSON对象（以{开头），但却得到了一个字符串。因此，它会抛出IllegalStateException: Expected BEGIN_OBJECT but was STRING。即使对于"value"对应的JsonObject，它也无法直接映射到Person.class，因为Value类缺少type和key字段。

正确的反序列化方法

解决这个问题的关键在于认识到：整个JSON对象（即jsonObject本身）就是我们要反序列化的Person对象。因此，我们不需要遍历它的内部条目，而是直接将整个JsonObject传递给gson.fromJson()方法。

import com.google.gson.Gson;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.io.StringReader;
import java.util.Map;

public class JsonToPersonConverter {

    public static void main(String[] args) {
        String jsonString = "{\n" +
                "  \"type\":\"set\",\n" +
                "  \"key\":\"person\",\n" +
                "  \"value\":{\n" +
                "    \"name\":\"Elon Musk\",\n" +
                "    \"car\":{\n" +
                "      \"model\":\"Tesla Roadster\",\n" +
                "      \"year\":\"2018\"\n" +
                "    },\n" +
                "    \"rocket\":{\n" +
                "      \"name\":\"Falcon 9\",\n" +
                "      \"launches\":\"87\"\n" +
                "    }\n" +
                "  }\n" +
                "}";

        // 1. 使用JsonParser解析JSON字符串为JsonObject
        JsonObject jsonObject = JsonParser.parseString(jsonString).getAsJsonObject();

        // 2. 创建Gson实例
        Gson gson = new Gson();

        // 3. 直接将整个JsonObject反序列化为Person对象
        Person person = gson.fromJson(jsonObject, Person.class);

        // 4. 打印结果验证
        System.out.println("成功反序列化为 Person 对象:");
        System.out.println(person);
        System.out.println("Person Type: " + person.getType());
        System.out.println("Person Key: " + person.getKey());
        System.out.println("Person Value Name: " + person.getValue().getName());
        System.out.println("Person Value Car Model: " + person.getValue().getCar().get("model"));
    }
}

登录后复制

输出结果:

成功反序列化为 Person 对象:
Person(type=set, key=person, value=Value(name=Elon Musk, car={model=Tesla Roadster, year=2018}, rocket={name=Falcon 9, launches=87}))
Person Type: set
Person Key: person
Person Value Name: Elon Musk
Person Value Car Model: Tesla Roadster

登录后复制

注意事项与最佳实践

匹配JSON结构与Java对象： 这是使用Gson进行反序列化的核心。确保你的Java类字段名与JSON键名一致（或使用@SerializedName注解进行映射），并且嵌套的JSON对象应对应嵌套的Java类。
直接反序列化： 如果整个JSON字符串或JsonObject代表一个完整的Java对象，就直接将其作为参数传递给gson.fromJson()方法。避免不必要的迭代或尝试将JSON的子元素反序列化为父对象。
JsonParser与Gson的结合使用：
- JsonParser用于将JSON字符串解析成通用的JsonElement（可以是JsonObject, JsonArray, JsonPrimitive或JsonNull）。当你需要检查JSON结构、动态处理不同类型的JSON数据，或者只提取JSON中的部分数据时，JsonParser非常有用。
- Gson的fromJson()方法则负责将JsonElement或JSON字符串映射到具体的Java对象实例。
- 在上述示例中，我们先用JsonParser获取JsonObject，再用Gson进行映射。实际上，如果直接从JSON字符串反序列化，也可以省略JsonParser这一步：Person person = gson.fromJson(jsonString, Person.class); 这样更为简洁。
错误信息解读： 当遇到IllegalStateException时，仔细阅读错误信息中的Expected BEGIN_OBJECT but was STRING at path $（或其他类型）。path $表示JSON的根部，path $.someKey表示someKey字段。这能帮助你快速定位JSON结构与Java对象模型不匹配的具体位置。
Lombok的运用： 示例中使用了Lombok注解（如@Data, @Getter, @Setter, @NoArgsConstructor, @AllArgsConstructor, @ToString），它们能极大地简化Java Bean的编写，减少样板代码，使代码更简洁易读。

总结

正确使用Gson将JSON反序列化为Java对象，关键在于准确理解JSON数据的整体结构，并将其与Java对象模型进行一对一的映射。当整个JSON数据代表一个完整的Java对象时，应直接将该JSON数据（无论是字符串、Reader还是JsonObject）传递给gson.fromJson()方法，而不是错误地尝试迭代其内部元素。通过遵循这些原则，可以有效避免常见的IllegalStateException，确保数据转换的流畅和准确。

以上就是使用Gson将JSON对象正确反序列化为Java对象教程的详细内容，更多请关注php中文网其它相关文章！