Java中的JSON映射详解：从入门到实践

M-bao

于 2025-06-25 15:23:39 发布

阅读量1k

点赞数 10

CC 4.0 BY-SA版权

文章标签： java json 开发语言

本文链接：https://blog.csdn.net/qq_74042166/article/details/148900052

引言

在现代Java开发中，JSON（JavaScript Object Notation）已经成为数据交换的标准格式。无论是与前端进行数据交互，还是调用第三方API，我们都需要频繁地处理JSON数据。而JSON映射技术让我们能够轻松地在JSON字符串和Java对象之间进行转换，大大简化了数据处理的复杂性。

什么是JSON映射？

JSON映射是指将JSON格式的数据与Java对象进行相互转换的过程：

反序列化（Deserialization）：将JSON字符串转换为Java对象
序列化（Serialization）：将Java对象转换为JSON字符串

这种转换让我们能够用面向对象的方式处理JSON数据，提高代码的可读性和维护性。

环境准备

首先，我们需要在项目中引入Jackson依赖：

<dependency>
    <groupId>com.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.com",
                "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.com, phone=13800999999}}
提取的邮箱: bread@example.com

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 Company {
    private String companyName;
    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