如何使用 Jackson 为泛型包装类动态生成以子类名为键的 JSON 结构

本文介绍如何利用 jackson 的 `@jsontypeinfo` 和 `@jsontypename` 实现泛型 wrapper 类的序列化，使不同 payload 子类（如 payloadfoo/payloadbar）自动作为外层 json 字段名（如 `"foo": { ... }`），无需手动构造 map 或修改类结构。

Jackson 原生不支持直接将泛型类型参数（如 T）的类名作为 JSON 外层字段名，但可通过 多态序列化机制 巧妙达成目标：将 Wrapper 视为抽象容器，配合 @JsonTypeInfo(use = JsonTypeInfo.Id.NAME) 指定类型标识策略，并结合 @JsonTypeName 显式声明各具体 payload 子类的“逻辑名称”，最终由 Jackson 在序列化时将该名称用作根级字段键。

关键实现要点如下：

✅ 在 Wrapper 类上启用多态类型信息
使用 @JsonTypeInfo 指定类型识别方式为 NAME（即使用 @JsonTypeName 值），并配合 @JsonSubTypes 显式注册所有可能的 payload 子类及其对应名称：

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.WRAPPER_OBJECT, // ⚠️ 必须设为 WRAPPER_OBJECT 才能生成外层字段名
    property = "" // 空字符串表示不添加额外 type 字段，仅用字段名体现类型
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = PayloadFoo.class, name = "foo"),
    @JsonSubTypes.Type(value = PayloadBar.class, name = "bar")
})
@Data
public static class Wrapper {
    private SoaHeader soaHeader;
    private T payload;
}

✅ 为每个 payload 子类标注 @JsonTypeName
该注解值即为最终 JSON 的外层字段名：

@JsonTypeName("foo")
@Data
public static class PayloadFoo {
    private String foo;
}

@JsonTypeName("bar")
@Data
public static class PayloadBar {
    private String bar;
}

✅ 确保 ObjectMapper 配置正确
禁用空 Bean 报错，并启用默认缩进提升可读性：

ObjectMapper mapper = new ObjectMapper()
    .configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false)
    .enable(SerializationFeature.INDENT_OUTPUT);

? 注意事项：

• @JsonTypeInfo(include = JsonTypeInfo.As.WRAPPER_OBJECT) 是核心——它让 Jackson 将类型名作为包裹对象的字段名，而非嵌入 type 字段；
• @JsonSubTypes 必须显式列出所有子类，无法自动扫描泛型 T 的实际类型（因 Java 泛型擦除）；
• 若 payload 类型过多，建议提取为枚举 + 工厂模式统一管理，避免硬编码 @JsonSubTypes；
• 此方案仅适用于序列化；反序列化需额外配置 @JsonCreator 或自定义反序列化器以还原泛型类型。

最终输出效果完全符合预期：

先见AI

数据为基，先见未见

下载

{
  "foo" : {
    "soaHeader" : { },
    "payload" : {
      "foo" : "foo"
    }
  }
}

和

{
  "bar" : {
    "soaHeader" : { },
    "payload" : {
      "bar" : "bar"
    }
  }
}

该方案简洁、类型安全，且不侵入业务逻辑，是标准化 SOA 接口响应结构的理想实践。