引言
在现代Java开发中，JSON（JavaScript Object Notation）已经成为数据交换的标准格式。无论是与前端进行数据交互，还是调用第三方API，我们都需要频繁地处理JSON数据。而JSON映射技术让我们能够轻松地在JSON字符串和Java对象之间进行转换，大大简化了数据处理的复杂性。
什么是JSON映射？
JSON映射是指将JSON格式的数据与Java对象进行相互转换的过程：
- 反序列化（Deserialization）：将JSON字符串转换为Java对象
- 序列化（Serialization）：将Java对象转换为JSON字符串
这种转换让我们能够用面向对象的方式处理JSON数据，提高代码的可读性和维护性。
环境准备
首先，我们需要在项目中引入Jackson依赖：
<dependency>
<groupId>***.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.15.2</version>
</dependency>
同时，为了简化代码，我们使用Lombok来减少样板代码：
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.28</version>
</dependency>
核心组件介绍
ObjectMapper
ObjectMapper是Jackson库的核心类，负责执行JSON和Java对象之间的转换操作。它提供了以下主要方法：
-
readValue(String json, Class<T> valueType)：将JSON字符串转换为指定类型的Java对象 -
writeValueAsString(Object value)：将Java对象转换为JSON字符串 -
writerWithDefaultPrettyPrinter()：生成格式化的JSON字符串
实体类设计
为了演示JSON映射，我们定义一个用户实体类：
@Data
static class User {
private String name;
private int age;
private Map<String, String> contacts = new HashMap<>();
@Override
public String toString() {
return "User{name='" + name + "', age=" + age + ", contacts=" + contacts + "}";
}
}
这里使用了@Data注解自动生成getter、setter等方法，contacts字段使用Map来存储联系方式信息。
实践演示
1. JSON反序列化：从字符串到对象
public static void main(String[] args) throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
// 定义JSON输入数据
String jsonInput = """
{
"name": "面包",
"age": 21,
"contacts": {
"email": "bread@example.***",
"phone": "13800999999"
}
}
""";
// 将JSON字符串转为Java对象
User user = mapper.readValue(jsonInput, User.class);
System.out.println("解析结果: " + user);
// 获取具体字段值
String email = user.getContacts().get("email");
System.out.println("提取的邮箱: " + email);
}
输出结果：
解析结果: User{name='面包', age=21, contacts={email=bread@example.***, phone=13800999999}}
提取的邮箱: bread@example.***
2. JSON序列化：从对象到字符串
// 创建新的用户对象
User newUser = new User();
newUser.setName("李四");
newUser.setAge(30);
newUser.getContacts().put("wechat", "lisi123");
// 转换为格式化的JSON字符串
String jsonOutput = mapper.writerWithDefaultPrettyPrinter()
.writeValueAsString(newUser);
System.out.println("生成的JSON:\n" + jsonOutput);
输出结果：
{
"name" : "李四",
"age" : 30,
"contacts" : {
"wechat" : "lisi123"
}
}
高级特性
1. 处理复杂嵌套结构
JSON映射不仅支持基本数据类型，还能处理复杂的嵌套结构：
@Data
static class ***pany {
private String ***panyName;
private List<User> employees;
private Map<String, Object> metadata;
}
2. 自定义字段映射
使用@JsonProperty注解可以自定义字段映射：
@Data
static class Product {
@JsonProperty("product_name")
private String productName;
@JsonProperty("unit_price")
private Double unitPrice;
}
3. 忽略未知字段
通过配置可以忽略JSON中存在但Java类中不存在的字段：
ObjectMapper mapper = new ObjectMapper();
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
最佳实践
1. 异常处理
JSON解析可能会抛出异常，建议进行适当的异常处理：
try {
User user = mapper.readValue(jsonString, User.class);
// 处理用户对象
} catch (JsonProcessingException e) {
logger.error("JSON解析失败: {}", e.getMessage());
// 错误处理逻辑
}
2. ObjectMapper重用
ObjectMapper是线程安全的，建议创建单例进行重用：
public class JsonUtil {
private static final ObjectMapper MAPPER = new ObjectMapper();
public static <T> T fromJson(String json, Class<T> clazz) {
try {
return MAPPER.readValue(json, clazz);
} catch (JsonProcessingException e) {
throw new RuntimeException("JSON解析失败", e);
}
}
public static String toJson(Object obj) {
try {
return MAPPER.writeValueAsString(obj);
} catch (JsonProcessingException e) {
throw new RuntimeException("对象序列化失败", e);
}
}
}
3. 数据验证
在实际项目中，建议对解析后的对象进行数据验证：
@Data
static class User {
@NotBlank(message = "姓名不能为空")
private String name;
@Min(value = 0, message = "年龄不能为负数")
@Max(value = 150, message = "年龄不能超过150")
private int age;
private Map<String, String> contacts = new HashMap<>();
}
性能优化建议
- 重用ObjectMapper实例：避免频繁创建ObjectMapper对象
- 使用流式API：处理大型JSON文件时考虑使用JsonGenerator和JsonParser
- 配置合理的特性：根据需要禁用不必要的特性来提升性能
- 考虑使用注解：通过注解来优化序列化和反序列化过程
常见问题与解决方案
1. 日期格式问题
ObjectMapper mapper = new ObjectMapper();
mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
2. 空值处理
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
3. 枚举处理
mapper.configure(DeserializationFeature.READ_ENUMS_USING_TO_STRING, true);
总结
JSON映射在日常开发运用的还是比较多，特别是进入公司之后，大段的json数据让分析。
这里再推荐一个很好用的在线json工具
Code Beautify and Code Formatter For Developers - to Beautify, Validate, Minify, JSON, XML, JavaScript, CSS, HTML, Excel and more
