本文介绍如何通过 Jackson 的 @JsonCreator 和 @JsonProperty 注解，在反序列化时自动将嵌套结构（如 field3.type）扁平化为外层字段（如 field3），全程无需自定义反序列化器或运行时解包。
本文介绍如何通过 jackson 的 `@jsoncreator` 和 `@jsonproperty` 注解，在反序列化时自动将嵌套结构（如 `field3.type`）扁平化为外层字段（如 `field3`），全程无需自定义反序列化器或运行时解包。
在处理第三方 API 或遗留 JSON 数据时，常遇到深层嵌套结构（例如 "field3": {"type": {"f1":"v1","f2":"v2"}}），而业务模型期望的是扁平形式（"field3": {"f1":"v1","f2":"v2"}）。Jackson 提供了声明式解决方案——利用 @JsonCreator 构造器注入 + @JsonProperty 字段映射，即可在反序列化阶段完成“逻辑扁平化”，避免侵入性代码或运行时对象遍历。
核心思路是：为嵌套目标类（如 Field3Class）定义一个带参构造器，并用 @JsonCreator 标记；参数通过 @JsonProperty("type") 直接绑定原始 JSON 中的嵌套对象，再在构造器内提取其字段并赋值给当前类成员。
以下为完整可运行示例：
import com.fasterxml.jackson.annotation.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.IOException;
public class JsonFlatteningExample {
static final ObjectMapper objectMapper = new ObjectMapper();
public static class Flattened {
public String field1;
public String field2;
public Field3Class field3;
}
public static class Field3Class {
public String f1;
public String f2;
@JsonCreator
public Field3Class(@JsonProperty("type") Type type) {
if (type != null) {
this.f1 = type.f1;
this.f2 = type.f2;
}
}
// 内部嵌套类，对应原始 JSON 中的 "type" 对象
public static class Type {
public String f1;
public String f2;
}
}
public static void main(String[] args) throws IOException {
String json = """
{
"field1":"value1",
"field2":"value2",
"field3": {
"type": {
"f1":"v1",
"f2":"v2"
}
}
}
""";
Flattened result = objectMapper.readValue(json, Flattened.class);
System.out.println(objectMapper.writeValueAsString(result));
// 输出: {"field1":"value1","field2":"value2","field3":{"f1":"v1","f2":"v2"}}
}
}
✅ 关键要点说明：
- @JsonCreator 告诉 Jackson 使用该构造器创建实例，而非默认无参构造器；
- @JsonProperty("type") 精确指定 JSON 中键名为 "type" 的对象作为构造器参数；
- Jackson 自动将 "type" 对应的子对象反序列化为 Type 类型，再由你控制如何映射到 Field3Class 的字段；
- 无需 @JsonIgnoreProperties、@JsonUnwrapped 或自定义 JsonDeserializer，完全基于标准注解；
- 若 "type" 可能为 null，建议在构造器中添加空值检查（如示例所示），提升健壮性。
⚠️ 注意事项：
- 此方案适用于已知且固定嵌套层级的场景（如本例中 field3 → type）；若嵌套深度动态变化，需改用 JsonNode 手动遍历或编写通用反序列化器；
- @JsonCreator 构造器必须为 public，且参数需有明确的 @JsonProperty 注解（Jackson 2.12+ 支持隐式名称推断，但显式标注更可靠）；
- 所有参与反序列化的类及字段均需为 public 或提供 public getter/setter（本例采用 public 字段，简洁适用于 DTO 场景）。
通过这种声明式扁平化，你既能保持数据模型的语义清晰（Field3Class 直接表达业务含义），又能无缝兼容不规范的嵌套 JSON 输入，是 Jackson 高级用法中兼顾简洁性与可维护性的典型实践。
