jackson学习之四：WRAP_ROOT_VALUE（root对象）

欢迎访问个人GitHub

https://github.com/zq2599/blog_demos

内容：全部原创文章分类汇总及配套源码，涉及Java、Docker、Kubernetes、DevOPS等；

系列文章汇总

• jackson学习之一：基本信息
• jackson学习之二：jackson-core
• jackson学习之三：经常使用API操做
• jackson学习之四：WRAP_ROOT_VALUE（root对象）
• jackson学习之五：JsonInclude注解
• jackson学习之六：经常使用类注解
• jackson学习之七：经常使用Field注解
• jackson学习之八：经常使用方法注解
• jackson学习之九：springboot整合(配置文件)
• jackson学习之十(终篇)：springboot整合(配置类)

本篇概览

本文是《jackson学习》系列的第四篇，前面学习了经常使用API，能够执行最基本的序列化和反序列化操做，接下来要学习的就是jackson强大的注解能力，本篇要学的是root对象特性，主要内容以下：

1. 关于root对象
2. 测试用的POJO类
3. 序列化实战
4. 反序列化实战

关于root对象（WRAP_ROOT_VALUE）

1. 对于只有id和name两个字段的POJO实例来讲，正常的序列化结果以下：

{
  "id" : 1,
  "name" : "book"
}

2. jackson在序列化时，能够在上述json外面再包裹一层，官方叫作WRAP_ROOT_VALUE，本文中叫作root对象，以下所示，整个json的只有一个键值对，key是aaabbbccc，value内部才是POJO实例的id和name字段的值：

{
  "aaabbbccc" : {
    "id" : 2,
    "name" : "food"
  }
}

提早小结

root对象特性提早作个小结，这样若是您时间有限，仅看这一节便可：

• 先看序列化场景：

1. 执行下面代码，jackson在序列化时会增长root对象：

mapper.enable(SerializationFeature.WRAP_ROOT_VALUE);

2. root对象的key，默认是实例的类名，若是实例有JsonRootName注解，就是该注解的value值；
3. root对象的value以下所示，至关于不支持root对象时的序列化结果：

{
  "id" : 1,
  "name" : "book"
}

• 再看反序列化场景：

1. 执行下面代码，jackson在反序列化时会先解析root对象：

mapper.enable(DeserializationFeature.UNWRAP_ROOT_VALUE);

2. root对象的key，默认是实例的类名，若是实例有JsonRootName注解，就是该注解的value值；
3. root对象的value以下所示，至关于不支持root对象时用来反序列化的json字符串：

{
  "id" : 1,
  "name" : "book"
}

准备两个POJO类

用对比的方式能够更清楚了解JsonRootName的做用，接下来的学习我们准备两个POJO类，一个没有JsonRootName注解，另外一个有JsonRootName注解：

1. 名为Order1.java的，没有JsonRootName注解：

public class Order1 {
    private int id;
    private String name;
	// 省去get、set、toString方法
	...
}

2. 名为Order2.java的，有JsonRootName注解，value值为aaabbbccc：

import com.fasterxml.jackson.annotation.JsonRootName;

@JsonRootName(value = "aaabbbccc")
public class Order2 {
	private int id;
    private String name;
	// 省去get、set、toString方法
	...
}

• 可见Order1和Order2的代码是一致的，惟一的不一样是Order2带有注解JsonRootName；

序列化

1. 须要设置WRAP_ROOT_VALUE属性，jackson才会支持root对象，JsonRootName注解才会发挥做用，设置代码以下：

mapper.enable(SerializationFeature.WRAP_ROOT_VALUE);

2. 写一段代码，在不开启WRAP_ROOT_VALUE属性的时候执行序列化，再开启WRAP_ROOT_VALUE属性执行序列化，对比试试：

public static void main(String[] args) throws Exception {
        // 实例化Order1和Order2
        Order1 order1 = new Order1();
        order1. setId(1);
        order1.setName("book");

        Order2 order2 = new Order2();
        order2. setId(2);
        order2.setName("food");

        // 没有开启WRAP_ROOT_VALUE的时候
        logger.info("没有开启WRAP_ROOT_VALUE\n");
        ObjectMapper mapper1 = new ObjectMapper();
        // 美化输出
        mapper1.enable(SerializationFeature.INDENT_OUTPUT);

        logger.info("没有JsonRootName注解类，序列化结果：\n\n{}\n\n", mapper1.writeValueAsString(order1));
        logger.info("有JsonRootName注解的类，序列化结果：\n\n{}\n\n\n\n", mapper1.writeValueAsString(order2));

        // 开启了WRAP_ROOT_VALUE的时候
        logger.info("开启了WRAP_ROOT_VALUE\n");
        ObjectMapper mapper2 = new ObjectMapper();
        // 美化输出
        mapper2.enable(SerializationFeature.INDENT_OUTPUT);
        // 序列化的时候支持JsonRootName注解
        mapper2.enable(SerializationFeature.WRAP_ROOT_VALUE);

        logger.info("没有JsonRootName注解类，序列化结果：\n\n{}\n\n", mapper2.writeValueAsString(order1));
        logger.info("有JsonRootName注解的类，序列化结果：\n\n{}", mapper2.writeValueAsString(order2));
    }

3. 执行结果以下，JsonRootName在序列化时的做用一目了然：指定了root对象的key：

反序列化（默认设置）

1. 在没有作任何设置的时候，下面这个字符串用来反序列化成Order2对象，会成功吗？

{
  "id" : 2,
  "name" : "food"
}

2. 试了下是能够的：

3. 那下面这个字符串能反序列化成Order2对象吗？

{
  "aaabbbccc" : {
    "id" : 2,
    "name" : "food"
  }
}

4. 代码和结果以下图所示，反序列化时jackson并不认识aaabbbccc这个key，由于jackson此时并不支持root对象：

• 小结：默认状况下，反序列化时json字符串不能有root对象；

反序列化（开启UNWRAP_ROOT_VALUE属性）

1. 若是开启了UNWRAP_ROOT_VALUE属性，用于反序列化的json字符串就必需要有root对象了，开启UNWRAP_ROOT_VALUE属性的代码以下：

mapper.enable(DeserializationFeature.UNWRAP_ROOT_VALUE);

2. 代码和结果以下图，可见带有root对象的json字符串，能够反序列化成功，root对象的key就是JsonRootName注解的value属性：

3. 值得注意的是，上述json字符串中，root对象的key为aaabbbccc，这和Order2的JsonRootName注解的value值是一致的，若是不一致就会反序列化失败，以下图：

• 至此，jackson的WRAP_ROOT_VALUE特性就学习完成了，在web开发时这是个很经常使用的功能，用于在最外面包裹一层，以便总体上添加额外的内容，但愿能给您带来参考；

你不孤单，欣宸原创一路相伴

1. Java系列
2. Spring系列
3. Docker系列
4. kubernetes系列
5. 数据库+中间件系列
6. DevOps系列

欢迎关注公众号：程序员欣宸

微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界...
https://github.com/zq2599/blog_demos