如何为含动态键的WebService响应JSON结构声明Java Bean

遇到这种带动态键的JSON结构确实有点挠头，不过咱们可以通过结合集合和Jackson的特性来轻松搞定对应的Java Bean，下面是具体的实现方案：

这个类对应动态键包裹的具体内容，结构很清晰：

public class ErrorDetail {
    private String name;
    private List<String> error;

    // 记得生成Getters和Setters，或者用Lombok的@Data注解一键生成
}

因为外层的error是数组，数组里的每个元素都是只有单个动态键值对的对象，我们可以直接用List<Map<String, ErrorDetail>>来表示这个结构，最外层响应类这么写：

public class WebServiceResponse {
    private List<Map<String, ErrorDetail>> error;

    // Getters and Setters
}

反序列化示例（以Jackson为例） #

用ObjectMapper直接解析就行，后续遍历数据也很方便：

ObjectMapper objectMapper = new ObjectMapper();
String json = "{ \"error\": [ { \"fea09b93175b626e4bb3d248ccb890bc\": { \"name\": \"80_5595_10.zip (5.0)\", \"error\": [ \"Location path does not exist\" ] } }, { \"5a8745c1967adabe9d492d3595f37ce1\": { \"name\": \"80_7208_01.zip (5.0)\", \"error\": [ \"Location path does not exist\" ] } } ] }";

WebServiceResponse response = objectMapper.readValue(json, WebServiceResponse.class);

// 遍历获取动态键和对应的错误信息
for (Map<String, ErrorDetail> errorItem : response.getError()) {
    // 每个Map里只有一个键值对，直接取entry即可
    Map.Entry<String, ErrorDetail> entry = errorItem.entrySet().iterator().next();
    String dynamicKey = entry.getKey();
    ErrorDetail detail = entry.getValue();
    
    System.out.println("动态标识：" + dynamicKey);
    System.out.println("文件名：" + detail.getName());
    System.out.println("错误描述：" + detail.getError());
}

如果觉得Map不够直观，可以给数组里的每个元素单独定义类，用Jackson的@JsonAnySetter注解来自动绑定动态键：

public class ErrorEntry {
    private String dynamicKey;
    private ErrorDetail errorDetail;

    @JsonAnySetter
    public void setDynamicField(String key, ErrorDetail value) {
        this.dynamicKey = key;
        this.errorDetail = value;
    }

    // Getters and Setters
}

然后外层响应类改成这样：

public class WebServiceResponse {
    private List<ErrorEntry> error;

    // Getters and Setters
}

这种方式下，后续遍历数据不用再处理Map的entry，直接从ErrorEntry里拿动态键和详情，代码会更简洁易读。

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