Spring Boot之Jackson快速入门，你必须得会！

👨‍🎓作者：bug菌

✏️博客：CSDN、掘金、infoQ、51CTO等

🎉简介：CSDN|阿里云|华为云|51CTO等社区博客专家，历届博客之星Top30，掘金年度人气作者Top40，51CTO年度博主Top12，掘金 | InfoQ | 51CTO等社区优质创作者，全网粉丝合计15w+ ；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板等海量资料。

...

✍️温馨提醒：本文字数：1999字, 阅读完需：约 5 分钟

🏆本文收录于《Spring Boot从入门到精通》，专门攻坚指数提升。

本专栏致力打造最硬核 Spring Boot 从零基础到进阶系列学习内容，🚀均为全网独家首发，打造精品专栏，专栏持续更新中…欢迎大家订阅持续学习。

环境说明：Windows10 + Idea2021.3.2 + Jdk1.8 + SpringBoot 2.3.1.RELEASE

 1. 前言🔥

        在上一期《SpringBoot之Jackson配置全局时间日期格式》文中提到Jackson，了解到有很多小伙伴对它很感兴趣；顾这一期，我就重点带着大家以最基础的教学方式领大家入门，废话不多说，咱们这就开始。

        这将又会是干货满满的一期，全程无尿点不废话只抓重点教，具有非常好的学习效果，拿好小板凳准备就坐！希望学习的过程中大家认真听好好学，学习的途中有任何不清楚或疑问的地方皆可评论区留言或私信，bug菌将第一时间给予解惑，那么废话不多说，直接开整！Fighting！！ 

2. 环境说明🔥

本地的开发环境：

• 开发工具：IDEA 2021.3
• JDK版本： JDK 1.8
• Spring Boot版本：2.3.1 RELEASE
• Maven版本：3.8.2

3.正文🔥

3.1 概述

        在日常开发过程中，用于处理json和xml格式化的类库中，用的比较广泛的就属Jackson了，而且Spring MVC 框架默认的json解析器也是Jackson。

        在当前，除了jackson外，常见的解析器还有：Jsonlib，Gson，fastjson等；对比这些解析器，jackson的优势立马就体现出来了，比如解析大的json文件jackson处理速度快，运行时占用内存低，性能好，而且jackson附带灵活的API，便于扩展和定制；

        而对于Jackson 的 1.x 版本的包名为 org.codehaus.jackson ，当版本升级到 2.x 以上时，包名变为 com.fasterxml.jackson，本文教学的内容也是基于最新的 Jackson 2.9.1 版本。

        总之Jackson是一款非常强悍的处理json和xml格式化的开源类库了，安利给大家。

3.2 引入jackson依赖

<!--jackson依赖-->
<dependency> 
    <groupId>com.fasterxml.jackson.core</groupId> 
    <artifactId>jackson-databind</artifactId> 
    <version>2.9.1</version> 
</dependency>

        注意：如果你是springboot项目，并且有引入spring-boot-starter-web这个starter，你就不需要引入上方jackson的依赖包了，因为引入web这个starter自带就带有jackson依赖包，所以大家不要重复导包啦，特此提醒！！以上导入jackson依赖是针对没有导入web-starter的小伙伴而设立的，大家看清楚，别重复了。

3.3 求证spring-boot-starter-web自带jackson依赖

        如下，我给大家举证一遍，为何导入了web-starter就不需要导入jackson依赖了。

        对于导入了web starter，深究进去，可以看到在spring-boot-starter-web这个starter包中有涉及json相关的依赖。

        我们选择spring-boot-starter-json继续深入，进入了里头，可以发现，jackson是有被直接集成到该web-starter中的，大家请看如下截图：

所以，非springboot项目的小伙伴，那就得自行引包啦。

3.4 Jackson核心模块介绍

引入Jackson包，我们可以看到，在依赖中分别有如下三类包，大家请看：

        那对于这三类宝，到底分别有何作用呢？有的小伙伴肯定不得而知，没关系，接下来我就具体给大家逐一介绍一下，这三类包分别是干嘛用的，具体如下：

• jackson-core：

        核心包，它提供基于"流模式"解析的相关 API，它包括JsonPaser和JsonGenerator。Jackson 内部实现正是通过高性能的流模式 API 的 JsonGenerator 和 JsonParser 来生成和解析 json。

• jackson-annotations：

        注解包，提供标准注解功能。

• jackson-databind：

        数据绑定包， 提供基于"对象绑定" 解析的相关 API （ ObjectMapper ） 和"树模型" 解析的相关 API （JsonNode）；基于"对象绑定" 解析的 API 和"树模型"解析的 API 依赖基于"流模式"解析的 API。

4. jackson使用

4.1 导入Jar包

        老样子，使用前先导依赖，具体依赖配置信息如下，你们直接vc大法即可。

<!--jackson依赖-->
<dependency> 
    <groupId>com.fasterxml.jackson.core</groupId> 
    <artifactId>jackson-databind</artifactId> 
    <version>2.9.1</version> 
</dependency>

        注意：如果你是springboot项目，并且有引入spring-boot-starter-web这个starter，你就不需要引入上方jackson的依赖包了。至于原因我上篇已经详细解释过了，新来的小伙伴想知道可以去翻我上篇，这里就不再赘述啦。

4.2 Jackson注解

        我们先来学习一下jackson提供的常用注解，大家可根据实际需求，灵活调用，还是非常简单好使的。常用注解及用法如下：

@JsonProperty

用法：此注解用于属性上；作用是把该属性名称序列化为另外一个名称，如把userName属性序列化为name，

示例：

@JsonProperty("name")

private String userName;

@JsonFormat

用法：此注解用于属性或方法；作用是把属性的格式序列化成指定的格式。

示例1： 

@JsonFormat(timezone = "GMT+8", pattern = "yyyy-MM-dd HH:mm") 

private Date createTime；

示例2： 

@JsonFormat(timezone = "GMT+8", pattern = "yyyy-MM-dd HH:mm") 

public Date getCreateTime(){}

@JsonPropertyOrder

用法：此注解用于用于类；作用是指定属性在序列化时 json 中的顺序 ，

示例： 

@JsonPropertyOrder({ "id", "name","age",""sex }) 

public class Person{}

@JsonCreator

用法：此注解用于构造方法，和 @JsonProperty 配合使用，适用有参数的构造方法。

示例：

@JsonCreator

public LogInfo(@JsonProperty("id") int id) { this.id = id; }

@JsonAnySetter

用法：此注解用于属性或者方法，作用是设置未反序列化的属性名和值作为键值存储到 map 中 

示例：

public class User {

	@JsonProperty("name")
	private String name;

	@JsonProperty("age")
	private String age;
	
	private Map<String, Object> others;

	@JsonAnyGetter
	public Map<String, Object>anySetter() {
		return others
	}

	@JsonAnySetter
	public void anySetter(String key, Object value) {
		if (others == null) {
			others = new HashMap<>();
		}
		others .put(key, value);
	}
}

@JsonAnyGetter

用法：此注解用于方法 ，作用是获取所有未序列化的属性 。

示例：

@JsonAnyGetter

public Map<String, Object>anySetter() { return others }

@JsonIgnore

用法：此注解用于属性上，作用是进行JSON操作时忽略该属性

示例：

@JsonIgnore

private String exception;

4.3 Json转为Java对象

提及json串转成对象，方式方法太多了。但是今天我要你要学会用jackson来处理，想不想学？很简单的，饭都递嘴边了，张口！

其实核心也就是该方法readValue()，学会使用即可。

案例演示如下：

/**
 * json字符串转对象
 */
@Test
void testReadValue() throws JsonProcessingException {
    //1.定义一个json串
    String json = ""{"id":1,"name":"bug菌","age":18,"sex":"男","address":"上海市闵行区吴泾镇","describes":null,"image":"./template/cat.jpg"}";
    //2.创建ObjectMapper类
    ObjectMapper mapper = new ObjectMapper();
    UserEntity user = mapper.readValue(json, UserEntity.class);
    //3.打印
    System.out.println(user);
}

4.4 Java对象转换Json

将java对象转成json字符串，用到了writeValueAsString()方法，学会使用即可。

接下来我给大家演示一下，如何使用？

/**
 * 对象转json字符串
 */
@Test
void testWriteValueAsString() throws Exception {
    //1.创建对象
    UserEntity user = new UserEntity();
    user.setId(1);
    user.setName("bug菌");
    user.setSex("男");
    user.setAge(18);
    user.setImage("./template/cat.jpg");
    user.setAddress("上海市闵行区吴泾镇");

    //2.创建ObjectMapper类
    ObjectMapper mapper = new ObjectMapper();
    String userJson = mapper.writeValueAsString(user);
    //3.打印
    System.out.println(userJson);

    //4.写入txt文件中
    mapper.writeValue(new File("./template/userJson.txt"), userJson);
}

控制台输出结果如下：

成功将json串写入txt记事本中。

还有更多的复杂的玩法儿，这就不一一举例演示了，更多的是靠大家去钻研了。

... ...

    ok，以上就是我这期的全部内容啦，如果还想学习更多，你可以看看如下的往期热文推荐哦，每天积累一个奇淫小知识，日积月累下去，你一定能成为令人敬仰的大佬。

「赠人玫瑰，手留余香」，咱们下期拜拜~~

5. 热文推荐💭

       为了便于同学快速定位文章学习，熬夜几天终于整理出了【基础篇】及【进阶篇】专栏的文章及有效地址，同学们敬请吩咐bug菌吧。

       目前基础篇已完结75篇+，进阶篇已完结45篇+，两专栏都在持续更新中；生命不息，更新不止，加油卷起来吧，同学们。部分文章总结如下：

5.1 Spring Boot【基础篇】

导读：SpringBoot 学习指南(附思维导图)

Spring Boot入门(01)：Spring Boot的奋斗成长史

Spring Boot入门(02)：快速开发环境搭建和项目启动

Spring Boot入门(03)： yaml、properties配置文件介绍及使用

Spring Boot入门(04)：多环境切换，实例演示

Spring Boot入门(05)：starter基础入门

Spring Boot入门(06)：Spring Boot常用注解大全

Spring Boot入门(07)：整合 MySQL 和 Druid数据源(两万字教学)

Spring Boot入门(08)：整合Mybatis访问MySQL实现增删改查

Spring Boot入门(09)：使用MyBatis的XML配置方式访问MySQL实现增删改查

Spring Boot入门(10)： mybatis之xml映射文件＞、＜=等特殊符号写法

Spring Boot入门(11)：Spring Boot 整合 JPA

Spring Boot入门(12)：整合Mybatis-Plus mybatis-plus实现接口增删改查

Spring Boot入门(13)： Mybatis-Plus之条件构造器使用手册

Spring Boot入门(14)： mybatis-plus之如何自定义sql

Spring Boot入门(15)：Spring Boot 整合 MyBatis-Plus AutoGenerator 自动生成项目骨架代码

Spring Boot入门(16)：Spring Boot整合Swagger-UI实现在线API文档

Spring Boot入门(17)：Spring Boot整合Knife4j，美化强化丑陋的Swagger

Spring Boot入门(18)：Spring Boot静态资源映射

Spring Boot入门(19)：Spring Boot 整合 Thymeleaf 模板引擎，开发Web页面

Spring Boot入门(20)：实现多数据源配置，开箱即用

Spring Boot入门(21)：整合Log4j2以及配置详解

Spring Boot入门(22)：整合LogBack 实现日志文件本地保存

Spring Boot入门(23)：Spring Boot基于AOP拦截日志

Spring Boot入门(24)：Spring Boot事务

Spring Boot入门(25)：过滤器、拦截器、监听器对比及使用场景

Spring Boot入门(26)：实现邮件发送简单邮件、附件邮件、嵌入资源(图片)邮件、模板邮件等

Spring Boot入门(27)：war包部

Spring Boot入门(28)：jar包部署

Spring Boot入门(29)：如何实现热部署

Spring Boot入门(30)：Windows安装Redis客户端？你玩过么

5.2 Spring Boot【进阶篇】

Spring Boot进阶(01)：Spring Boot 集成 Redis，实现缓存自由

Spring Boot进阶(02)：使用Validation进行参数校验

Spring Boot进阶(03)：如何使用MyBatis-Plus实现字段的自动填充

Spring Boot进阶(04)：如何使用MyBatis-Plus快速实现自定义sql分页

Spring Boot进阶(05)：Spring Boot 整合RabbitMq，实现消息队列服务

Spring Boot进阶(06)：Windows10系统搭建 RabbitMq Server 服务端

Spring Boot进阶(07)：集成EasyPoi，实现Excel/Word的导入导出

Spring Boot进阶(08)：集成EasyPoi，实现Excel/Word携带图片导出

Spring Boot进阶(09)：集成EasyPoi，实现Excel文件多sheet导入导出

Spring Boot进阶(10)：集成EasyPoi，实现Excel模板导出成PDF文件

Spring Boot进阶(11)：Spring Boot 如何实现纯文本转成.csv格式文件？

Spring Boot进阶(12)：Spring Boot 如何获取Excel sheet页的数量？

Spring Boot进阶(13)：Spring Boot 如何获取@ApiModelProperty(value = “序列号“, name = “uuid“)中的value值name值？

Spring Boot进阶(14)：Spring Boot 如何手动连接库并获取指定表结构？一文教会你

Spring Boot进阶(15)：根据数据库连接信息指定分页查询表结构信息

Spring Boot进阶(16)：Spring Boot 如何通过Redis实现手机号验证码功能？

Spring Boot进阶(17)：Spring Boot如何在swagger2中配置header请求头等参数信息

Spring Boot进阶(18)：SpringBoot如何使用@Scheduled创建定时任务？

Spring Boot进阶(19)：Spring Boot 整合ElasticSearch

Spring Boot进阶(20)：配置Jetty容器

Spring Boot进阶(21)：配置Undertow容器

Spring Boot进阶(22)：Tomcat与Undertow容器性能对比分析

Spring Boot进阶(23)：实现文件上传

Spring Boot进阶(24)：如何快速实现多文件上传？

Spring Boot进阶(25)：文件上传的单元测试怎么写?

Spring Boot进阶(26)：Mybatis 中 resultType、resultMap详解及实战教学

Spring Boot进阶(27)：Spring Boot 整合 kafka(环境搭建+演示)

Spring Boot进阶(28)：Jar包Linux后台启动部署及滚动日志查看，日志输出至实体文件保存

Spring Boot进阶(29)：如何正确使用@PathVariable，@RequestParam、@RequestBody等注解？不会我教你，结合Postman演示

Spring Boot进阶(30)：@RestController和@Controller 注解使用区别，实战演示

...

       若想学习更多，可以参考这篇专栏总结《2023最新首发，全网最全 Spring Boot 学习宝典(附思维导图)》，本专栏致力打造最硬核 Spring Boot 进阶系列学习内容，🚀均为全网独家首发，打造精品专栏，专栏持续更新中。欢迎大家订阅持续学习。

       在入门及进阶之途，我必助你一臂之力，系统性学习，从入门到精通，带你不走弯路，直奔终点；投资自己，永远性价比最高，都这么说了，你还不赶紧来学？？

本文涉及所有源代码，均已上传至github开源，供同学们一对一参考，github.com/luoyong0603… ，同时，原创开源不易，欢迎给个star🌟，想体验下被加Star的感jio，非常感谢 ❗

6. 文末💭

       我是bug菌，CSDN | 阿里云 | 华为云 | 51CTO 等社区博客专家，历届博客之星Top30，掘金年度人气作者Top40，51CTO年度博主Top12，掘金 | InfoQ | 51CTO等社区优质创作者，全网粉丝合计15w+ ；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板等海量资料。