使用Gson解析动态键值的JSON数据到POJO对象_技术教程

本文将针对 "使用Gson解析动态键值的JSON数据到POJO对象" 这一问题，提供详细的解决方案。在许多API接口中，返回的JSON数据结构可能包含动态的键名，例如日期、时间戳等。这种情况下，传统的POJO映射方式可能会失效。本文将介绍如何使用Gson库，结合Map数据结构，灵活地处理这类动态键值，并将JSON数据成功地映射到POJO对象中，以便后续的数据处理和使用。

在你的示例中，问题在于 Time Series (5min) 节点下的键是动态的日期时间字符串。为了正确解析这种结构，需要对 TimeSeries 类进行调整。

调整 TimeSeries 类

与其创建一个名为 date 的类，不如直接使用 Map 来表示时间序列数据。这里的 Date 类对应于 JSON 中每个日期时间键对应的值。修改后的 TimeSeries 类如下：

import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;

import java.util.Map;

public class TimeSeries {
    @SerializedName("Time Series (5min)")
    @Expose
    private Map timeSeries;

    public Map getTimeSeries() {
        return timeSeries;
    }

    public void setTimeSeries(Map timeSeries) {
        this.timeSeries = timeSeries;
    }
}

注意，这里我们将 date 类更名为 StockData，以更清晰地表达其含义。StockData 类用于存储每个时间点的股票数据：

import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;

public class StockData {

    @SerializedName("1. open")
    @Expose
    private String _1Open;
    @SerializedName("2. high")
    @Expose
    private String _2High;
    @SerializedName("3. low")
    @Expose
    private String _3Low;
    @SerializedName("4. close")
    @Expose
    private String _4Close;
    @SerializedName("5. volume")
    @Expose
    private String _5Volume;

    // 构造函数、getter 和 setter 方法
    public StockData() {}

    public StockData(String _1Open, String _2High, String _3Low, String _4Close, String _5Volume) {
        this._1Open = _1Open;
        this._2High = _2High;
        this._3Low = _3Low;
        this._4Close = _4Close;
        this._5Volume = _5Volume;
    }

    public String get1Open() {
        return _1Open;
    }

    public void set1Open(String _1Open) {
        this._1Open = _1Open;
    }

    public String get2High() {
        return _2High;
    }

    public void set2High(String _2High) {
        this._2High = _2High;
    }

    public String get3Low() {
        return _3Low;
    }

    public void set3Low(String _3Low) {
        this._3Low = _3Low;
    }

    public String get4Close() {
        return _4Close;
    }

    public void set4Close(String _4Close) {
        this._4Close = _4Close;
    }

    public String get5Volume() {
        return _5Volume;
    }

    public void set5Volume(String _5Volume) {
        this._5Volume = _5Volume;
    }
}

完整 DailyQuote 类

为了完整性，这里提供修改后的 DailyQuote 类：

import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;

public class DailyQuote {

    @SerializedName("Meta Data")
    @Expose
    private MetaData metaData;
    @SerializedName("Time Series (5min)")
    @Expose
    private TimeSeries timeSeries;

    public DailyQuote() {}

    public DailyQuote(MetaData metaData, TimeSeries timeSeries) {
        this.metaData = metaData;
        this.timeSeries = timeSeries;
    }

    public MetaData getMetaData() {
        return metaData;
    }

    public void setMetaData(MetaData metaData) {
        this.metaData = metaData;
    }

    public TimeSeries getTimeSeries() {
        return timeSeries;
    }

    public void setTimeSeries(TimeSeries timeSeries) {
        this.timeSeries = timeSeries;
    }
}

使用 Gson 解析

现在，可以使用 Gson 将 JSON 数据解析到 POJO 对象中：

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;

public class GsonParser {

    public static void main(String[] args) {
        String json = "{\n" +
                "    \"Meta Data\": {\n" +
                "        \"1. Information\": \"Intraday (5min) open, high, low, close prices and volume\",\n" +
                "        \"2. Symbol\": \"IBM\",\n" +
                "        \"3. Last Refreshed\": \"2025-10-26 19:40:00\",\n" +
                "        \"4. Interval\": \"5min\",\n" +
                "        \"5. Output Size\": \"Compact\",\n" +
                "        \"6. Time Zone\": \"US/Eastern\"\n" +
                "    },\n" +
                "    \"Time Series (5min)\": {\n" +
                "        \"2025-10-26 19:40:00\": {\n" +
                "            \"1. open\": \"135.0600\",\n" +
                "            \"2. high\": \"135.0700\",\n" +
                "            \"3. low\": \"135.0400\",\n" +
                "            \"4. close\": \"135.0700\",\n" +
                "            \"5. volume\": \"500\"\n" +
                "        },\n" +
                "        \"2025-10-26 19:05:00\": {\n" +
                "            \"1. open\": \"135.3500\",\n" +
                "            \"2. high\": \"135.3500\",\n" +
                "            \"3. low\": \"135.3500\",\n" +
                "            \"4. close\": \"135.3500\",\n" +
                "            \"5. volume\": \"106\"\n" +
                "        },\n" +
                "        \"2025-10-26 18:50:00\": {\n" +
                "            \"1. open\": \"135.0300\",\n" +
                "            \"2. high\": \"135.0300\",\n" +
                "            \"3. low\": \"135.0300\",\n" +
                "            \"4. close\": \"135.0300\",\n" +
                "            \"5. volume\": \"100\"\n" +
                "        },\n" +
                "        \"2025-10-26 17:50:00\": {\n" +
                "            \"1. open\": \"135.0300\",\n" +
                "            \"2. high\": \"135.0300\",\n" +
                "            \"3. low\": \"135.0300\",\n" +
                "            \"4. close\": \"135.0300\",\n" +
                "            \"5. volume\": \"200\"\n" +
                "        }\n" +
                "    }\n" +
                "}";

        Gson gson = new GsonBuilder().create();
        DailyQuote dailyQuote = gson.fromJson(json, DailyQuote.class);

        // 打印结果进行验证
        System.out.println("Meta Data: " + dailyQuote.getMetaData().get2Symbol());
        System.out.println("Time Series: " + dailyQuote.getTimeSeries().getTimeSeries().keySet());
    }
}

这段代码首先创建了一个 Gson 对象，然后使用 fromJson() 方法将 JSON 字符串解析为 DailyQuote 对象。最后，打印出 Meta Data 中的 Symbol 和 Time Series 中的键，以验证解析是否成功。

注意事项

Gson 依赖: 确保你的项目中已经添加了 Gson 依赖。
命名规范: @SerializedName 注解中的名称必须与 JSON 数据的键名完全一致，包括大小写。
数据类型: 选择合适的数据类型来存储 JSON 中的值。例如，如果 JSON 中的数字是字符串类型，则 POJO 中对应的字段也应该使用 String 类型。
空值处理: Gson 默认会将 JSON 中的 null 值映射到 POJO 中对应的字段的 null 值。如果需要自定义空值处理，可以使用 Gson 的 JsonDeserializer 接口。