如何使用Gson模型/实体类高效解析指定JSON结构？

你的当前解析方式依赖通用的LinkedTreeMap，虽然能工作，但存在类型不安全、可读性差、后续操作需要手动类型转换的问题。改用强类型实体类是更高效、更易维护的方案，以下是具体实现步骤：

1. 分析JSON结构 #

先明确目标JSON的层级结构：

最外层是数组，数组内单个元素是一个以数字字符串（"0"/"1"/"2"）为键的对象，每个键对应的值包含state和nodes两个子对象：

• state对象：包含type字段，以及stat或state字段（JSON存在字段名不一致的情况）
• nodes对象：包含type和state字段

2. 定义对应实体类 #

根据结构创建强类型的Java类，用Gson的注解处理字段名不一致的问题：

State类 #

处理state对象的字段兼容：

import com.google.gson.annotations.SerializedName;

public class State {
    private String type;
    
    // 兼容JSON中"stat"和"state"两种字段名
    @SerializedName(value = "stat", alternate = {"state"})
    private String status;

    // Getter和Setter方法
    public String getType() { return type; }
    public void setType(String type) { this.type = type; }
    public String getStatus() { return status; }
    public void setStatus(String status) { this.status = status; }
}

Nodes类 #

对应nodes对象：

public class Nodes {
    private String type;
    private String state;

    // Getter和Setter方法
    public String getType() { return type; }
    public void setType(String type) { this.type = type; }
    public String getState() { return state; }
    public void setState(String state) { this.state = state; }
}

DeviceEntry类 #

对应数字键指向的对象：

public class DeviceEntry {
    private State state;
    private Nodes nodes;

    // Getter和Setter方法
    public State getState() { return state; }
    public void setState(State state) { this.state = state; }
    public Nodes getNodes() { return nodes; }
    public void setNodes(Nodes nodes) { this.nodes = nodes; }
}

3. 强类型解析代码 #

使用TypeToken指定泛型类型，直接解析为强类型集合，避免LinkedTreeMap的类型转换：

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.List;
import java.util.Map;

// 定义解析的目标类型
Type resultType = new TypeToken<List<Map<String, DeviceEntry>>>() {}.getType();

// 执行解析
List<Map<String, DeviceEntry>> result = new Gson().fromJson(restResponse.getBody(), resultType);

4. 方案优势对比 #

• 类型安全：编译阶段就能发现字段名错误、类型不匹配问题，避免运行时类型转换异常
• 性能更优：Gson解析强类型对象时，无需动态处理通用Map的类型映射，效率更高
• 可读性&可维护性：实体类清晰体现JSON结构，后续修改或扩展字段更直观
• 避免手动转换：直接通过Getter方法获取字段值，无需像LinkedTreeMap那样手动强转嵌套的Map

内容的提问来源于stack exchange，提问作者Oudadham