本文介绍如何通过 Jackson 的 @JsonCreator 和 @JsonProperty 注解，在反序列化时自动将嵌套结构（如 field3.type）扁平化为外层字段（field3），全程无需手动解析或修改原始 JSON。

本文介绍如何通过 jackson 的 `@jsoncreator` 和 `@jsonproperty` 注解，在反序列化时自动将嵌套结构（如 `field3.type`）扁平化为外层字段（`field3`），全程无需手动解析或修改原始 json。

在实际开发中，常遇到服务端返回的 JSON 存在冗余嵌套层级（例如 "field3": {"type": {"f1":"v1","f2":"v2"}}），而业务逻辑更期望直接操作扁平后的结构（即 "field3": {"f1":"v1","f2":"v2"}）。Jackson 原生不支持自动“路径映射式”扁平化，但可通过自定义反序列化逻辑 + 构造器注解优雅实现——核心在于利用 @JsonCreator 指定带参构造器，并用 @JsonProperty 显式绑定嵌套路径中的子字段。

以下是一个完整、可运行的示例：

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 + @JsonProperty("type") 将嵌套对象 "type" 直接注入构造器
        @JsonCreator
        public Field3Class(@JsonProperty("type") Type type) {
            if (type != null) {
                this.f1 = type.f1;
                this.f2 = type.f2;
            }
        }

        // 内部类仅用于接收原始嵌套结构，不暴露给上层 API
        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 标记的构造器会接管 Field3Class 的反序列化过程，替代默认无参构造 + setter 模式；
• @JsonProperty("type") 明确告诉 Jackson：JSON 中 "field3" 下的 "type" 字段应被解析为 Type 类型并传入该构造器；
• 在构造器内部完成字段提取与赋值，实现逻辑层面的“扁平化”，对外保持 Field3Class 接口简洁；
• 无需编写自定义 Deserializer，也无需修改原始 JSON 或预处理字符串，完全通过注解驱动。

⚠️ 注意事项：

• 若 field3 中可能不存在 "type" 字段，请在构造器中添加空值判断（如示例所示），避免 NullPointerException；
• 此方案适用于单层嵌套提取（如 a.b.c → a.c），多级深度嵌套需逐层定义中间类；
• 所有参与反序列化的类及字段建议显式声明 public 或提供 getter/setter，确保 Jackson 可访问性；
• 如需双向支持（序列化时也输出扁平结构），可配合 @JsonUnwrapped 或自定义序列化器，但本场景仅聚焦反序列化扁平化。

该方法兼顾简洁性与可维护性，是 Jackson 生态中实现轻量级结构适配的推荐实践。