NON_NULL // 非空
NON_ABSENT // null的不会序列化，但如果类型是AtomicReference，依然会被序列化
NON_EMPTY // null、集合数组等没有内容、空字符串等，都不会被序列化
NON_DEFAULT // 如果字段是默认值，就不会被序列化
CUSTOM // 此时要指定valueFilter属性，该属性对应一个类，用来自定义判断被JsonInclude修饰的字段是否序列化
USE_DEFAULTS // 当JsonInclude在类和属性上都有时，优先使用属性上的注解，此时如果在序列化的get方法上使用了JsonInclude，并设置为USE_DEFAULTS，就会使用类注解的设置
源码下载
- 如果您不想编码，可以在GitHub下载所有源码，地址和链接信息如下表所示(https://github.com/zq2599/blog_demos)：
| 名称 | 链接 | 备注 |
| :-- | :-- | :-- |
| 项目主页 | https://github.com/zq2599/blog_demos | 该项目在GitHub上的主页 |
| git仓库地址(https) | https://github.com/zq2599/blog_demos.git | 该项目源码的仓库地址，https协议 |
| git仓库地址(ssh) | git@github.com:zq2599/blog_demos.git | 该项目源码的仓库地址，ssh协议 |
- 这个git项目中有多个文件夹，本章的应用在jacksondemo文件夹下，如下图红框所示：
- jacksondemo是父子结构的工程，本篇的代码在annotation子工程中，里面的jsoninclude这个package下，如下图：
- 接下来逐个学习这些属性的效果；
ALWAYS
ALWAYS表示全部序列化，如下图，null和空字符串都会序列化：
NON_NULL
NON_NULL好理解，就是值为null就不序列化：
NON_ABSENT
-
NON_ABSENT略为复杂，当实例化的对象有Optional或AtomicReference类型的成员变量时，如果Optional引用的实例为空，用NON_ABSENT能使该字段不做序列化；
-
Optional是java用来优雅处理空指针的一个特性，本文中不做过多说明，请您自行查阅相关文档；
-
要让Jackson支持Optional特性，必须做两件事，首先是在pom.xml中添加以下依赖：
com.fasterxml.jackson.datatype
jackson-datatype-jdk8
2.11.0
- 其次是代码中执行以下设置：
mapper.registerModule(new Jdk8Module());
- 咱们先看看设置成NON_NULL时jackson对Optional和AtomicReference的处理，下面的代码中，Optional和AtomicReference的引用都是空，但还是被序列化出来了：
- 代码不变，将NON_NULL改为NON_ABSENT试试，如下图，可见field2和field3都没有序列化了：
小结NON_ABSENT的效果：
a. 自身为null的字段不会被序列化；
b. Optional类型的字段，如果引用值为null，该字段不会被序列化；
c. AtomicReference类型的字段，如果引用值为null，该字段不会被序列化；
NON_EMPTY
NON_EMPTY好理解，以下情况都不会被序列化：
-
null
-
空字符串
-
空集合
-
空数组
-
Optional类型的，其引用为空
-
AtomicReference类型的，其引用为空
-
演示代码和结果如下图，可见上述场景全部没有被序列化：
NON_DEFAULT
- 设置为NON_DEFAULT后，对保持默认值的字段不做序列化，如下图：
CUSTOM
-
相对其他类型，CUSTOM略为复杂，这个值要配合valueFilter属性一起使用；
-
如下所示，JsonInclude的value等于CUSTOM时，在序列化的时候会执行CustomFilter的equals方法，该方法的入参就是field0的值，如果equals方法返回true，field0就不会被序列化，如果equals方法返回false时field0才会被序列化
@JsonInclude(value = JsonInclude.Include.CUSTOM,
valueFilter = CustomFilter.class)
private String field0;
- 来看看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;
}
}
- 下面贴出完整代码和结果，您就一目了然了：
- 再次强调：valueFilter的equals方法返回true，意味着该字段不会被序列化！！！
USE_DEFAULTS
USE_DEFAULTS的用法也有点绕，咱们通过对比的方法来学习；
- 代码如下所示，在类和成员变量上都有JsonInclude注解，序列化field0的时候，是哪个注解生效呢？：
@JsonInclude(JsonInclude.Include.NON_EMPTY)
static class Test {
@Js
onInclude(JsonInclude.Include.NON_NULL)
private List field0;
public List getField0() { return field0; }
public void setField0(List field0) { this.field0 = field0; }
}
- 把field0设置为空集合，运行代码试试，如果类上的注解生效，那么field0就不会被序列化（NON_EMPTY会过滤掉空集合），如果成员变量上的注解生效，field0就会被序列化（NON_NULL只过滤null，空集合不是null），执行结果如下图，可见是成员变量上的注解生效了：
