Java 中 JSON 字段不固定怎么搞序列化？用好这两个注解就够了！

主要观点总结

本文主要介绍了在使用JSON接口时遇到动态字段的问题，并介绍了如何使用Jackson库中的@JsonAnyGetter和@JsonAnySetter注解来处理这些动态字段。文章还提供了相关的代码示例。

关键观点总结

关键观点1: 动态字段的处理需求

在使用JSON接口时，可能会遇到一些事先并不知道的字段，这些字段会根据上下文动态变化。手动解析和序列化这些字段变得复杂，需要一种优雅的方式来处理。

关键观点2: @JsonAnySetter的作用

使用@JsonAnySetter注解可以标注一个方法，该方法可以接收JSON中没有预定义的属性。当Jackson反序列化JSON时，如果遇到未在Java类中显式定义的字段，它会调用这个方法并将字段名和字段值作为参数传递给它。这个注解非常适合用于处理动态添加的字段。

关键观点3: @JsonAnyGetter的作用

使用@JsonAnyGetter注解可以标注一个方法，该方法返回一个Map或其他结构，包含对象的动态属性（即没有显式定义的字段）。当Jackson序列化对象时，它会将这个Map中的键值对当作额外的JSON属性来序列化。这个注解允许将额外的字段序列化为JSON。

关键观点4: 适用场景

特别适合那些字段不固定、可能需要动态扩展的JSON数据结构，比如配置项、参数列表、插件信息等。

文章预览

最近在处理一个 JSON 接口时，遇到这样一种情况：返回的数据中包含一些我事先并不知道的字段，这些字段会根据上下文动态变化，没办法在 Java 类中提前写死字段名。 起初我以为只能通过 Map 手动解析，但后来发现 Jackson 提供了  @JsonAnyGetter  和  @JsonAnySetter  这两个注解，专门用来处理这种“动态属性”。它们能让我优雅地把未知字段收集起来或者序列化出去，不影响已知字段的正常处理。 不过我在使用过程中也有点疑惑，比如这两个注解的用法顺序有什么讲究？有哪些坑需要避免？这种方式是不是适合所有动态字段的场景？ 开家杂货铺吧 @JsonAnyGetter/@JsonAnySetter ：  像开了一家灵活应对一切需求的「杂货铺」🧃🧂 想象你是个 JSON 杂货铺老板，门口写着招牌：“你有啥，我都能装；你要啥，我都能配。” 你平时会备一些常规商品（字段）， ………………………………