jackson反序列化泛型 jackson反序列化多余的字段

论文深入探讨了在使用Lombok注解的Java类中，Jackson进行JSON反序列化时，布尔类型字段默认值丢失导致NullPointerException的问题。核心问题是布尔包装类型在JSON字段丢失时会被反序列化为null，而解决方法是推荐使用Java原始类型bool ean，它在字段卸载时会自动初始化为false，从而避免了不必要的空指针异常，并简化了数据模型。问题阐述

在java应用中，我们经常结合lombok和jackson库来简化pojo的开发和json的处理。然而，当一个类中包含boolean包装类型的字段时，并相当于设置了默认值（例如private布尔取反= false；），在jackson反序列化命名的json数据时，如果json中缺少该字段，该字段并不会被赋予代码中定义的默认值，而是被反序列化为null。这可能导致后续访问该字段时抛出nullpointerException。

例如，考虑以下类定义：@Data@AllArgsConstructor@ApiModelpublic class RelationEntityTypeFilter { private String relationType； private Listlt；EntityTypegt；entityTypes； private Boolean negate = false； // 期望默认为false}登录后复制

当接收到如{ "relationType"： "Contains"， "entityTypes"： []}这样的JSON时，虽然negate字段在代码中被初始化为false，但反序列化后relationEntityTypeFilter.getNegate()却可能返回null，从而引发异常。根本原因分析

Jackson在进行JSON序列反化时，Java对于对象的字段处理遵循上述规则类型：原始(原始类型)：对于boolean， int，double等原始类型字段，如果JSON中对应的字段缺失，Jackson将其初始化设置为该原始类型的默认值（例如boolean为false，int为0）。这是Java语言规范的一部分。包装类型（Wrapper Types）和引用类型（Reference Types）：ForBoolean， Integer， String其他自定义对象等引用类型字段，如果JSON中对应的字段缺失，Jackson将其反序列化为null。这是因为这些类型是对象，null是其有效的“无值”状态。

在上述问题中，negate字段被定义为Boolean（包装类型）。即使在Java代码中通过= false设置了默认值，这个默认值是在对象构造时由JVM或Lombok的@AllArgsConstructor生成的构造器来设置的。但是，Jackson的反序列化过程是独立于Java对象构造的。当Jackson从JSON解析数据时，如果negate字段不存在，它会直接将negate设置为null，覆盖了Java代码中可能存在的默认初始化。

解决方案

最直接且推荐的解决方案将布尔类型字段从Boolean包装类型更改为boolean原始类型。

当negate字段的类型为boolean时，Jackson会根据其原始类型的值的默认规则进行处理。如果JSON中不包含negate字段，negate将自动被初始化为false，从而避免null值和潜在的NullPointerException。

后面的类定义示例：import lombok.Getter；import lombok.NoArgsConstructor；修改import lombok.Setter；import lombok.ToString；//简化类，仅用于论证布尔字段@NoArgsConstructor // 需要无参构造器以Jackson反序列化@Getter@Setter@ToStringpublic class RelationEntityTypeFilter { // 将 Boolean 类型 boolean 原始类型改为 private boolean negate； }登录后复制

反序列化结果与结果：

使用ObjectMapper进行反序列类型化，观察boolean字段的行为：import com.fasterxml.jackson.databind.ObjectMapper；public class DeserializationDemo { public static void main(String[] args) throws Exception { ObjectMapper mapper = new ObjectMapper()； // 结果1： JSON中缺失字段 String negateIsMissingJson = quot；{ }quot；； RelationEntityTypeFilter filterMissing = mapper.readValue(negateIsMissingJson， RelationEntityTypeFilter.class)； System.out.println(quot；JSON 缺失 negate 字段： quot； filterMissing)； // 示例2： JSON 中显式指定 negate 为 false String negateIsFalseJson = quot；quot；quot； { quot；negatequot； ： false } quot；quot；quot； // 注意这里使用 'false' 而不是 'quot；falsequot；' RelationEntityTypeFilter filterFalse = mapper.readValue(negateIsFalseJson， RelationEntityTypeFilter.class)； System.out.println(quot；JSON 中 negate 明确为 false： quot；filterFalse)； // 示例3： JSON 中明确指定 negate 为 true String negateIsTrueJson = quot；quot；quot； { ”；否定”； ： true

} quot；quot；quot；； RelationEntityTypeFilter filterTrue = mapper.readValue(negateIsTrueJson， RelationEntityTypeFilter.class)； System.out.println(quot；JSON 中 negate 明确为 true： quot；filterTrue)； }}登录后复制

输出：JSON 缺少 negate 字段： RelationEntityTypeFilter(negate=false)JSON 中 negate 明确为 false： RelationEntityTypeFilter(negate=false)JSON中negate明确为true：RelationEntityTypeFilter(negate=true)登录后复制

从输出中可以看出，当JSON中缺少negate字段时，RelationEntityTypeFilter对象的negate字段被正确地反序列化为false，符合预期。注意事项与最佳实践优先使用原始类型：大多数情况下，如果某个字段不需要表示“不存在”或“未知”的状态（即不需要null），且其值域有限的（如true/false），优先使用原始类型（boolean、int、long，这不仅可以节省内存（原始类型需要额外的对象开销），税务队列NullPointerException。当使用包装类型时：只有当字段确实需要表达null的概念时（例如，数据库中修复空的字段，或者在集合中存储布尔值时，因为Java集合不支持原始类型），才应该使用Boolean等包装类型。如果使用包装类型并在JSON字段丢失时有值默认，则需要更复杂的Jackson配置，例如使用@JsonSetter希望配合默认方法或自定义反序列化器。Lombok的@Data与默认值： Lombok的@Data注解包含了@NoArgsConstructor、@Getter、@Setter、@EqualsAndHashCode和@ToString。对于字段的默认值，如果类有自定义构造器，Lombok生成的构造器可能会覆盖字段的默认初始化。但是，Jackson在反序列化时通常会调用无参构造器（如果存在）或通过间接直接设置字段，因此字段的默认值行为主要由Jackson，不是Lombok。API契约：在设计中RESTful API时，明确规定哪些字段是可选的、哪些是必需的。对于可选的布尔字段，如果期望其在未提供时默认为false，那么使用布尔原始类型是最佳做法，它能清晰地表达这种语义。总结在Jackson反序列化过程中处理布尔类型字段的默认值时，关键在于Java原原始类型和包装类型在默认初始化行为上的差异。将布尔包装类型替换为布尔原始类型，是解决JSON字段删除导致NullPointerException的最简洁有效的方法。这不仅简化了代码逻辑，提高了程序的健壮性，也符合Java和Jackson在数据处理上的工作方式。

在设计数据模型时，应优先考虑使用原始类型，而不确实需要表达空语义。

以上就是Jackson反序列化：Lombok与布尔类型字段默认值处理指南的详细内容，更多请关注乐哥常识网其他文章相关文章！