如何在 Jackson 中复用自定义对象序列化器处理列表类型？

聖光之護 2026-01-22 00:00:00 次阅读

本文介绍如何无需额外编写列表专用序列化器，即可直接复用已有的 `studentserializer` 序列化 `list` 或 `mutablelist` 类型字段，关键在于使用 `@jsonserialize(contentusing = ...)` 注解指定元素级序列化器。

在 Jackson 中，为单个对象（如 Student）编写自定义序列化器后，无需为 List 单独创建新序列化器。Jackson 提供了灵活的注解机制，允许你将已有对象序列化器“复用”于集合类容器的元素层级。

核心方案是使用 @JsonSerialize(contentUsing = ...) 注解——它专用于标注集合（Collection、List、Set、数组）或 Map 的内容

元素，而非容器本身。这意味着 Jackson 会自动对 students 列表中的每个 Student 实例调用你定义的 StudentSerializer，而无需干预列表的起始/结束结构（如 [ 和 ]），这部分由 Jackson 默认处理。

以你的 Course 类为例，只需添加注解即可：

class Course(
    var id: Long? = null,
    var name: String? = null,
    @JsonSerialize(contentUsing = StudentSerializer::class)
    var students: MutableList = mutableListOf()
)

✅ 此时，当序列化一个 Course 实例时：

id 和 name 按默认规则序列化；
students 列表会被 Jackson 自动识别为 JSON 数组；
列表中每个 Student 对象均交由 StudentSerializer.serialize() 方法处理，完全复用原有逻辑。

⚠️ 注意事项：

contentUsing 仅作用于集合/数组的元素，不可用于普通字段（如 var student: Student?）；后者应直接使用 using = StudentSerializer::class（无 content 前缀）。
确保 StudentSerializer 已通过 SimpleModule 注册（若未全局注册），或启用 @JsonComponent（Spring Boot 场景）。
若需同时支持反序列化，还需配套实现 JsonDeserializer 并用 @JsonDeserialize(contentUsing = ...) 处理列表元素。

总结：复用的关键不在于“重写”，而在于精准定位序列化职责层级——让 Jackson 负责容器结构，让你的序列化器专注单个对象逻辑。这既保持代码简洁性，又确保行为一致性。