jackson学习之二：jackson-core

• jackson学习之七：常用Field注解

• jackson学习之八：常用方法注解

• jackson学习之九：springboot整合(配置文件)

• jackson学习之十(终篇)：springboot整合(配置类)

关于jackson-core

1. 本文主要内容是jackson-core库，这是个低阶API库，提供流式解析工具JsonParser，流式生成工具JsonGenerator；

2. 在日常的序列化和反序列化处理中，最常用的是jackson-annotations和jackson-databind，而jackson-core由于它提供的API过于基础，我们大多数情况下是用不上的；

3. 尽管jackson-databind负责序列化和反序列化处理，但它的底层实现是调用了jackson-core的API；

4. 本着万丈高楼平地起的原则，本文咱们通过实战了解神秘的jackson-core，了解整个jackson的序列化和反序列化基本原理；

源码下载

1. 如果您不想编码，可以在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协议 |

2. 这个git项目中有多个文件夹，本章的应用在jacksondemo文件夹下，如下图红框所示：

创建父子工程

创建名为jacksondemo的maven工程，这是个父子结构的工程，其pom.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns=“http://maven.apache.org/POM/4.0.0” xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”

xsi:schemaLocation=“http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd”>

4.0.0

<java.version>1.8</java.version>

com.bolingcavalry

jacksondemo

1.0-SNAPSHOT

pom

core

beans

databind

com.fasterxml.jackson.core

jackson-databind

2.11.0

compile

org.slf4j

slf4j-log4j12

1.7.25

compile

commons-io

commons-io

2.7

compile

org.apache.commons

commons-lang3

3.10

compile

新增子工程beans

1. 在父工程jscksondemo下新增名为beans的子工程，这里面是一些常量和Pojo类；

2. 增加定义常量的类Constant.java：

package com.bolingcavalry.jacksondemo.beans;

public class Constant {

/**

• 该字符串的值是个网络地址，该地址对应的内容是个JSON

*/

public final static String TEST_JSON_DATA_URL = “https://raw.githubusercontent.com/zq2599/blog_demos/master/files/twitteer_message.json”;

/**

• 用来验证反序列化的JSON字符串

*/

public final static String TEST_JSON_STR = “{\n” +

" “id”:1125687077,\n" +

" “text”:“@stroughtonsmith You need to add a \“Favourites\” tab to TC/iPhone. Like what TwitterFon did. I can’t WAIT for your Twitter App!! 😃 Any ETA?”,\n" +

" “fromUserId”:855523, \n" +

" “toUserId”:815309,\n" +

" “languageCode”:“en”\n" +

“}”;

/**

• 用来验证序列化的TwitterEntry实例

*/

public final static TwitterEntry TEST_OBJECT = new TwitterEntry();

/**

• 准备好TEST_OBJECT对象的各个参数

*/

static {

TEST_OBJECT.setId(123456L);

TEST_OBJECT.setFromUserId(101);

TEST_OBJECT.setToUserId(102);

TEST_OBJECT.setText(“this is a message for serializer test”);

TEST_OBJECT.setLanguageCode(“zh”);

}}

3. 增加一个Pojo，对应的是一条推特消息：

package com.bolingcavalry.jacksondemo.beans;

/**

• @Description: 推特消息bean

• @author: willzhao E-mail: zq2599@gmail.com

• @date: 2020/7/4 16:24

*/

public class TwitterEntry {

/**

• 推特消息id

*/

long id;

/**

• 消息内容

*/

String text; /**

• 消息创建者

*/

int fromUserId;

/**

• 消息接收者

*/

int toUserId;

/**

• 语言类型

*/

String languageCode; public long getId() {

return id;

} public void setId(long id) {

this.id = id;

} public String getText() {

return text;

} public void setText(String text) {

this.text = text;

} public int getFromUserId() {

return fromUserId;

} public void setFromUserId(int fromUserId) {

this.fromUserId = fromUserId;

} public int getToUserId() {

return toUserId;

} public void setToUserId(int toUserId) {

this.toUserId = toUserId;

} public String getLanguageCode() {

return languageCode;

} public void setLanguageCode(String languageCode) {

this.languageCode = languageCode;

} public TwitterEntry() {

} public String toString() {

return “[Tweet, id: “+id+”, text='”+text+“', from: “+fromUserId+”, to: “+toUserId+”, lang: “+languageCode+”]”;

}}

4. 以上就是准备工作了，接下来开始实战jackson-core；

JsonFactory线程安全吗?

1. JsonFactory是否是线程安全的，这是编码前要弄清楚的问题，因为JsonParser和JsonGenerator的创建都离不开JsonFactory；

2. 如下图红框所示，jackson官方文档中明确指出JsonFactory是线程安全的，可以放心的作为全局变量给多线程同时使用：

3. 官方文档地址：http://fasterxml.github.io/jackson-core/javadoc/2.11/

jackson-core实战

1. 新建子工程core，pom.xml如下：

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns=“http://maven.apache.org/POM/4.0.0”

xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”

xsi:schemaLocation=“http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd”>

jacksondemo

com.bolingcavalry

1.0-SNAPSHOT

…/pom.xml

4.0.0

com.bolingcavalry

core

core

Demo project for jackson core use

org.apache.maven.plugins

maven-compiler-plugin

8

8

com.fasterxml.jackson.core

jackson-databind

org.slf4j

slf4j-log4j12

commons-io

commons-io

org.apache.commons

commons-lang3

com.bolingcavalry

beans

${project.version}

2. 新建StreamingDemo类，这里面是调用jackson-core的API进行序列化和反序列化的所有demo，如下：

package com.bolingcavalry.jacksondemo.core;

import com.bolingcavalry.jacksondemo.beans.TwitterEntry;

import com.fasterxml.jackson.core.*;

import com.fasterxml.jackson.databind.ObjectMapper;

import org.apache.commons.io.IOUtils;

import org.apache.commons.lang3.StringUtils;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import java.io.ByteArrayOutputStream;

import java.io.IOException;

import java.net.URL;

/**

• @Description: jackson低阶方法的使用

• @author: willzhao E-mail: zq2599@gmail.com

• @date: 2020/7/4 15:50

*/

public class StreamingDemo {

private static final Logger logger = LoggerFactory.getLogger(StreamingDemo.class);

JsonFactory jsonFactory = new JsonFactory();

/**

• 该字符串的值是个网络地址，该地址对应的内容是个JSON

*/

final static String TEST_JSON_DATA_URL = “https://raw.githubusercontent.com/zq2599/blog_demos/master/files/twitteer_message.json”;

/**

• 用来验证反序列化的JSON字符串

*/

final static String TEST_JSON_STR = “{\n” +

" “id”:1125687077,\n" +

" “text”:“@stroughtonsmith You need to add a \“Favourites\” tab to TC/iPhone. Like what TwitterFon did. I can’t WAIT for your Twitter App!! 😃 Any ETA?”,\n" +

" “fromUserId”:855523, \n" +

" “toUserId”:815309,\n" +

" “languageCode”:“en”\n" +

“}”;

/**

• 用来验证序列化的TwitterEntry实例

*/

final static TwitterEntry TEST_OBJECT = new TwitterEntry();

/**

• 准备好TEST_OBJECT对象的各个参数

*/

static {

TEST_OBJECT.setId(123456L);

TEST_OBJECT.setFromUserId(101);

TEST_OBJECT.setToUserId(102);

TEST_OBJECT.setText(“this is a message for serializer test”);

TEST_OBJECT.setLanguageCode(“zh”);

}

/**

• 反序列化测试(JSON -> Object)，入参是JSON字符串

• @param json JSON字符串

• @return

• @throws IOException

*/

public TwitterEntry deserializeJSONStr(String json) throws IOException {

JsonParser jsonParser = jsonFactory.createParser(json);

if (jsonParser.nextToken() != JsonToken.START_OBJECT) {

jsonParser.close();

logger.error(“起始位置没有大括号”);

throw new IOException(“起始位置没有大括号”);

}

TwitterEntry result = new TwitterEntry();

try {

// Iterate over object fields: