Jackson 是 Java 生态里使用最广泛的 JSON 处理库之一,它通过一组“模块式”的依赖(Maven/Gradle)来提供不同层次的能力。下面先给出一个“一句话”总结,再用表格把常用依赖及其核心功能列出来,方便你按需选型。
一句话总结
Jackson 让你把 Java 对象 ⇄ JSON(以及 XML、YAML、CSV 等)的序列化/反序列化工作,变成“加注解、调一行代码”就能完成的事,同时支持流式高性能读写、动态树模型、数据格式扩展与第三方类型集成。
常用依赖与功能速查表
| 依赖坐标(Maven) | 主要能力 | 典型使用场景 | 备注/额外特性 |
|---|---|---|---|
| `jackson-core` | 底层流式 API(JsonParser / JsonGenerator) | 超高性能读写 JSON,无需绑定对象 | 整个 Jackson 的基石,任何其它模块都间接依赖它 |
| `jackson-annotations` | 提供注解(`@JsonProperty`、`@JsonFormat`…) | 定义序列化规则、字段别名、日期格式等 | 只放注解,无实现,体积最小 |
| `jackson-databind` | 对象映射(`ObjectMapper`) | Java Bean ⇄ JSON 的最常用入口 | 依赖上面两项;支持泛型、集合、嵌套对象 |
| `jackson-datatype-jdk8` | 支持 JDK8+ 新类型 | `Optional`、`LocalDateTime` 等直接参与序列化 | 与 `databind` 搭配,零配置识别新类型 |
| `jackson-datatype-jsr310` | JSR310 时间类型扩展 | `LocalDate`、`Instant`、`ZonedDateTime`… | 避免默认把时间当时间戳或数组输出 |
| `jackson-module-kotlin` | Kotlin 类/数据类支持 | 解决 Kotlin 默认参数、空安全、构造函数语义 | 需要与 `databind` 一起用 |
| `jackson-dataformat-xml` | XML 支持 | 同一套 API 也能读/写 XML | 基于 Woodstox,支持注解混用 |
| `jackson-dataformat-yaml` | YAML 支持 | 配置文件、Spring Boot 常见 | 底层用 SnakeYAML |
| `jackson-dataformat-csv` | CSV 支持 | 批量导入导出、报表 | 支持 schema 推断、列顺序控制 |
| `jackson-dataformat-properties` | Java Properties ⇄ JSON 树 | 读取 `.properties` 并转成 JsonNode 操作 | 多环境配置合并时很有用 |
| `jackson-module-parameter-names` | 利用 `-parameters` 编译参数名 | 无默认构造函数也能反序列化 | 与 Java 8+ 编译器开关配合使用 |
| `jackson-module-afterburner` | 字节码加速 | 提升序列化吞吐量约 10-30 % | 通过生成字节码减少反射,仍在维护 |
| `jackson-module-blackbird` | Java 11+ 的 Lambda 元数据加速 | Afterburner 的继任版,性能更好 | 需要 JDK 11+,反射更少 |
| `jackson-datatype-guava` | Guava 集合/可选类型 | `ImmutableList`、`Multimap`、`Optional` | 与 Guava 深度集成 |
| `jackson-datatype-hibernate` | Hibernate 持久化集合/代理 | 解决懒加载、循环引用问题 | 常用于 Spring Boot + JPA 项目 |
使用建议
1. 最小可用组合:只要读写 JSON Bean,引 `jackson-databind` 即可(它会自动拉 `core` + `annotations`)。
2. 时间类型:JDK8 以后务必加 `jackson-datatype-jsr310`,否则 `LocalDateTime` 会被当成数组 `[2026,1,20,…]` 输出。
3. Kotlin 项目:直接 `jackson-module-kotlin`,否则数据类字段可能识别不到。
4. 性能极致:再加 `blackbird`(或 `afterburner`)并开启 `AfterburnerModule`,CPU 敏感场景可再提 10-30 %。
5. 多格式需求:同一套 POJO,换 `ObjectMapper` 注册 `XmlMapper`、`YAMLFactory` 即可,业务代码几乎不改。
这样,你就可以根据项目需要“按需点菜”,避免一次性全部引入造成包体积膨胀。
- 环境配置
- window怎么配置java环境变量?
- SQL学习
- 字段类型
- 1、 所有可声明的字段类型
- 2、常用的可声明的字段类型
- 创建表和表内字段
- 1、整个创建表语句
- 2、设置id主键
- 3、设置业务主键,唯一索引
- 4、设置业务字段
- 5、普通索引
- 6、唯一索引与普通索引的区别
- 7、表的引擎、字符集、排序规则和注释的设置
- Java基础语法
- 数据类型
- Java中的数据类型
- LocalDate
- 常用的数据类型
- Java 常用数据类型方法
- Java中数组、list、Map、HashMap
- 如何用Map来优化那些复杂的“双重 for 循环”查询?
- Java 8 中steam()操作流
- Java中HashMap和JSON
- Java中的JSONObject
- 工具类
- Java 常用工具类
- Arrays工具类
- Java 时间工具类
- 泛型
- Java中泛型概念
- Java中的泛型容器
- 泛型参数与函数参数的区别
- 推断出泛型实参
- Lambda表达式
- 数据分层
- 异常处理
- Java8 异常处理类总结表
- MyBatis-Plus 常用异常类总结表
- Java高级特性
- Maven
- jib-maven-plugin
- 什么是Spring Boot 的 parent pom?
- maven中各个生命周期的含义
- Spring Boot
- maven与spring boot 的关系
- Java中的连接池
- Spring JDBC
- Spring JDBC的概念
- JdbcTemplate常用的方法
- Spring中Bean的概念
- Spring中的抽象,通俗解释一下
- Spring中的事物
- Spring中的事物,通俗解释一下
- Spring中的事物抽象,常见的有哪些,列举一下
- Spring中常用的事物场景有哪些,列举一下
- Spring事务管理有哪些注解?
- Spring中使用事物处理订单的案例,列举说明一下
- Spring中声明式事务、分布式事务以及编程式事务的区别,列举一下
- 配置文件
- application-properties配置文件
- Spring Boot 的启动
- spring boot项目如何启动?
- 列举一下Spring Boot的启动过程
- SpringApplication.run方法
- Spring Boot 启动时有哪些接口?
- CommandLineRunner
- Spring Boot 的常用注解
- 系统注解
- 表格:系统注解
- @Override
- @Deprecated
- @SuppressWarnnings
- 使用在类名上的注解
- 表格:使用在类名上的注解
- @RestController
- @Controller
- @Service
- @Repository
- @Component
- @Configuration
- @Resource
- @Autowired
- @RequestMapping
- @GetMapping
- @PostMapping
- @Transactional
- @Qualifier
- 使用在方法上的注解
- 表格:使用在方法上的注解
- @RequestBody
- @PathVariable
- @Bean
- @ResponseBody
- @PreAuthorize
- 其他常用注解
- 表格:其他常用注解
- @EnableAutoConfiguration
- @SpringBootApplication
- @EnableScheduling
- @EnableAsync
- @ComponentScan
- @Aspec
- @ControllerAdvice
- @ExceptionHandler
- @Value
- @ConfigurationProperties
- @EnableConfigurationProperties
- @MapperScan
- @ApiOperation
- @Produces
- Validator验证的常用注解
- spring IoC容器
- Spring IoC容器依赖注入实现方式
- 常用依赖
- RESTEasy
- resteasy简介
- RESTEasy框架(依赖)的功能和常用注解
- MyBatis
- 简介
- paginationInterceptor
- @TableName
- @TableId
- @Param
- MyBatis-Plus
- MyBatis-Plus简介
- MyBatis-Plus的工具类
- Mybatis-Plus扩展的工具类和方法
- MyBatis-Plus中最常用的工具类方法
- MyBatis-Plus 中最常用的 4 大核心工具类
- Wrapper条件构造器
- Wrapper条件构造器详解
- Wrapper条件构造器eq等方法的参数说明
- LambdaQueryWrapper与QueryWrapper
- 日期格式是否必须转换
- Lombok
- Lombok作用详解
- @Data
- @Slf4j
- @Builder
- @EqualsAndHashCode
- @Accessors
- Jackson
- Jackson简介
- @JsonFormat
- Jackson高效地在 HashMap 和 JSON 字符串之间进行相互转换
- Hutool
- Hutool简介
- hutool依赖常用的方法
- fastjson2
- fastjson2简介
- UrlBasedCorsConfigurationSource
- 生态相关
- JBoss 社区
- 支付系统
- 1. 初始化mysql数据库流程
- 2. 初始化redis数据库的流程
- 3. 初始化rabbitmq服务
- 环球置业
- 1.模块目录结构分析
- 2. DTO(数据传输层)的核心作用
- 3. VO(视图对象层)
- 4. VO(视图对象层)和 DTO 数据传输层 的区别
