本文介绍如何在不创建冗余中间类的前提下，使用Jackson将形如{"phoneList":{"phone":[...]}}的嵌套JSON结构直接反序列化为List字段，核心是利用@JsonProperty注解配合反序列化setter方法。
本文介绍如何在不创建冗余中间类的前提下，使用jackson将形如{"phonelist":{"phone":[...]}}的嵌套json结构直接反序列化为list
在实际API对接中，我们常遇到JSON结构与理想Java模型不匹配的情况——例如目标字段phoneList在JSON中并非扁平数组，而是包裹在一层对象内（"phoneList": {"phone": [...]}）。若严格遵循JSON结构定义DTO，就必须引入PhoneList这类仅作容器用途的中间类，导致代码臃肿、可维护性下降。
幸运的是，Jackson提供了灵活的反序列化钩子机制，无需修改JSON或引入额外依赖，即可实现“逻辑扁平化”。其关键在于：利用@JsonProperty标注一个接受原始JSON对象类型的setter方法，在方法体内手动提取嵌套数组并赋值给目标List字段。
以下为完整、可运行的解决方案：
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
import java.util.ArrayList;
public class Response {
private String name;
private List<Phone> phoneList = new ArrayList<>();
// ✅ 核心：用@JsonProperty("phoneList")绑定JSON中的"phoneList"对象
// 方法参数类型为Map<String, List<Phone>>，Jackson会自动将该JSON对象反序列化为Map
@JsonProperty("phoneList")
private void setPhoneList(Map<String, List<Phone>> phoneListMap) {
// 从map中取出key为"phone"的列表，并赋值给实例字段
if (phoneListMap != null && phoneListMap.containsKey("phone")) {
this.phoneList = phoneListMap.get("phone");
}
}
// 必须提供默认构造器（Jackson反序列化要求）
public Response() {}
// Getter（可选，但推荐保持JavaBean规范）
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public List<Phone> getPhoneList() { return phoneList; }
// 内部类：Phone需为标准POJO（含默认构造器+字段getter/setter）
public static class Phone {
private String number;
private Integer code;
public Phone() {} // Jackson必需
public String getNumber() { return number; }
public void setNumber(String number) { this.number = number; }
public Integer getCode() { return code; }
public void setCode(Integer code) { this.code = code; }
@Override
public String toString() {
return "Phone{number='" + number + "', code=" + code + "}";
}
}
}✅ 使用示例：
String json = """
{
"name": "test",
"phoneList": {
"phone": [
{"number": "32323232", "code": 555},
{"number": "4343423432", "code": 555}
]
}
}
""";
ObjectMapper mapper = new ObjectMapper();
Response response = mapper.readValue(json, Response.class);
System.out.println(response.getName()); // 输出: test
System.out.println(response.getPhoneList()); // 输出: [Phone{number='32323232', code=555}, ...]⚠️ 重要注意事项：
- 必须提供无参构造器：Jackson反序列化要求所有参与类（包括内部类Phone）具备public或protected的无参构造函数；
- 字段访问权限：setPhoneList方法可为private，Jackson通过反射可访问；
- 空值/缺失键防护：示例中已添加null和containsKey检查，避免NullPointerException；
- 类型安全：Map<String, List<Phone>>中的List<Phone>由Jackson自动完成嵌套反序列化，前提是Phone类符合POJO规范；
- 不适用于序列化场景：此方案仅影响反序列化（JSON → Java）。若需将phoneList正确序列化回{"phoneList":{"phone":[...]}}格式，需额外配置@JsonSerialize或自定义序列化器。
总结而言，该方案以极小的代码代价，消除了语义无关的中间类，使DTO更贴近业务意图，同时保持了与Jackson生态的完全兼容性——是处理“过度嵌套JSON”的轻量级最佳实践。
