老版本的Jackson使用的包名为org.codehaus.jackson,而新版本使用的是com.fasterxml.jackson

Jackson主要包含了3个模块:

  • jackson-core
  • jackson-annotations
  • jackson-databind
    其中,jackson-annotations依赖于jackson-core,jackson-databind又依赖于jackson-annotations。

Jackson有三种方式处理Json:

  1. 使用底层的基于Stream的方式对Json的每一个小的组成部分进行控制
  2. 使用Tree Model,通过JsonNode处理单个Json节点
  3. 使用databind模块,直接对Java对象进行序列化和反序列化

通常来说,我们在日常开发中使用的是第3种方式,有时为了简便也会使用第2种方式,比如你要从一个很大的Json对象中只读取那么一两个字段的时候,采用databind方式显得有些重,JsonNode反而更简单。

使用ObjectMapper

本文的例子以jackson-databind-2.9.4为例。
创建Person类如下:

public class Person {
private String name;
private String address;
private String mobile; public String getName() {
return name;
} public void setName(String name) {
this.name = name;
} public String getAddress() {
return address;
} public void setAddress(String address) {
this.address = address;
} public String getMobile() {
return mobile;
} public void setMobile(String mobile) {
this.mobile = mobile;
}
}

序列化一个Person对象:

   public static void main(String[] args) throws IOException {
ObjectMapper objectMapper = new ObjectMapper();
Person person = new Person();
person.setName("davenkin");
person.setAddress("");
System.out.println(objectMapper.writeValueAsString(person));
}

返回结果:

{"name":"davenkin","address":"","mobile":null}

在默认情况下,ObjectMapper在序列化时,将所有的字段一一序列化,无论这些字段是否有值,或者为null。

另外,序列化依赖于getter方法,如果某个字段没有getter方法,那么该字段是不会被序列化的。由此可见,在序列化时,OjbectMapper是通过反射机制找到了对应的getter,然后将getter方法对应的字段序列化到Json中。请注意,此时ObjectMapper并不真正地检查getter对应的属性是否存在于Person对象上,而是通过getter的命名规约进行调用,比如对于getAbc()方法:

 public String getAbc(){
return "this is abc";
}

即便Person上没有abc属性,abc也会被序列化:

{"name":"davenkin","address":"","mobile":null,"abc":"this is abc"}

反序列化一个Json字符串,其中少了一个mobile字段:

public static void main(String[] args) throws IOException {
ObjectMapper objectMapper = new ObjectMapper();
Person person = objectMapper.readValue("{\"name\":\"davenkin\",\"address\":\"\"}", Person.class); System.out.println("name: " + person.getName());
System.out.println("address: " + person.getAddress());
System.out.println("mobile: " + person.getMobile());
}

输出:

name: davenkin
address:
mobile: null

可以看出,少了mobile字段,程序依然正常工作,只是mobile的值为null。

另外,如果我们向Json中增加一个Person中没有的字段:

  public static void main(String[] args) throws IOException {
ObjectMapper objectMapper = new ObjectMapper();
Person person = objectMapper.readValue("{\"name\":\"davenkin\",\"address\":\"\",\"mobile\":null,\"extra\":\"extra-value\"}", Person.class); System.out.println("name: " + person.getName());
System.out.println("address: " + person.getAddress());
System.out.println("mobile: " + person.getMobile());
}

此时运行程序将报错:

Exception in thread "main" com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:
Unrecognized field "extra" (class com.shell.b2b.factory.model.Person), not marked as ignorable (3 known properties: "mobile", "name", "address"])

表示在Person对象上找不到对应的extra属性,但是如果我们在Person上增加一个空的setter:

    public void setExtra(String extra) {
}

那么此时运行成功,由此可见OjbectMapper是通过反射的机制,通过调用Json中字段所对应的setter方法进行反序列化的。并且此时,依赖于Person上有默认构造函数。

综上,在默认情况下(即不对ObjectMapper做任何额外配置,也不对Java对象加任何Annotation),ObjectMapper依赖于Java对象的默认的无参构造函数进行反序列化,并且严格地通过getter和setter的命名规约进行序列化和反序列化。

去除getter和setter

纯粹地为了技术方面的原因而添加getter和setter是不好的,可以通过以下方式去除掉对getter和setter的依赖:

objectMapper.setVisibility(ALL, NONE)
.setVisibility(FIELD, ANY);

ObjectMapper将通过反射机制直接操作Java对象上的字段。

此时创建Person如下:

public class Person {
private String name;
private String address;
private String mobile; public Person(String name, String address, String mobile) {
this.name = name;
this.address = address;
this.mobile = mobile;
} }

序列化Person:

public static void main(String[] args) throws IOException {
ObjectMapper objectMapper = new ObjectMapper();
objectMapper.setVisibility(ALL, NONE)
.setVisibility(FIELD, ANY);
Person person = new Person("name", "address", "mobile");
System.out.println(objectMapper.writeValueAsString(person)); }

然而,此时反序列化的时候报错:

Exception in thread "main" com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Cannot construct instance of `com.shell.b2b.factory.model.Person` (no Creators, like default construct, exist): cannot deserialize from Object value (no delegate- or property-based Creator)

这是因为ObjectMapper在为字段设值之前,无法初始化Person对象,此时有两种解决方式:

  1. 为Person增加默认构造函数:
private Person() {
}

请注意,此时请将该构造函数设置为private的,因为我们不想因为纯技术原因而向外暴露一个会将Person类置于非法状态的构造函数(一个没有名字的Person还有什么用?)。

  1. 在已有构造函数上加上@JsonCreator注解,通常与@JsonProperty一起使用:
    @JsonCreator
public Person(@JsonProperty("name") String name,
@JsonProperty("address") String address,
@JsonProperty("mobile") String mobile) {
this.name = name;
this.address = address;
this.mobile = mobile;
}

忽略字段

@JsonIgnore用于字段上,表示该字段在序列化和反序列化的时候都将被忽略。

@JsonIgnoreProperties主要用于类上:

@JsonIgnoreProperties(value = {"mobile","name"},ignoreUnknown = true)

表示对于mobile和name字段,反序列化和序列化均忽略,而对于Json中存在的未知字段,在反序列化时忽略,ignoreUnknown不对序列化起效。

序列化时排除null或者空字符串

@JsonInclude(JsonInclude.Include.NON_NULL)
public class Person {

表示在序列化Person时,将值为null的字段排除掉。

@JsonInclude(JsonInclude.Include.NON_EMPTY)
public class Person {

表示在序列化Person时,将值为null的字段或者空的字符串字段排除掉。

用某个方法的返回值序列化整个对象

有时我们并不想讲对象的所有字段都序列化,而是希望用一个方法的返回值来序列化,比如toString()方法,此时可以用@JsonValue

@JsonValue
public String toString(){
return "someValue";
}

此时整个对象在序列化后的值将变为“someValue”,需要注意的是,这种方式下,在反序列化时也需要有响应的机制。

Java 8 Data/Time API支持

Java 8中引入了全新的时间处理API,比如在多数情况下我们将使用Instant来表示某个事件发生的时间,Instant取代了之前的Timestamp。

但是,如果我们直接使用ObjectMapper来序列化Instant:

public static void main(String[] args) throws IOException {
ObjectMapper objectMapper = new ObjectMapper();
System.out.println(objectMapper.writeValueAsString(Instant.now())); }

将得到:

{"epochSecond":1520621382,"nano":959000000}

一个Instant需要两个字段来表示,同样的情况也出现在LocalDateTime上,即一个时间需要多个字段表示。

为了克服这种情况,可以引入Jackson的DataType模块:

    compile('com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.9.4')

然后配置ObjectMapper:

objectMapper.findAndRegisterModules();

此时,Instant将会被序列化为:

1520621578.637000000

如果你觉得这个数字不表意,那么可以:

objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);

此时,Instant被序列化为:

"2018-03-09T18:53:48.214Z"

但这是一个UTC时区的时间,因此还不如直接使用数字呢。如果实在不喜欢数字,那么可以设置ObjectMapper的时区:

objectMapper.setTimeZone(getTimeZone(of("Asia/Shanghai")));

奇怪的是,这里必须显式地在ObjectMapper上设置,修改系统的默认时区对此时不生效的:

TimeZone.setDefault(getTimeZone(of("Asia/Shanghai")));

使用Jackson的推荐配置

  1. 对于所有的使用ObjectMapper的地方,推荐采用直接处理字段的方式,即:
objectMapper.setVisibility(ALL, NONE)
.setVisibility(FIELD, ANY);

另外,推荐加入Datatype模块。

在任何时候不要使用@JsonInclude(JsonInclude.Include.NON_EMPTY)@JsonInclude(JsonInclude.Include.NON_NULL)

  1. 对于接收客户端传来的请求(比如使用Spring MVC的Controller),使用@JsonCreator,并限制必须存在的字段为(require = true):
  @JsonCreator
public Person(@JsonProperty(value = "name", required = true) String name,
@JsonProperty(value = "address", required = true) String address,
@JsonProperty(value = "mobile", required = true) String mobile) {
this.name = name;
this.address = address;
this.mobile = mobile;
}
  1. 如果要调用第三方的API,可以使用通过@JsonIgnoreProperties(ignoreUnknown = true)忽略掉所有不需要的字段。

  2. 如果要将Java对象持久化为Json格式,即对于采用NoSQL的系统而言,数据格式(schema)都被隐藏在了代码模型(Java的类)中,此时需要注意以下几点:

  • 在序列化时,不要使用@JsonInclude(JsonInclude.Include.NON_NULL)或者`@JsonInclude(JsonInclude.Include.NON_EMPTY),因为这样所产生的Json不能完整地反应数据schema。也即,在任何时候,代码模型中的所有字段都必须序列化到数据库中,包含了null值,空字符串等。

  • 由于软件在开发过程中经常会有数据库迁移,因此为了保证迁移之后的数据满足schema,我们需要保证迁移之后的数据字段和代码模型中的字段是严格一一对应的,不能多,也不能少,因此建议使用私有(表示只为技术而存在)的@JsonCreator构造函数和@JsonProperty(value = "name", required = true)来反序列化对象。

作者:无知者云
链接:https://www.jianshu.com/p/4bd355715419
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

Jackson学习笔记的更多相关文章

  1. JackSon学习笔记(一)

    概述 Jackson框架是基于Java平台的一套数据处理工具,被称为“最好的Java Json解析器”. Jackson框架包含了3个核心库:streaming,databind,annotation ...

  2. Jackson学习笔记(详细)

    学习地址:http://tutorials.jenkov.com/java-json/index.html github地址:https://github.com/FasterXML/jackson ...

  3. Jackson学习笔记-对象序列化

    一.用ObjectMapper.readValue(jsonString, Student.class) , ObjectMapper.writeValueAsString(student) impo ...

  4. jackson 学习笔记

    Jackson以优异的解析性能赢得了好评,今天就看看Jackson的一些简单的用法. Jackson使用之前先要下载,这里一共有三个jar包,想要获得完美的Jackson体验,这三个jar包都不可或缺 ...

  5. Jackson学习笔记(三)<转>

    概述 使用jackson annotations简化和增强的json解析与生成. Jackson-2.x通用annotations列表:https://github.com/FasterXML/jac ...

  6. spring学习笔记---Jackson的使用和定制

      前言: JAVA总是把实体对象(数据库/Nosql等)转换为POJO对象再处理, 虽然有各类框架予以强力支持. 但实体对象和POJO, 由于"饮食习惯", "民族特色 ...

  7. springmvc学习笔记--REST API的异常处理

    前言: 最近使用springmvc写了不少rest api, 觉得真是一个好框架. 之前描述的几篇关于rest api的文章, 其实还是不够完善. 比如当遇到参数缺失, 类型不匹配的情况时, 直接抛出 ...

  8. springmvc学习笔记---面向移动端支持REST API

    前言: springmvc对注解的支持非常灵活和飘逸, 也得web编程少了以往很大一坨配置项. 另一方面移动互联网的到来, 使得REST API变得流行, 甚至成为主流. 因此我们来关注下spring ...

  9. <老友记>学习笔记

    这是六个人的故事,从不服输而又有强烈控制欲的monica,未经世事的千金大小姐rachel,正直又专情的ross,幽默风趣的chandle,古怪迷人的phoebe,花心天真的joey——六个好友之间的 ...

随机推荐

  1. [转]利用 Commons-Fileupload 实现文件上传

    转载 Java Web开发人员可以使用Apache文件上传组件来接收浏览器上传的文件,该组件由多个类共同组成,但是,对于使用该组件来编写文件上传功能的Java Web开发人员来说,只需要了解和使用其中 ...

  2. Ngnix调整

    1.隐藏版本号,防止针对版本攻击   http {    server_tokens off;2.增加并发连接   2.1 worker_processes :改为CPU核数一致,因为异步IO进程是单 ...

  3. Java基础 -5.2

    方法重载 当方法名称相同,参数的类型或者个数不同的时候 就会称为方法重载. public static void main(String[] args) { System.out.println(ad ...

  4. 记录5-如何在UltraEdit中编译和运行Java

    1点击“高级”,再点击“工具配置” 2点击“插入”,在“菜单项”名称上输入“编译java程序”,在“命令行”里输入“javac %n%e”,在工作目录上填“%p”. 3切换到“输出”项,选择“输出到列 ...

  5. Spark程序编译报错error: object apache is not a member of package org

    Spark程序编译报错: [INFO] Compiling 2 source files to E:\Develop\IDEAWorkspace\spark\target\classes at 156 ...

  6. Java解析Json字符串--数组或列表

    Json示例: [ { "age": 25, "gender": "female", "grades": "三 ...

  7. vue动画钩子

    <template> <div class="hello"> <div class="toggle" @click="f ...

  8. Python 基础之循环结构 while

    一.while循环介绍 while 循环 可以提高代码的效率,减少代码的冗余 while 条件表达式:    code1    code2如果条件表达式成立,返回Ture,就执行其中的代码块 1.基本 ...

  9. 带你了解后渗透工具Koadic

    前言: 在朋友的博客上看到推荐的一款工具Koadic,我接触了以后发现很不错这款工具的强大之处我觉得就是拿到shell后的各种模块功能,我就自己写出来发给大家看看吧. 首先把项目克隆到本地: 项目地址 ...

  10. 单词「TJOI 2013」(AC自动机)

    传送门 我们正常的建好Trie后求一遍fail.之后对于每一个节点,从它的fail连向它一条单项边.然后从根节点开始dfs. 记sum[i]代表从根到i号节点所代表的的字符串出现的次数,即该点的权值. ...