Java 企业级工具类全家桶-74-JSON序列化工具类

📌 拿来即用： Java 企业级工具类全家桶-74-JSON序列化工具类

📋 目录

• 一、工具类功能
• 二、所需环境
• 三、方法概览（按需调用）
• 四、调用示例（直观体验）
• 五、工具类源码（可直接复制）

一、工具类功能

给业务代码用的 JSON 工具类：对象、List/Map、泛型结构与 JSON 字符串互转，DTO/VO/实体互转，日期时间按统一格式读写，不必到处 new ObjectMapper。

两套错误契约：parseXxx 严格模式，报文非法就抛异常；parseXxxQuietly 容错模式，空白与非法给 null 或空集合。忽略实体多出来的字段，但拒绝残缺报文；面向报文级读写，不做超大 JSON 的流式处理。

二、所需环境

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

<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>

三、方法概览（按需调用）

四、调用示例（直观体验）

调用示例直接复制进 IDE 右键 Run 就能看到调用工具类各方法的输出结果。

21:00:28.888 [main] INFO — 「JsonUtils 方法1 toJson(Object)」返回JSON字符串 -> {"name":"双十一订单","count":3}
21:00:28.891 [main] INFO — 「JsonUtils 方法2 toPrettyJson(Object)」返回美化JSON（共4行）->
{
"name" : "双十一订单",
"count" : 3
}
21:00:28.911 [main] INFO — 「JsonUtils 方法3 parseObject(json, Class)」返回对象 -> Order[name=双十一订单, count=3]
21:00:28.925 [main] INFO — 「JsonUtils 方法4 parseObject(json, TypeReference)」返回集合列表 -> [Order[name=甲, count=1], Order[name=乙, count=2]]
21:00:28.925 [main] INFO — 「JsonUtils 方法6 parseList(json, Class)」返回集合列表 -> [Order[name=甲, count=1]]
21:00:28.928 [main] INFO — 「JsonUtils 方法8 parseMap(json, Class, Class)」返回Map -> {k1=Order[name=甲, count=1]}
21:00:28.935 [main] INFO — 「JsonUtils 方法1 toJson(Object)」日期按约定格式写出 -> {"name":"下单","at":"2026-10-04 20:30:00","day":"2026-10-04","time":"20:30:00"}
21:00:28.937 [main] INFO — 「JsonUtils 方法3 parseObject(json, Class)」还原日期时间 -> Event[name=下单, at=2026–10–04T20:30, day=2026–10–04, time=20:30]
21:00:28.941 [main] INFO — 「JsonUtils 方法5 parseObjectQuietly(json, Class)」非法输入容错 -> null
21:00:28.942 [main] INFO — 「JsonUtils 方法7 parseListQuietly(json, Class)」结构不符容错 -> []
21:00:28.945 [main] INFO — 「JsonUtils 方法9 convertValue(source, Class)」返回转换后对象 -> Order[name=线下单, count=5]
21:00:28.954 [main] INFO — 「JsonUtils 方法10 convertValue(source, TypeReference)」返回集合列表 -> [Order[name=丙, count=9]]
21:00:28.955 [main] INFO — 「JsonUtils 方法11 getObjectMapper()」返回全局共享单例 -> 同一实例=true
21:00:28.955 [main] ERROR — 「异常信息获取演示」残缺报文被拒绝 -> JSON反序列化为对象失败: Unrecognized token '尾巴': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false')
at [Source: REDACTED (`StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION` disabled); line: 1, column: 24]
21:00:28.955 [main] ERROR — 「异常信息获取演示」入参不合法 -> JSON字符串不能为空

进程已结束，退出代码为 0

package com.example.order.api;

import com.example.common.utils.JsonUtils;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import lombok.extern.slf4j.Slf4j;

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.util.List;
import java.util.Map;

/**
* 调用示例：整个文件复制进 IDE，右键 Run 就能看效果。
*
* <p>JSON 工具不依赖外部服务，示例直接用内存里的对象与报文跑通全部入口；
* 日志用 Lombok 的 {@code @Slf4j} + SLF4J 占位符，没装 Lombok 就把 {@code log} 换成项目自己的 Logger。
*/
@Slf4j
public class JsonUtilsDemo {

/** 示例用的 DTO，实际换成你自己的 */
public record Order(String name, Integer count) {
}

public record OrderForm(String name, Integer count) {
}

public record Event(String name, LocalDateTime at, LocalDate day, LocalTime time) {
}

public static void main(String[] args) {

// ========== 一、对象与 JSON 字符串互转 ==========

String json = JsonUtils.toJson(new Order("双十一订单", 3));
log.info("「JsonUtils 方法1 toJson(Object)」返回JSON字符串 -> {}", json);

String pretty = JsonUtils.toPrettyJson(new Order("双十一订单", 3));
log.info("「JsonUtils 方法2 toPrettyJson(Object)」返回美化JSON（共{}行）->{}",
pretty.lines().count(), System.lineSeparator() + pretty);

Order order = JsonUtils.parseObject(json, Order.class);
log.info("「JsonUtils 方法3 parseObject(json, Class)」返回对象 -> {}", order);

// ========== 二、泛型结构：List 与 Map ==========

List<Order> orders = JsonUtils.parseObject("[{\\"name\\":\\"甲\\",\\"count\\":1},{\\"name\\":\\"乙\\",\\"count\\":2}]",
new TypeReference<>() {
});
log.info("「JsonUtils 方法4 parseObject(json, TypeReference)」返回集合列表 -> {}", orders);

List<Order> list = JsonUtils.parseList("[{\\"name\\":\\"甲\\",\\"count\\":1}]", Order.class);
log.info("「JsonUtils 方法6 parseList(json, Class)」返回集合列表 -> {}", list);

Map<String, Order> map = JsonUtils.parseMap("{\\"k1\\":{\\"name\\":\\"甲\\",\\"count\\":1}}",
String.class, Order.class);
log.info("「JsonUtils 方法8 parseMap(json, Class, Class)」返回Map -> {}", map);

// ========== 三、日期时间契约与容错版 ==========

String eventJson = JsonUtils.toJson(new Event("下单",
LocalDateTime.of(2026, 10, 4, 20, 30, 0), LocalDate.of(2026, 10, 4), LocalTime.of(20, 30)));
log.info("「JsonUtils 方法1 toJson(Object)」日期按约定格式写出 -> {}", eventJson);

Event event = JsonUtils.parseObject(eventJson, Event.class);
log.info("「JsonUtils 方法3 parseObject(json, Class)」还原日期时间 -> {}", event);

Order parsed = JsonUtils.parseObjectQuietly("{不是合法JSON}", Order.class);
log.info("「JsonUtils 方法5 parseObjectQuietly(json, Class)」非法输入容错 -> {}", parsed);

List<Order> quietList = JsonUtils.parseListQuietly("{不是数组}", Order.class);
log.info("「JsonUtils 方法7 parseListQuietly(json, Class)」结构不符容错 -> {}", quietList);

// ========== 四、convertValue 与共享 ObjectMapper ==========

OrderForm form = new OrderForm("线下单", 5);
Order converted = JsonUtils.convertValue(form, Order.class);
log.info("「JsonUtils 方法9 convertValue(source, Class)」返回转换后对象 -> {}", converted);

List<Order> convertedList = JsonUtils.convertValue(List.of(Map.of("name", "丙", "count", 9)),
new TypeReference<>() {
});
log.info("「JsonUtils 方法10 convertValue(source, TypeReference)」返回集合列表 -> {}", convertedList);

ObjectMapper shared = JsonUtils.getObjectMapper();
log.info("「JsonUtils 方法11 getObjectMapper()」返回全局共享单例 -> 同一实例={}", shared == JsonUtils.getObjectMapper());

// ========== 五、异常：严格模式的两条线 ==========

try {
JsonUtils.parseObject("{\\"name\\":\\"甲\\",\\"count\\":1} 尾巴", Order.class);
} catch (IllegalStateException e) {
log.error("「异常信息获取演示」残缺报文被拒绝 -> {}", e.getMessage());
}

try {
JsonUtils.parseObject(null, Order.class);
} catch (IllegalArgumentException e) {
log.error("「异常信息获取演示」入参不合法 -> {}", e.getMessage());
}
}
}

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

📦 「点击此处可下载 Java企业级工具类全家桶-74-JSON序列化工具类」 的完整源码，拿来即用。

觉得对您有帮助，麻烦点点关注啦，您的关注是我创作的最大动力~ 🎯