前言

json是我们现代互联网程序最常用的交互格式,是否你在工作中会遇到前端说字段不一致需要改的需求,是否遇到过数据库字段名与javaBean的规范不同,是否遇到过json与javaBean相互转换时因为需求写的土匪代码,这些都可以用Jackson完成,我们经常和json打交道,而Jackson就是帮助我们更好的处理json的框架,SpringBoot默认自带,还有一款Fastjson,阿里开源的,国内这两种用的比较多,我选择了Jackson,老牌稳定。

先来了解两个概念:

  1. JSON序列化:Object -> JSONString
  2. JSON反序列化:JSONString -> Object

Jackson库介绍

Jackson库有两个核心类:​ObjectMapper​​​和​​JsonNode​​。

​​ObjectMapper​​​类是Jackson库中最重要的类,它提供了序列化和反序列化Java对象与JSON之间的转换。​​ObjectMapper​​类的实例是线程安全的,可以在多线程环境中共享。

​​JsonNode​​​类是一个抽象类,它代表了一个JSON节点。​​JsonNode​​​类有多个子类,例如​​ObjectNode​​​、​​ArrayNode​​​、​​ValueNode​​​等,分别对应JSON中的对象、数组和值。​​JsonNode​​类提供了方便的方法来读取JSON节点的值。

注解

注解是我们最常用的方式,直接选择常用的开搞,全注解 http://https://www.baeldung.com/jackson-annotations

适用序列化和反序列化

@JsonProperty

@JsonProperty 序列化与反序列化别名,作用于属性上

  • @JsonProperty.value: 要使用的名称(别名)
  • @JsonProperty.index:要使用的物理索引,如果数据格式(JSON 除外)是基于索引的 默认值-1
  • @JsonProperty.defaultValue: 定义为元数据的文本默认值。注意:核心数据绑定不使用这个值;它目前只暴露给扩展模块。
  • @JsonProperty.required: 序列化与反序列化时候属性是否必须要有,如果为true没有的话会抛出异常,默认值 false

@JsonFormat

  • @JsonFormat 日期、时间、数字,序列化与反序列化
  • @JsonFormat.pattern:用于指定日期、时间、数字等的格式模式。例如,"yyyy-MM-dd" 表示日期格式为 "年-月-日"。默认为空字符串 ""。
  • @JsonFormat.shape:用于指定属性的序列化和反序列化形状。默认为 JsonFormat.Shape.ANY。常用的取值包括:

    JsonFormat.Shape.STRING:将属性序列化为字符串。

    JsonFormat.Shape.NUMBER:将属性序列化为数字。

    JsonFormat.Shape.ARRAY:将属性序列化为数组。

    JsonFormat.Shape.OBJECT:将属性序列化为对象。
  • @JsonFormat.locale:用于指定地区(Locale),在日期、时间格式化时可能会用到。默认为 JsonFormat.DEFAULT_LOCALE,系统默认地区
  • @JsonFormat.timezone:用于指定时区,对于日期和时间的处理往往与时区有关。默认为空字符串 "",系统默认时区
  • @JsonFormat.patternLocale:用于指定日期、时间格式模式的地区(Locale)。默认为 JsonFormat.DEFAULT_LOCALE,通常是 Java 虚拟机默认的地区(Locale)。
  • @JsonFormat.lenient:用于指定是否允许宽松的解析,例如接受部分格式不符合模式的输入。默认为 false

如果将 lenient 属性设置为 true,则在反序列化过程中可以允许一些非严格匹配的输入。例如,如果输入的日期字符串为 "2021-01",它并不符合完整的 "yyyy-MM-dd" 格式,但由于 lenient 设置为 true,Jackson 可以进行宽松解析,将其解释为 2021 年 1 月的某个日期(如 2021 年 1 月 1 日)。

@JsonUnwrapped

@JsonUnwrapped 序列与反序列化时对象属性是否需要展开在父对象上,Map不适用,Map用@JsonAnyGetter

例如:

public class User {
private String name;
@JsonUnwrapped
private Address address;
}
public class Address {
private String street;
private String city;
}

结果

{
"name": "John",
"street": "123 Main St",
"city": "New York"
}

适用序列化

@JsonPropertyOrder

@JsonPropertyOrder 序列化时排列排列顺序

  • @JsonProperty.value: 属性名
  • @JsonProperty.alphabetic:是否按字母顺序排列

@JsonIgnore

@JsonIgnore 序列化时忽略的属性,作用于属性上

@JsonIgnoreProperties

@JsonIgnoreProperties 序列化忽略的属性集合,作用于类上

  • @JsonIgnoreProperties.value :在序列化时,忽略列出的属性
  • @JsonIgnoreProperties.ignoreUnknown:在反序列化时,忽略没有 getter/setter 的属性

@JsonIgnoreType

@JsonIgnoreType 忽略注释类型的所有属性,作用于类上

@JsonInclude

@JsonInclude 序列化时,值为规则这个属性隐藏,作用于类和属性上

  • @JsonInclude.value:规则 默认值JsonInclude.Include.ALWAYS
  • @JsonInclude.content:集合类型属性规则 默认值JsonInclude.Include.ALWAYS

    JsonInclude.Include.ALWAYS:始终包含属性,即使属性值为 null。

    JsonInclude.Include.NON_NULL:仅在属性值不为 null 时才包含属性。

    JsonInclude.Include.NON_DEFAULT:仅在属性值与默认值不相等时才包含属性。

    JsonInclude.Include.NON_EMPTY:仅在属性值不为 null 且不为空(例如空字符串或空集合)时才包含属性。

@JsonAnyGetter

@JsonAnyGetter 注释允许灵活地将Map属性用作标准属性平铺在父对象上,适用序列化,作用于get方法上,返序列化用@JsonAnySetter

例如:

@Data
public class OrderDetails {
Map<String, String> tempMap = new HashMap<String, String>(){{
put("temp","temp");
put("temp1","temp1");
}}; @JsonAnyGetter
public Map<String, String> getTempMap() {
return tempMap;
}
}

结果

{
"temp": "temp",
"temp1": "temp1"
}

@JsonGetter

@JsonGetter 序列化时别名,作用于get方法上

@JsonView

@JsonView 序列与反序列化 分组选择需要显示的属性

例子:

@Data
public class OrderDetails {
public interface UserSimpleView {};
public interface UserDetailView {}; @JsonView({UserSimpleView.class,UserDetailView.class})
String name = "yues";
@JsonView(UserDetailView.class)
String password = "123";
}

结果:

@JsonView(OrderDetails.UserSimpleView.class)
@RequestMapping("/add")
public Object add(@RequestBody OrderDetails orderDetails) {
// {
// "name": "yues"
// }
return orderDetails;
}
@JsonView(OrderDetails.UserDetailView.class)
@RequestMapping("/add")
public Object add(@RequestBody OrderDetails orderDetails) {
// {
// "name": "yues",
// "password": "123"
// }
return orderDetails;
}

@JsonRootName

@JsonRootName 包一层

例子:

@Data
@JsonRootName("user")
public class OrderDetails {
String name = "yues";
}
{
"user": {
"name": "yues"
},
}

@JsonSerialize

@JsonSerialize 自定义序列化器

  • using:指定要使用的自定义序列化器类。该参数接受一个实现了 Jackson 的 JsonSerializer 接口的类。您可以编写自定义的序列化器类来控制属性的序列化行为。

    值为null不会执行

  • as:在序列化过程中,指定使用的序列化器类型。默认情况下,Jackson 会根据属性的类型来选择合适的序列化器。使用 as 参数可以强制指定序列化器的类型,覆盖默认的选择。
  • keyUsing:在序列化过程中,指定用于序列化属性键(如果属性是一个 Map 或类似结构的键值对)的自定义序列化器。该参数接受一个实现了 Jackson 的 JsonSerializer 接口的类。
  • contentUsing:在序列化过程中,指定用于序列化属性值(如果属性是一个 Collection 或类似结构的集合)的自定义序列化器。该参数接受一个实现了 Jackson 的 JsonSerializer 接口的类。
  • nullsUsing:在序列化过程中,指定用于处理属性值为 null 的自定义序列化器。该参数接受一个实现了 Jackson 的 JsonSerializer 接口的类。通过设置 nullsUsing 参数,您可以定义在属性值为 null 时应该采取的序列化行为。

反序列化

@JsonSetter

@JsonGetter 反序列化时别名,作用于set方法上

@JsonAlias

@JsonAlias 反序列化时别名,可以应用于类的属性上且可以指定多个

@JsonDeserialize

@JsonDeserialize 自定义反序列化器

  • using:指定要使用的自定义反序列化器类。该属性接受一个实现了 Jackson 的 JsonDeserializer 接口的类。您可以编写自定义的反序列化器类来控制属性的反序列化行为。
  • contentUsing:在反序列化过程中,指定用于处理属性值(如果属性是一个 Collection 或类似结构的集合)的自定义反序列化器。该属性接受一个实现了 Jackson 的 JsonDeserializer 接口的类。
  • keyUsing:在反序列化过程中,指定用于处理属性键(如果属性是一个 Map 或类似结构的键值对)的自定义反序列化器。该属性接受一个实现了 Jackson 的 JsonDeserializer 接口的类。
  • contentAs:在反序列化过程中,指定用于处理属性值(如果属性是一个 Collection 或类似结构的集合)的类型。通过设置 contentAs 属性,您可以强制 Jackson 使用指定的类型进行属性值的反序列化。

自定义注解

例子

@Retention(RetentionPolicy.RUNTIME)
@JacksonAnnotationsInside
@JsonInclude(Include.NON_NULL)
@JsonPropertyOrder({ "name", "id", "dateCreated" })
@JsonDeserialize //自定义反序列化
@@JsonSerialize //自定义序列化
public @interface CustomAnnotation {}

不用注解ObjectMapper对象

以上的注解都可以使用ObjectMapper对象来配置,先有ObjectMapper才有的这些注解,上面的注解都是使用ObjectMapper来完成的,在SpringBoot中我们还可以用ObjectMapper Bean来达到全局配置,当然也可以用配置文件。在日常的开发工作中,我们经常全局制定日期格式、驼峰_转换等等。

这里就不多做使用ObjectMapper来详细说,贴一些常用的方法吧

ObjectMapper mapper = new ObjectMapper()
mapper.enable(序列化配置);
mapper.configure(反序列化配置);
// 将字符串、byte[]转换为对象 序列化
mapper.readValue(jsonString, User.class);
// 此方法更灵活,可以只将用户感兴趣的Json串信息值提取出来 序列化
mapper.readTree(test); // 将对象转换为json字符串 反序列化
mapper.writeValueAsString(user);
// 将对象转换为byte 反序列化
mapper.writeValueAsBytes(user)

Jackson前后端开发模式必备json利器的更多相关文章

  1. 淘宝玉伯引发Web前后端研发模式讨论

    淘宝玉伯是是前端基础类库 Arale 的创始人,Arale 基于 SeaJS 和 jQuery.不久前,淘宝玉伯在 Github 的 Arale 讨论页面上抛出了自己对于Web 前后端研发模式的思考. ...

  2. ABP开发框架前后端开发系列---(14)基于Winform的ABP快速开发框架

    前面介绍了很多ABP系列的文章,一步一步的把我们日常开发中涉及到的Web API服务构建.登录日志和操作审计日志.字典管理模块.省份城市的信息维护.权限管理模块中的组织机构.用户.角色.权限.菜单等内 ...

  3. ABP开发框架前后端开发系列---(3)框架的分层和文件组织

    在前面随笔<ABP开发框架前后端开发系列---(2)框架的初步介绍>中,我介绍了ABP应用框架的项目组织情况,以及项目中领域层各个类代码组织,以便基于数据库应用的简化处理.本篇随笔进一步对 ...

  4. ABP开发框架前后端开发系列---(2)框架的初步介绍

    在前面随笔<ABP开发框架前后端开发系列---(1)框架的总体介绍>大概介绍了这个ABP框架的主要特点,以及介绍了我对这框架的Web API应用优先的一些看法,本篇继续探讨ABP框架的初步 ...

  5. ABP开发框架前后端开发系列---(10)Web API调用类的简化处理

    在较早期的随笔<ABP开发框架前后端开发系列---(5)Web API调用类在Winform项目中的使用>已经介绍了Web API调用类的封装处理,虽然这些调用类我们可以使用代码生成工具快 ...

  6. ABP开发框架前后端开发系列---(5)Web API调用类在Winform项目中的使用

    在前面几篇随笔介绍了我对ABP框架的改造,包括对ABP总体的介绍,以及对各个业务分层的简化,Web API 客户端封装层的设计,使得我们基于ABP框架的整体方案越来越清晰化, 也越来越接近实际的项目开 ...

  7. ABP开发框架前后端开发系列---(12)配置模块的管理

    一般来说,一个系统或多或少都会涉及到一些系统参数或者用户信息的配置,而ABP框架也提供了一套配置信息的管理模块,ABP框架的配置信息,必须提前定义好配置的各项内容,然后才能在系统中初始化或者通过接口查 ...

  8. ABP开发框架前后端开发系列---(16)ABP框架升级最新版本的经验总结

    有一小段时间没有持续升级ABP框架了,最近就因应客户的需要,把ABP框架进行全面的更新,由于我们应用的ABP框架,基础部分还是会使用官方的内容,因此升级的时候需要把官方基础ABP的DLL进行全面的更新 ...

  9. Spring Cloud实战 | 最八篇:Spring Cloud +Spring Security OAuth2+ Axios前后端分离模式下无感刷新实现JWT续期

    一. 前言 记得上一篇Spring Cloud的文章关于如何使JWT失效进行了理论结合代码实践的说明,想当然的以为那篇会是基于Spring Cloud统一认证架构系列的最终篇.但关于JWT另外还有一个 ...

  10. AngularJS中在前后端分离模式下实现权限控制 - 基于RBAC

    一:RBAC 百科解释: 基于角色的访问控制(Role-Based Access Control)作为传统访问控制(自主访问,强制访问)的有前景的代替受到广泛的关注.在RBAC中,权限与角色相关联,用 ...

随机推荐

  1. Spring AOP面向切面编程案例 (注解驱动开发)

    AOP(动态代理):指在程序运行期间动态的将某段代码切入到指定方法指定位置进行运行的编程方式:[1]导入 aop 模块:Spring AOP:(spring-aspects):[2]定义一个业务逻辑类 ...

  2. MySQL高可用架构-MMM、MHA、MGR、分库分表

    总结 MMM是是Perl语言开发的用于管理MySQL主主同步架构的工具包.主要作用:管理MySQL的主主复制拓扑,在主服务器失效时,进行主备切换和故障转移. MMM缺点:故障切换可能会丢事务(主备使用 ...

  3. java多线程基础小白指南--关键字识别(start,run,sleep,wait,join,yield)

    在学习java多线程基础上,会遇到几个关键字,理解并识别它们是掌握多线程的必备知识,下面,我将通过源码或者程序演示给出我对这几个关键字的理解,如果有不同意见,欢迎在评论区或者发私信与我探讨. 一.st ...

  4. 使用dataX收获的教训

    首先是安装dataX,安装非常简单,只需下载对应的压缩包即可. 下载地址:https://github.com/alibaba/DataX 首先我出现的第一个错误:命令提示符界面出现出现乱码. 解决方 ...

  5. MySQL相关知识点思维导图整理

    MySQL相关知识点思维导图整理 Xmind思维导图下载地址: 蓝奏云:https://shuihan.lanzoui.com/iXZw7frkn5a

  6. yolov5训练自己的数据集

    1.安装cuda 可以先看看自己的 显卡信息,支持哪个cuda版本 cuda下载地址:https://developer.nvidia.com/cuda-toolkit-archive 我的RTX30 ...

  7. Semantic Kernel 入门系列:🥑突破提示词的限制

    无尽的上下文 LLM的语言理解和掌握能力在知识内容的解读和总结方面提供了强大的能力. 但是由于训练数据本身来自于公共领域,也就注定了无法在一些小众或者私有的领域能够足够的好的应答. 因此如何给LLM ...

  8. Yum安装svn及配置

    svn配置 1.安装svn服务器端 yum install subversion 从镜像下载安装svn服务器端 cd /usr/local/ //进入目录,准备创建svn目录 mkdir svn // ...

  9. PHP读取XML文件的三种方式

    一  用  simplexml_load_file 读取xml文件 <?php $xml_array=simplexml_load_file('person.xml'); //将XML中的数据, ...

  10. C++核心知识回顾(函数&参数、异常、动态分配)

    复习C++的核心知识 函数与参数 传值参数.模板函数.引用参数.常量引用参数 传值参数 int abc(int a,int b,int c) { return a + b * c; } a.b.c是函 ...