## 📋 目录

- 一、工具类功能
- 二、所需环境
- 三、方法与调用示例（按需调用）
- 四、工具类源码（可直接复制）

## 一、工具类功能

基于 Jackson 单例 `ObjectMapper`，把对象、`List`/`Map`、泛型结构与 JSON 字符串互转，DTO/VO/实体互转，日期时间按统一格式读写，不必到处 new。

## 二、所需环境

JDK 17或以上 + Spring Boot 3.x或以上

```xml
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <scope>provided</scope>
</dependency>
```

## 三、方法与调用示例（按需调用）

🔢 **方法序号**：1

🎯 **方法用途**：
- 把一个对象写成单行紧凑的 JSON 字符串
- 接口出参、写缓存、拼请求体这类要给机器读的场景直接用它

🧩 **方法定义**：`public static String toJson(Object object)`

🗣️ **入参解释**：`public static String toJson(待序列化对象)`

📤 **返回值解释**：`String`，紧凑的单行 JSON

💡 **边界口径**：
- 对象传 `null` 得到的是字符串 `"null"`，不是 Java 的 `null`
- 结构无法序列化（如无属性的空 Bean）或写出过程发生 IO 异常时，包装成 `IllegalStateException` 抛出

🧪 **方法示例**：
- `toJson(new Order("双十一订单", 3))` 返回JSON字符串 拿到 `{"name":"双十一订单","count":3}`
- `toJson(new Event("下单", LocalDateTime.of(2026, 10, 4, 20, 30, 0), LocalDate.of(2026, 10, 4), LocalTime.of(20, 30)))` 日期按约定格式写出 拿到 `{"name":"下单","at":"2026-10-04 20:30:00","day":"2026-10-04","time":"20:30:00"}`

---

🔢 **方法序号**：2

🎯 **方法用途**：
- 把一个对象写成带缩进的多行 JSON
- 排查报文、贴进文档给人看时用，层级一眼分得清

🧩 **方法定义**：`public static String toPrettyJson(Object object)`

🗣️ **入参解释**：`public static String toPrettyJson(待序列化对象)`

📤 **返回值解释**：`String`，带缩进的多行 JSON

💡 **边界口径**：
- 与 `toJson` 共用同一个 `ObjectMapper`，只是换成带缩进的 writer，日期格式等口径不变
- 对象传 `null` 同样得到字符串 `"null"`；无法序列化时抛 `IllegalStateException`

🧪 **方法示例**：
- `toPrettyJson(new Order("双十一订单", 3))` 返回美化JSON（共4行）-> 4 行带缩进的 `{`、`  "name" : "双十一订单",`、`  "count" : 3`、`}`

---

🔢 **方法序号**：3

🎯 **方法用途**：
- 把 JSON 字符串读回指定类型的对象
- 接口返回的一个对象直接读成 DTO，不用手写字段映射

🧩 **方法定义**：`public static <T> T parseObject(String json, Class<T> clazz)`

🗣️ **入参解释**：`public static <T> T parseObject(JSON字符串, 目标类型)`

📤 **返回值解释**：`T`，与目标类型同一个类型

💡 **边界口径**：
- 严格模式：JSON 格式非法、结构对不上、尾部有多余内容都抛 `IllegalStateException`，不静默给半成品对象
- `json` 或 `clazz` 传 `null` 抛 `IllegalArgumentException`；内容是 JSON 的 `null` 字面量时返回 `null`
- 实体多出来的字段被忽略，缺字段仍按目标类型给默认值

🧪 **方法示例**：
- `parseObject(json, Order.class)` 返回对象 拿到 `Order[name=双十一订单, count=3]`
- `parseObject(eventJson, Event.class)` 还原日期时间 拿到 `Event[name=下单, at=2026-10-04T20:30, day=2026-10-04, time=20:30]`

---

🔢 **方法序号**：4

🎯 **方法用途**：
- 把 JSON 字符串读回 `List`/`Map` 这类泛型结构
- 不用先读成 `List<Object>` 再自己逐个转类型

🧩 **方法定义**：`public static <T> T parseObject(String json, TypeReference<T> typeReference)`

🗣️ **入参解释**：`public static <T> T parseObject(JSON字符串, 泛型类型)`

📤 **返回值解释**：`T`，由泛型类型引用决定，可以是 `List<Order>`、`Map<String, Order>`

💡 **边界口径**：
- 与 `parseObject(String, Class)` 同一套严格口径，非法与结构不符都抛 `IllegalStateException`
- 泛型入参写 `new TypeReference<>() {}`，目标类型由接收变量推断
- `json` 或 `typeReference` 传 `null` 抛 `IllegalArgumentException`

🧪 **方法示例**：
- `parseObject(listJson, new TypeReference<>() {})` 返回集合列表 拿到 `[Order[name=甲, count=1], Order[name=乙, count=2]]`

---

🔢 **方法序号**：5

🎯 **方法用途**：
- 读不回对象时给 `null` 而不是抛异常
- 批量清洗来源不可信的报文时用，一条坏数据不中断整批

🧩 **方法定义**：`public static <T> T parseObjectQuietly(String json, Class<T> clazz)`

🗣️ **入参解释**：`public static <T> T parseObjectQuietly(JSON字符串, 目标类型)`

📤 **返回值解释**：`T`，解析失败是 `null`

💡 **边界口径**：
- `json` 为 `null`、空白、格式非法、结构不符，一律返回 `null`，不抛异常
- 只有 `clazz` 传 `null` 才抛 `IllegalArgumentException`，那是调用方写错
- 返回 `null` 分不清「没数据」与「数据坏了」，要严格判定就用 `parseObject`

🧪 **方法示例**：
- `parseObjectQuietly("{不是合法JSON}", Order.class)` 非法输入容错 拿到 `null`

---

🔢 **方法序号**：6

🎯 **方法用途**：
- 把 JSON 数组直接读成 `List<元素类型>`
- 元素类型写 `Order.class` 就行，不用套泛型写法

🧩 **方法定义**：`public static <T> List<T> parseList(String json, Class<T> elementCls)`

🗣️ **入参解释**：`public static <T> List<T> parseList(JSON字符串, 元素类型)`

📤 **返回值解释**：`List<T>`

💡 **边界口径**：
- 严格模式：格式非法、元素类型对不上、JSON 不是数组结构都抛 `IllegalStateException`
- `json` 或 `elementCls` 传 `null` 抛 `IllegalArgumentException`；内容是 JSON 的 `null` 字面量时返回 `null`

🧪 **方法示例**：
- `parseList("[{\"name\":\"甲\",\"count\":1}]", Order.class)` 返回集合列表 拿到 `[Order[name=甲, count=1]]`

---

🔢 **方法序号**：7

🎯 **方法用途**：
- 把 JSON 数组读成 `List<元素类型>`，读不回时兜成空列表
- 批量解析列表时不用为每条数据包 try-catch

🧩 **方法定义**：`public static <T> List<T> parseListQuietly(String json, Class<T> elementCls)`

🗣️ **入参解释**：`public static <T> List<T> parseListQuietly(JSON字符串, 元素类型)`

📤 **返回值解释**：`List<T>`，失败是空列表，不为 `null`

💡 **边界口径**：
- `json` 为 `null`、空白、格式非法、结构不符、内容是 `null` 字面量，一律返回空列表
- 只有 `elementCls` 传 `null` 才抛 `IllegalArgumentException`
- 空列表既可能是「本来就没数据」也可能是「解析失败」，要区分就用 `parseList`

🧪 **方法示例**：
- `parseListQuietly("{不是数组}", Order.class)` 结构不符容错 拿到 `[]`

---

🔢 **方法序号**：8

🎯 **方法用途**：
- 把 JSON 对象读成指定键类型与值类型的 `Map`
- 键值类型直接给 `Class`，不用读成 `Map<Object,Object>` 再转

🧩 **方法定义**：`public static <K, V> Map<K, V> parseMap(String json, Class<K> keyCls, Class<V> valueCls)`

🗣️ **入参解释**：`public static <K, V> Map<K, V> parseMap(JSON字符串, 键类型, 值类型)`

📤 **返回值解释**：`Map<K, V>`

💡 **边界口径**：
- 严格模式：格式非法或反序列化失败抛 `IllegalStateException`
- `json`、`keyCls`、`valueCls` 任一为 `null` 抛 `IllegalArgumentException`
- 内容是 JSON 的 `null` 字面量时返回 `null`

🧪 **方法示例**：
- `parseMap(mapJson, String.class, Order.class)` 返回Map 拿到 `{k1=Order[name=甲, count=1]}`

---

🔢 **方法序号**：9

🎯 **方法用途**：
- 把一个对象直接转成另一个类型的对象
- DTO 转 VO、表单转实体一步到位，不必先转成 JSON 字符串再读回来

🧩 **方法定义**：`public static <T> T convertValue(Object source, Class<T> targetCls)`

🗣️ **入参解释**：`public static <T> T convertValue(源对象, 目标类型)`

📤 **返回值解释**：`T`，目标类型的新对象

💡 **边界口径**：
- 底层是「序列化再反序列化」，所以字段按名字对上，两边结构不匹配抛 `IllegalStateException`
- 源对象传 `null` 返回 `null`；`targetCls` 传 `null` 抛 `IllegalArgumentException`
- 返回的是新对象，与源对象不共享引用，改副本不影响原对象

🧪 **方法示例**：
- `convertValue(form, Order.class)` 返回转换后对象 拿到 `Order[name=线下单, count=5]`

---

🔢 **方法序号**：10

🎯 **方法用途**：
- 把对象转成 `List<Order>` 这类泛型结构
- 比如把一堆 `Map` 表单直接转成 DTO 列表

🧩 **方法定义**：`public static <T> T convertValue(Object source, TypeReference<T> typeReference)`

🗣️ **入参解释**：`public static <T> T convertValue(源对象, 泛型类型)`

📤 **返回值解释**：`T`，由泛型类型引用决定

💡 **边界口径**：
- 与 `Class` 版同为「序列化再反序列化」，结构不匹配抛 `IllegalStateException`
- 源对象传 `null` 返回 `null`；`typeReference` 传 `null` 抛 `IllegalArgumentException`
- 泛型入参写 `new TypeReference<>() {}`，类型由接收变量推断

🧪 **方法示例**：
- `convertValue(List.of(Map.of("name", "丙", "count", 9)), new TypeReference<>() {})` 返回集合列表 拿到 `[Order[name=丙, count=9]]`

---

🔢 **方法序号**：11

🎯 **方法用途**：
- 拿工具类共用的那个 `ObjectMapper` 单例
- 要去读本类没封装的写法时用它，不用自己再配一遍日期格式与容错开关

🧩 **方法定义**：`public static ObjectMapper getObjectMapper()`

🗣️ **入参解释**：`public static ObjectMapper getObjectMapper()`（无入参）

📤 **返回值解释**：`ObjectMapper`，全局共享单例，不为 `null`

💡 **边界口径**：
- 返回的是共享实例：改它的配置会影响本类所有方法的读写行为，只在确实需要扩展能力时动它
- 已配好的口径：日期按 `yyyy-MM-dd HH:mm:ss` 等固定格式读写、忽略未知字段、失败不静默
- 需要独立配置的场合请自己 `JsonMapper.builder()` 建一个，别改这个单例

🧪 **方法示例**：
- `getObjectMapper()` 返回全局共享单例 拿到 `同一实例=true`

## 四、工具类源码（可直接复制）

📦 见评论区



基于 Jackson 单例 ObjectMapper，把对象、List/Map、泛型结构与 JSON 字符串互转，DTO/VO/实体互转，日期时间按统一格式读写，不必到处 new。

基于Jackson单例的Java JSON工具类，11个方法可直接复制

人工智能

基于Jackson单例ObjectMapper封装的高性能JSON工具类，支持对象与JSON互转、List/Map泛型解析、DTO/VO转换及日期统一格式化。提供toJson、parseObject、parseList、parseMap、convertValue等11个方法，含严格模式和静默容错版本，适配JDK17+与SpringBoot3.x，源码可直接复制使用，提升开发效率。

代码解释

JSON

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

基于Jackson单例ObjectMapper封装的高性能JSON工具类，支持对象与JSON互转、List/Map泛型解析、DTO/VO转换及日期统一格式化。提供toJson、parseObject、parseList、parseMap、convertValue等11个方法，含严格模式和静默容错版本，适配JDK17+与...

基于Jackson单例的Java JSON工具类，11个方法可直接复制-腾讯云开发者社区-腾讯云

基于Jackson单例的Java JSON工具类，11个方法可直接复制

基于Jackson单例的Java JSON工具类，11个方法可直接复制

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐