0

0

如何在自定义 Jackson 序列化器中正确序列化嵌套对象的字段

花韻仙語

花韻仙語

发布时间:2026-01-22 14:04:16

|

589人浏览过

|

来源于php中文网

原创

如何在自定义 Jackson 序列化器中正确序列化嵌套对象的字段

当使用自定义 jackson `stdserializer` 处理多态集合(如 `list`)时,若仅调用 `writenullfield()` 会导致子类字段丢失;应改用 `writeobjectfield()` 委托 jackson 默认序列化逻辑,才能完整输出子类的全部字段。

在 Jackson(尤其是 XmlMapper)中实现多态序列化时,一个常见误区是:在自定义序列化器中手动写入字段名但未真正序列化对象内容。例如原代码中使用:

jg.writeNullField(animal.getClass().getSimpleName());

该方法仅生成一个空标签(如 <Dog/>),完全跳过了 Dog 实例自身的序列化流程,因此 breed 和 age 字段自然不会出现。

✅ 正确做法是利用 Jackson 提供的 委托序列化机制 —— 调用 JsonGenerator#writeObjectField(String fieldName, Object value)。此方法会自动触发 Jackson 对 value 的标准序列化逻辑(包括字段发现、注解处理、类型适配等),从而保留 Dog 类中所有可序列化的公共字段(或按 @JsonProperty 配置的字段)。

以下是修复后的 ZooSerializer 完整实现:

歌者PPT
歌者PPT

歌者PPT,AI 写 PPT 永久免费

下载
public class ZooSerializer extends StdSerializer<Zoo> {
    public ZooSerializer() {
        this(null);
    }

    public ZooSerializer(Class<Zoo> t) {
        super(t);
    }

    @Override
    public void serialize(Zoo zoo, JsonGenerator jg, SerializerProvider sp) throws IOException {
        jg.writeStartObject();
        for (Animal animal : zoo.animals) {
            String typeName = animal.getClass().getSimpleName();
            jg.writeObjectField(typeName, animal); // ✅ 关键:委托 Jackson 序列化 animal 实例
        }
        jg.writeEndObject();
    }
}

运行测试后,输出将变为符合预期的 XML 结构:

<Zoo>
  <Dog>
    <breed>Collie</breed>
    <age>6</age>
  </Dog>
</Zoo>

⚠️ 重要注意事项:

  • 此方案依赖 Jackson 的默认 POJO 序列化规则(如字段可见性、@JsonProperty、@JsonIgnore 等),请确保 Dog 等子类字段满足可访问要求(默认 public 字段或配有 getter)。
  • 由于未启用 @JsonTypeInfo(如 @JsonTypeInfo(use = JsonTypeInfo.Id.NAME)),Jackson 在反序列化时无法自动识别 <Dog> 标签对应的具体子类类型。若需反序列化 XML 回 Zoo 对象,必须配套实现自定义 JsonDeserializer<Zoo>,解析 XML 元素名并手动实例化对应子类。
  • 若项目允许,更推荐使用 Jackson 内置的多态支持(如 @JsonTypeInfo + @JsonSubTypes),可避免手写序列化/反序列化器,提升可维护性与健壮性。

总之,writeObjectField() 是连接自定义结构控制与默认序列化能力的关键桥梁——它让你掌控“在哪里写”,而把“怎么写内容”交还给 Jackson,兼顾灵活性与完整性。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1031

2023.08.02

java多态详细介绍
java多态详细介绍

本专题整合了java多态相关内容,阅读专题下面的文章了解更多详细内容。

27

2025.11.27

java多态详细介绍
java多态详细介绍

本专题整合了java多态相关内容,阅读专题下面的文章了解更多详细内容。

27

2025.11.27

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1949

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2119

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1171

2024.11.28

Python异步编程与Asyncio高并发应用实践
Python异步编程与Asyncio高并发应用实践

本专题围绕 Python 异步编程模型展开,深入讲解 Asyncio 框架的核心原理与应用实践。内容包括事件循环机制、协程任务调度、异步 IO 处理以及并发任务管理策略。通过构建高并发网络请求与异步数据处理案例,帮助开发者掌握 Python 在高并发场景中的高效开发方法,并提升系统资源利用率与整体运行性能。

37

2026.03.12

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

136

2026.03.11

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

47

2026.03.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 10.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号