jackson学习之五：JsonInclude注解

NON_NULL

NON_NULL好理解，就是值为null就不序列化：

NON_ABSENT

1. NON_ABSENT略为复杂，当实例化的对象有Optional或AtomicReference类型的成员变量时，如果Optional引用的实例为空，用NON_ABSENT能使该字段不做序列化；

2. Optional是java用来优雅处理空指针的一个特性，本文中不做过多说明，请您自行查阅相关文档；

3. 要让Jackson支持Optional特性，必须做两件事，首先是在pom.xml中添加以下依赖：

com.fasterxml.jackson.datatype

jackson-datatype-jdk8

2.11.0

4. 其次是代码中执行以下设置：

mapper.registerModule(new Jdk8Module());

5. 咱们先看看设置成NON_NULL时jackson对Optional和AtomicReference的处理，下面的代码中，Optional和AtomicReference的引用都是空，但还是被序列化出来了：

6. 代码不变，将NON_NULL改为NON_ABSENT试试，如下图，可见field2和field3都没有序列化了：

小结NON_ABSENT的效果：

a. 自身为null的字段不会被序列化；

b. Optional类型的字段，如果引用值为null，该字段不会被序列化；

c. AtomicReference类型的字段，如果引用值为null，该字段不会被序列化；

NON_EMPTY

NON_EMPTY好理解，以下情况都不会被序列化：

1. null

2. 空字符串

3. 空集合

4. 空数组

5. Optional类型的，其引用为空

6. AtomicReference类型的，其引用为空

7. 演示代码和结果如下图，可见上述场景全部没有被序列化：

NON_DEFAULT

1. 设置为NON_DEFAULT后，对保持默认值的字段不做序列化，如下图：

CUSTOM

1. 相对其他类型，CUSTOM略为复杂，这个值要配合valueFilter属性一起使用；

2. 如下所示，JsonInclude的value等于CUSTOM时，在序列化的时候会执行CustomFilter的equals方法，该方法的入参就是field0的值，如果equals方法返回true，field0就不会被序列化，如果equals方法返回false时field0才会被序列化

@JsonInclude(value = JsonInclude.Include.CUSTOM,

valueFilter = CustomFilter.class)

private String field0;

3. 来看看CustomFilter类的代码，如下所示，只有equals方法，可见：null、非字符串、长度大于2这三种情况都返回true，也就是说这三种情况下都不会被序列化：

static class CustomFilter {

@Override

public boolean equals(Object obj) {

// null，或者不是字符串就返回true，意味着不被序列化

if(null==obj || !(obj instanceof String)) {

return true;

}

// 长度大于2就返回true，意味着不被序列化

return ((String) obj).length() > 2;

}

}

4. 下面贴出完整代码和结果，您就一目了然了：

• 再次强调：valueFilter的equals方法返回true，意味着该字段不会被序列化！！！

USE_DEFAULTS

USE_DEFAULTS的用法也有点绕，咱们通过对比的方法来学习；

1. 代码如下所示，在类和成员变量上都有JsonInclude注解，序列化field0的时候，是哪个注解生效呢？：

@JsonInclude(JsonInclude.Include.NON_EMPTY)

static class Test {

@JsonInclude(JsonInclude.Include.NON_NULL)

private List field0;

public List getField0() { return field0; }

public void setField0(List field0) { this.field0 = field0; }

}

2. 把field0设置为空集合，运行代码试试，如果类上的注解生效，那么field0就不会被序列化（NON_EMPTY会过滤掉空集合），如果成员变量上的注解生效，field0就会被序列化（NON_NULL只过滤null，空集合不是null），执行结果如下图，可见是成员变量上的注解生效了：

3. 接下来保持上述代码不变，仅在getField0方法上添加JsonInclude注释，值是USE_DEFAULTS，这样在序列化过程中，调用getField0方法时，就用类注解JsonInclude的值了，即NON_EMPTY：

@JsonInclude(JsonInclude.Include.USE_DEFAULTS)

public List getField0() {

return field0;

}

4. 执行修改后的代码，如下图所示，此时用的成员变量field0上的注解就不生效了，而是类注解生效，导致空集合不被序列化：

小结USE_DEFAULTS的作用如下：

a. 类注解和成员变量注解同时存在时，以成员变量注解为准；

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！