Jackson中字段序列化与反序列化挑战
在构建基于restful api的应用程序时，我们经常会遇到这样的场景：从服务器接收的json数据中包含某个标识符（如id），我们需要将其反序列化到java对象中进行业务逻辑处理。然而，在将该java对象作为请求体发送回服务器时，这个id字段可能需要被忽略，因为服务器通常会在创建或更新资源时自动生成或管理id。
例如，当获取一个产品信息时，JSON可能包含id和name：
{
"id": "1",
"name": "Product1"
}但在创建或更新产品时，我们通常只发送name，而id则不应出现在请求体中：
{
"name": "Product1"
}Jackson库默认的序列化和反序列化行为是双向的，即一个字段如果能被反序列化，通常也能被序列化。如果直接使用@JsonIgnore，则该字段在序列化和反序列化时都会被忽略，这不符合我们的需求。我们需要一种机制，让id字段在反序列化时有效，而在序列化时无效。
解决方案：@JsonProperty(access = JsonProperty.Access.WRITE_ONLY)
Jackson库提供了@JsonProperty注解的access属性，可以精确控制字段的序列化和反序列化行为。针对上述需求，我们可以使用JsonProperty.Access.WRITE_ONLY。
JsonProperty.Access.WRITE_ONLY的含义是：
- 反序列化（Deserialization）：当JSON字符串转换为Java对象时，Jackson会读取对应的JSON字段并将其值写入Java对象的该属性中。
- 序列化（Serialization）：当Java对象转换为JSON字符串时，Jackson会忽略该属性，不会将其包含在生成的JSON中。
简而言之，对于Jackson处理器而言，这个字段是“只写”的，即只能从JSON写入到Java对象，而不能从Java对象读取并写入到JSON。
实战示例
下面通过一个具体的Product类示例来演示如何使用@JsonProperty(access = JsonProperty.Access.WRITE_ONLY)来实现单向处理。
首先，定义Product类：
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
public class Product {
// id 字段在反序列化时可读（从JSON写入对象），但在序列化时将被忽略（不从对象写入JSON）
@JsonProperty(access = JsonProperty.Access.WRITE_ONLY)
private String id;
private String name;
// 构造函数
public Product() {}
public Product(String id, String name) {
this.id = id;
this.name = name;
}
// Getter 和 Setter 方法
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
@Override
public String toString() {
return "Product{id='" + id + "', name='" + name + "'}";
}
public static void main(String[] args) throws Exception {
ObjectMapper mapper = new ObjectMapper();
// 启用美化输出，方便查看
mapper.enable(SerializationFeature.INDENT_OUTPUT);
// 1. 从包含id的JSON字符串反序列化为Java对象
String incomingJson = """
{
"id": "123",
"name": "Laptop Pro"
}
""";
System.out.println("--- 反序列化测试 ---");
Product product = mapper.readValue(incomingJson, Product.class);
System.out.println("反序列化后的Java对象: " + product);
// 验证id是否被正确读取
System.out.println("Java对象中的ID: " + product.getId());
// 2. 将Java对象序列化回JSON字符串
// 此时，product对象中的id值为"123"
System.out.println("\n--- 序列化测试 ---");
String resultJson = mapper.writeValueAsString(product);
System.out.println("序列化后的JSON字符串:\n" + resultJson);
}
}运行结果：
--- 反序列化测试 ---
反序列化后的Java对象: Product{id='123', name='Laptop Pro'}
Java对象中的ID: 123
--- 序列化测试 ---
序列化后的JSON字符串:
{
"name" : "Laptop Pro"
}从输出结果可以看到，当我们将包含id的JSON字符串反序列化为Product对象时，id字段被成功读取并赋值给Java对象的id属性。然而，当我们将这个Product对象序列化回JSON字符串时，id字段被自动忽略，生成的JSON中只包含name字段。这完美地实现了我们对字段的单向处理需求。
JsonProperty.Access 枚举详解
JsonProperty.Access枚举提供了四种模式，用于更细粒度地控制字段的访问权限：
- READ_WRITE (默认)：字段在序列化和反序列化时都有效。这是Jackson的默认行为。
-
READ_ONLY：字段只在序列化时有效（从Java对象读取到JSON），在反序列化时会被忽略（不从JSON写入到Java对象）。
- 例如，一个计算属性，只希望在输出JSON中显示，而不允许外部通过JSON修改。
-
WRITE_ONLY：字段只在反序列化时有效（从JSON写入到Java对象），在序列化时会被忽略（不从Java对象读取到JSON）。
- 本文示例中使用的就是这种模式，适用于API请求体中包含、响应体中不包含的字段。
- AUTO：Jackson根据字段的可见性、是否存在Getter/Setter方法等自动推断访问权限。在大多数情况下，AUTO的行为与READ_WRITE相似，但提供了更大的灵活性，尤其是在与@JsonAutoDetect等注解配合使用时。
与@JsonIgnore的区别：@JsonIgnore注解会使Jackson在序列化和反序列化时都完全忽略该字段，除非通过其他方式（如@JsonInclude、@JsonSetter等）明确覆盖。而@JsonProperty(access = ...)则提供了更精细的控制，允许在序列化和反序列化之间选择性地启用或禁用字段。当只需要在单向操作中忽略字段时，access属性是更优的选择。
应用场景与注意事项
-
REST API设计：
- 创建/更新资源：请求体中可能包含一些只用于写入（如密码、临时ID）的字段，这些字段不应在响应中返回。
- 响应体优化：响应体中可能包含一些只用于读取（如服务器生成的ID、状态）的字段，这些字段不应在客户端发送的请求体中出现。
- 数据模型差异处理：当一个Java对象模型需要适应不同外部系统（如数据库、消息队列、不同版本的API）对JSON字段的不同期望时，access属性非常有用。
- 与其他Jackson注解的协同：@JsonProperty(access = ...)可以与其他Jackson注解（如@JsonFormat, @JsonInclude等）协同工作，共同构建复杂的数据映射逻辑。
- 可读性与维护性：明确使用access属性可以提高代码的可读性，清晰地表达字段的预期行为，减少因默认行为误解而导致的错误。
总结
@JsonProperty(access = JsonProperty.Access.WRITE_ONLY)是Jackson库中一个强大且实用的特性，它为开发者提供了对JSON字段序列化和反序列化行为的精细控制。通过合理利用此注解，我们可以优雅地处理API设计中常见的字段单向处理需求，避免了手动干预和复杂的自定义序列化器/反序列化器，从而提升了代码的简洁性、健壮性和可维护性。在设计和实现与JSON交互的Java应用程序时，深入理解并善用JsonProperty.Access枚举将大大提高开发效率。
