本文介绍如何利用 jackson 的 `@jsontypeinfo` 和 `@jsontypename` 实现泛型 wrapper 类的序列化，使不同 payload 子类（如 payloadfoo/payloadbar）自动作为外层 json 字段名（如 `"foo": { ... }`），无需手动构造 map 或修改类结构。
Jackson 原生不支持直接将泛型类型参数（如 T）的类名作为 JSON 外层字段名，但可通过 多态序列化机制 巧妙达成目标：将 Wrapper<T> 视为抽象容器，配合 @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<T> {
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);? 注意事项：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- @JsonTypeInfo(include = JsonTypeInfo.As.WRAPPER_OBJECT) 是核心——它让 Jackson 将类型名作为包裹对象的字段名，而非嵌入 type 字段；
- @JsonSubTypes 必须显式列出所有子类，无法自动扫描泛型 T 的实际类型（因 Java 泛型擦除）；
- 若 payload 类型过多，建议提取为枚举 + 工厂模式统一管理，避免硬编码 @JsonSubTypes；
- 此方案仅适用于序列化；反序列化需额外配置 @JsonCreator 或自定义反序列化器以还原泛型类型。
最终输出效果完全符合预期：
{
"foo" : {
"soaHeader" : { },
"payload" : {
"foo" : "foo"
}
}
}和
{
"bar" : {
"soaHeader" : { },
"payload" : {
"bar" : "bar"
}
}
}该方案简洁、类型安全，且不侵入业务逻辑，是标准化 SOA 接口响应结构的理想实践。
