当前位置：首页 > news >正文

Lombok与Jackson实现高效JSON序列化与反序列化

news 2025/5/27 13:34:51

引言

在Java开发中，处理JSON数据是常见需求，而Jackson作为广泛使用的JSON库，能够高效地将Java对象与JSON互相转换。然而，传统的POJO（Plain Old Java Object）需要手动编写大量样板代码（如getter、setter、构造器等），这不仅繁琐还容易出错。此时，Lombok的注解（如@Data和@AllArgsConstructor）可以极大简化开发。本文将探讨如何结合Lombok与Jackson，实现简洁高效的JSON序列化与反序列化。

一、Jackson 序列化与反序列化的基本原理

Jackson通过反射机制直接访问对象的字段或方法，无需依赖Serializable接口。其核心流程如下：

序列化（Object → JSON）：通过反射读取对象的字段值（或调用getter方法），生成JSON字符串。
反序列化（JSON → Object）：解析JSON数据，通过反射调用构造器或setter方法创建并填充对象。

二、Lombok 注解的魔力

Lombok通过在编译时自动生成代码，减少了样板代码的编写。以下是关键注解的作用：

@Data：

自动生成getter、setter、equals()、hashCode()和toString()方法。

@AllArgsConstructor：

生成包含所有字段的全参构造器。

示例：传统POJO vs. Lombok优化


// 传统写法：手动编写大量代码public class User {private String name;private int age;public User() {}public User(String name, int age) { /* ... */ }// 省略 getter/setter/equals/hashCode/toString...}// 使用Lombok：一行注解代替所有代码@Data@AllArgsConstructorpublic class User {private String name;private int age;}

三、结合Lombok与Jackson的完整示例

以下是一个完整的代码示例，展示如何实现JSON转换：

1. 添加依赖

确保项目中包含Lombok和Jackson的依赖（以Maven为例）：


<dependencies><!-- Lombok --><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.24</version><scope>provided</scope></dependency><!-- Jackson --><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.13.3</version></dependency></dependencies>

2. 定义POJO类


@Data@AllArgsConstructorpublic class User {private String name;private int age;}

3. 序列化与反序列化


import com.fasterxml.jackson.databind.ObjectMapper;public class Demo {public static void main(String[] args) throws Exception {ObjectMapper mapper = new ObjectMapper();// 序列化：对象 → JSONUser user = new User("Alice", 30);String json = mapper.writeValueAsString(user);System.out.println(json); // 输出: {"name":"Alice","age":30}// 反序列化：JSON → 对象String inputJson = "{\"name\":\"Bob\",\"age\":25}";User parsedUser = mapper.readValue(inputJson, User.class);System.out.println(parsedUser); // 输出: User(name=Bob, age=25)}}

四、解决常见问题

问题1：反序列化时缺少无参构造器

默认情况下，Jackson通过无参构造器创建对象，但@AllArgsConstructor仅生成全参构造器，此时反序列化会报错：


com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Cannot construct instance of `User`: no creators found.

解决方案：

方法1：添加@NoArgsConstructor

显式生成无参构造器：

```java

@Data

@AllArgsConstructor

@NoArgsConstructor

public class User { /* … */ }

```

方法2：使用@JsonCreator注解

指定全参构造器为反序列化的入口：

```java

@Data

@AllArgsConstructor

public class User {

@JsonCreator

public User(@JsonProperty(“name”) String name, @JsonProperty(“age”) int age) {

this.name = name;

this.age = age;

}

```

问题2：自定义序列化行为

若需忽略空字段或重命名字段，可使用Jackson注解：


@Data@AllArgsConstructor@NoArgsConstructorpublic class User {@JsonProperty("username") // 重命名字段private String name;@JsonInclude(JsonInclude.Include.NON_NULL) // 忽略空值private Integer age;}