二十不惑?，二十不惑解说
chanong
|作者：BAT的乌托邦
原文链接：https://mp.weixin.qq.com/s/VYy1QVeFLRkciymFHueb5w
简介在本文中，我们需要继续讨论Jackson 的“高级”部分：数据绑定jackson-databind 模块。通过深入了解该高级API，您将继续发现我花了很多时间解释的有价值的细节部分。村上春树也说过：“人生没有浪费的经历。”
jackson-databind 包含Jackson 数据处理器的常见“数据绑定函数”和“树模型”。它构建在Streaming API 之上，并使用Jackson 注释进行配置。这是Jackson提供的高级API，其重要性是显而易见的，因为它是开发人员最常用的方法。
Jackson 最初的用例是JSON 数据绑定，但现在只要存在解析器和生成器实现，它就可以用于其他数据格式。但是，请注意，“JSON”一词仍然在许多地方（例如JsonGenerator）的类名称中使用，尽管它实际上并不严格依赖于JSON 格式。
提示：底层流API使用I/O进行输入和输出，因此理论上支持任何格式。
版本协议Jackson 版本：2.11.0 Spring Framework 版本：5.2.6.RELEASE Spring Boot 版本：2.3.0.RELEASE 从本文开始添加新的引导包。
com.fasterxml.jackson.corejackson-databind提示：jackson-databind 模块对jackson-core 和jackson-annotations 具有很强的依赖性。你只需要导入这个包，其他两个就会自动包含进来。
这里需要解释几句话。我知道核心包中也有Jackson 注释，但是我们不应该谈论它吗？因为实际上，只谈论Jackson 注释是没有意义的。毕竟注解需要被数据绑定模块解析，所以我们先完成这个然后再回去。
正文据我所知，很多朋友对Jackson的了解都是从ObjectMapper开始和结束的。因此，作为我们将要接触的第一篇文章，让我们彻底了解整个事情，重点关注应用程序。
功能简介ObjectMapper 是jackson-databind 模块中最重要的类，完成了编码人员进行数据绑定的“几乎所有功能”。这是为用户提供的高层API，最底层依赖流式API来实现读/写。 ObjectMapper提供的主要功能有：
“高级定制”提供了读写JSON（最重要的功能）、序列化/反序列化常规POJO、读写JSON 树模型以及利用功能来使用不同样式的JSON 内容成为可能。可插入的com.fasterxml.jackson.databind.Module 模块扩展/丰富了功能。它还支持“更高级”的对象概念，例如多态泛型、对象识别，并充当更高级（且更强大）的API。对象读取器和对象写入器的“工厂”。 ObjectReader和ObjectWriter底层也是依靠流式API来实现读写的。尽管大部分读/写API是通过ObjectMapper公开的，但一些功能函数仍然仅位于ObjectReader/ObjectWriter中，例如，对于“长序列”读/写功能，ObjectReader#readValues(InputStream)/ObjectWriter#writeValues(OutputStream) ）。这是设计师故意的。由于这种情况很少见，因此无需使用常用产品来应对。
数据绑定数据绑定分为简单数据绑定和完整数据绑定。
《简单数据绑定》：int类型、List、Map等的绑定.@Testpublicvoidtest1() throwsJsonProcessingException{ObjectMapperobjectMapper=newObjectMapper();//简单类型与Map类型的绑定Integerage=objectMapper.readValue('1',int) .class);Mapmap=objectMapper.readValue('{\'name\':\'YourBatman\'}',Map.class);System.out.println(age);System.out.println(map);}运行程序并打印输出。
1{name=YourBatman} “完整数据绑定”：绑定到任何Java Bean 对象.准备POJO。
@Data@NoArgsConstructor@AllArgsConstructorpublicclassperson{privateStringname;privateIntegerage;} 将数据绑定到POJO。
@Testpublicvoidtest2() throwsJsonProcessingException{ObjectMapperobjectMapper=newObjectMapper();personperson=objectMapper.readValue('{\'name\':\'YourBatman\',\'age\':18}',Person.class);System.out。 println(person);}运行程序并打印输出。
(name=YourBatman,age=18)使用ObjectMapper 在应用和开发中，ObjectMapper是迄今为止最常用的，也是使用Jackson的切入点。本文列出了它的使用场景。
提示：树模型在单独的文档中介绍以反映其重要性。
写入（序列化）提供了writeValue()这组方法用于写入数据（任何类型都可以写入）。这就是我们常说的“序列化”。
writeValue(File resultFile, Object value)：写入目标文件writeValue(OutputStream out, Object value)：写入输出流《String writeValueAsString(Object value)：以字符串格式写入，此方法最常用》 writeValueAsBytes (object value) : 写入字节数组byte[]@Testpublicvoidtest3() throwsJsonProcessingException{ObjectMapperobjectMapper=newObjectMapper();System.out.println('------------write simple type ----- - ---- ');System.out.println(objectMapper.writeValueAsString(18));System.out.println(objectMapper.writeValueAsString('YourBatman'));System.out.println(' ----- - ---- 写入集合类型----------');System.out.println(objectMapper.writeValueAsString(Arrays.asList(1,2,3)));System.out.println( objectMapper .writeValueAsString(newHashMap(){{put('zhName','A哥');put('enName','YourBatman');}}));System.out.println('- ----- ---write POJO----------');System.out.println(objectMapper.writeValueAsString(newperson('A哥',18)));}运行程序，输出。
----------编写一个简单类型---------18'YourBatman'------------编写一个集合类型-------- -- --- [1,2,3]{'zhName':'A哥','enName':'YourBatman'}----------编写POJO-------- -- --{'name ':'A哥','age':18} Read(反序列化)提供了一组方法readValue()用于读取数据，通常读取字符串类型。这就是我们常说的“反序列化”。
readValue(String content, Class valueType)：读取为指定类类型的对象。这是最常用的方法。 readValue(String content, TypeReference valueTypeRef)：T表示常用的泛型类型，例如List。与collection/Map相反.Serialized readValue(String content, JavaType valueType): Jackson内置的JavaType类型，后面会详细解释（很少使用） @Testpublicvoidtest4() throwsJsonProcessingException{ObjectMapperobjectMapper=newObjectMapper();System. out.println('----- -----读取简单类型---------');System.out.println(objectMapper.readValue('18',Integer.class) ) ;//抛出错误：JsonParseException 单字符串，解析抛出错误//System.out.println(objectMapper.readValue('YourBatman',String.class));System.out.println('----- - ----读取集合类型-- --------');System.out.println(objectMapper.readValue('[1,2,3]',List .class));System.out . println(objectMapper.readValue('{\ 'zhName\':\'A哥\',\'enName\':\'你的蝙蝠侠\'}',Map.class)); System.out.println('- - --------读取POJO----------');System.out.println(objectMapper.readValue('{\'name\':\'兄弟A\',\ 'age\':18}',person.class));}运行程序并打印输出。
----------读取简单类型------------18----------读取集合类型------------ -[ 1, 2,3]{zhName=A哥，enName=你的蝙蝠侠}------------阅读POJO----------人(姓名=A哥，年龄=18) 不同在排序中，“all”可以写成字符串。反序列化场景具有特殊功能，如示例所示。 “普通”字符串无法反序列化。
泛型消除问题从我们示例中的三个read 方法可以看出，问题还没有结束，就像这个泛型的情况一样。
@Testpublicvoidtest5() throwsJsonProcessingException{ObjectMapperobjectMapper=newObjectMapper();System.out.println('------------读取集合类型----------');Listlist=objectMapper. readValue('[1,2,3]',List.class);Longid=list.get(0);System.out.println(id);} 当我运行程序时，它抛出一个错误。
----------读取集合类型----------java.lang.ClassCastException:java.lang.Integercannotbecasttojava.lang.Longatcn.yourbatman.jackson.core.ObjectMapperDemo.test5(ObjectMapperDemo.java:100 ).异常堆栈指出： Long id=list.get(0); 该语句显示“类型转换异常”。这就是问题的原因：普遍擦除。这是一个参考图（很明显泛型类型是Long ，但它实际�**琁nteger 类型）：
在这类问题中，最好“思考”并问“我可以写[1L，2L，3L]吗？”尽管头脑很活跃，但现实仍然残酷，执行过程中也会出现错误。
com.fasterxml.jackson.core.JsonParseException:Unexpectedcharacter('L'(code76)):wasexpectingcommato SeamlessArrayentriesat[Source:(String)'[1L,2L,3L]';line:1,column:4].这是一个典型的泛型这是一个问题擦除。此问题仅发生在读取（反序列化）时，不会发生在写入时。那么我们该如何解决这个问题呢？
“在解决这个问题之前，我们首先要了解Java的泛型擦除，至少知道两个结论。”
当编译Java 时，“一些”通用信息被保留在字节码指令集之外。泛型接口、类、方法定义和成员变量声明中的所有泛型都是类型保留的。 “其他地方”的信息、通用信息将被删除。这个问题在开发过程中经常出现。为了支持这个理论，A哥针对这个问题提供了两种解决方案供大家参考。
解决方案1：使用成员变量来保留泛型理由：成员变量的泛型类型不会被删除
@Testpublicvoidtest6() throwsJsonProcessingException{ObjectMapperobjectMapper=newObjectMapper();System.out.println('------------读取集合类型----------');Datadata=objectMapper. readValue('{\'ids\':[1,2,3]}',Data.class);Longid=data.getIds().get(0);System.out.println(id);}@lombok 。当DataprivatestaticclassData{privateListids;} 运行程序时，一切都很好。
----------读取集合类型----------1 解决方案2：使用官方推荐的TypeReference。该公式已经考虑了这种一般擦除问题。 TypeReference 使维护泛型类型变得更加容易。这非常有用。
@Testpublicvoidtest7() throwsJsonProcessingException{ObjectMapperobjectMapper=newObjectMapper();System.out.println('------------读取集合类型----------');Listids=objectMapper. readValue('[1,2,3]',newTypeReference(){});Longid=ids.get(0);System.out.println(id);}当我运行程序时，一切都很好。
----------读取集合类型----------1 此解决方案的基本原理是泛型接口/类中的泛型类型不会被删除。
对于泛型擦除情况，解决方案是“保留”泛型类型，使其在反序列化期间不会被蒙蔽。除非你是瞎子，否则杰克逊别无选择，只能使用“通用/默认类型”加载。
从2.10版本开始，JiaFan提供了JsonMapper，它是ObjectMapper的子类。这具有更清晰的语义，特别用于处理JSON 格式。
严格来说，ObjectMapper并不局限于处理JSON格式；例如下面介绍的另一个子类YAMLMapper，用于支持Yaml格式（需要额外的导入包，见下文~）
另外，由于构建ObjectMapper实例是一个高频操作，Jackson也顺应潮流，提供了MapperBuilder构建器（2.10及更高版本）。通过这个结构体，你可以很容易地获得一个ObjectMapper（例如JsonMapper）实例。
@Testpublicvoidtest8() throwsJsonProcessingException{JsonMapperjsonMapper=JsonMapper.builder().configure(JsonReadFeature.ALLOW_SINGLE_QUOTES,true).build();personperson=jsonMapper.readValue('{'name':'YourBatman','age':18}', Person.class);System.out.println(person);} 运行程序（正常输出）。
person(name=YourBatman,age=18) 非常简要地总结了本文的内容，并描述了ObjectMapper 的日常使用、使用它进行读/写以及执行日常功能。Masu。
写作比较简单。全世界都流行一种writeValueAsString(obj) 方法，但是对于读取来说，除了使用readValue(String content, Class valueType) 自动完成数据绑定之外，还需要特别注意。泛型擦除问题：“当反序列化为集合类型（Collection 或Map）时，泛型类型会被擦除。此时您应该使用readValue(String content, TypeReference valueTypeRef) 方法。”
提示：如果您在项目中发现类似objectMapper.readValue(xxx, List.class) 的代码，则可能存在安全风险（但并不一定意味着会报告错误）。