本文介绍如何利用 Jackson 的 @JsonProperty 注解配合反序列化 setter 方法，绕过 JSON 中冗余的中间对象（如 phoneList 容器），将嵌套路径 "phoneList.phone" 直接映射到 Java 的 List<Phone> 字段，避免创建不必要的包装类。
本文介绍如何利用 jackson 的 `@jsonproperty` 注解配合反序列化 setter 方法，绕过 json 中冗余的中间对象（如 `phonelist` 容器），将嵌套路径 `"phonelist.phone"` 直接映射到 java 的 `list
在使用 Jackson 进行 JSON 反序列化时，常遇到结构不匹配问题：JSON 数据包含一层“容器对象”（如 "phoneList": { "phone": [...] }），但业务逻辑中并不需要该中间类，希望直接将 phoneList.phone 数组绑定到 List<Phone> 字段。此时若强行省略中间类（如仅声明 List<Phone> phoneList），默认反序列化会失败——因为 Jackson 无法自动识别 "phoneList" 对象内部的 "phone" 字段。
幸运的是，Jackson 提供了灵活的反序列化钩子机制：通过添加一个带 @JsonProperty("phoneList") 注解的参数化 setter 方法，即可捕获整个 "phoneList" JSON 对象，并手动提取其 "phone" 子数组。该方法无需返回值，且参数类型可为 Map<String, List<Phone>>（对应 { "phone": [...] } 结构）或更通用的 JsonNode。
以下是完整、可运行的解决方案：
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.ArrayList;
import java.util.List;
public class Response {
private String name;
private List<Phone> phoneList = new ArrayList<>();
// ✅ 关键：用 @JsonProperty("phoneList") 拦截整个 phoneList 对象
@JsonProperty("phoneList")
private void setPhoneList(Map<String, List<Phone>> phoneListMap) {
if (phoneListMap != null && phoneListMap.containsKey("phone")) {
this.phoneList = phoneListMap.get("phone");
}
}
// 必须提供默认构造器（Jackson 反序列化要求）
public Response() {}
// 建议添加标准 getter/setter（部分 Jackson 版本需显式访问器）
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public List<Phone> getPhoneList() { return phoneList; }
public void setPhoneList(List<Phone> phoneList) { this.phoneList = phoneList; }
public static class Phone {
private String number;
private Integer code;
public Phone() {} // 默认构造器
// getter/setter 略（实际项目中建议补全）
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; }
}
}使用示例：
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.getPhoneList().size()); // 输出：2✅ 关键注意事项：
- 该 setter 方法必须是 private 或 package-private，且不能有返回值（void）；
- 参数类型 Map<String, List<Phone>> 能精准匹配 { "phone": [...] } 结构；若 JSON 结构更复杂（如含额外字段），推荐改用 JsonNode 参数并手动解析；
- 所有 DTO 类（包括内部类 Phone）必须提供无参构造函数，否则 Jackson 反序列化会抛 InstantiationException；
- 若启用 @JsonCreator 或自定义 Deserializer，需确保与该方法不冲突；
- 此方案仅适用于反序列化（JSON → Java）；若需序列化（Java → JSON）保持相同结构，需额外配置 @JsonGetter 或 @JsonValue，或接受输出为扁平化格式（即 "phoneList": [...]）。
总结：无需引入额外依赖或修改 JSON 源格式，仅通过 Jackson 原生注解 + 灵活的反序列化方法，即可优雅地“穿透”嵌套层级，实现语义更清晰、维护性更强的 DTO 设计。
