本文探讨了在使用jackson进行json反序列化时，如何处理多个json字段代表同一逻辑属性，并从中优先选择非空或非null值的情况。文章提供了两种主要策略：一是通过定义多个带有条件逻辑的`@jsonsetter`方法来智能处理；二是通过实现自定义`stdconverter`结合辅助pojo，以更清晰地分离关注点，实现灵活且可维护的反序列化逻辑。
问题背景与挑战
在与第三方系统集成时，我们常常会遇到JSON数据模型中存在冗余字段的情况。例如，一个逻辑上的“名称”信息可能在JSON中以name、full_name或fullName等多个字段表示。更具挑战性的是，这些字段可能并非总是同时存在或同时包含有效值，有时只有一个字段是非空或非null的。
例如，以下JSON结构展示了这种场景：
{ "name" : null, "full_name" : "", "fullName" : "John Doe"}在这种情况下，我们期望Jackson能够智能地选择fullName字段的值来映射到POJO的name属性。
Jackson的@JsonAlias注解提供了一种处理别名的方式，但它主要用于匹配多个字段名中的任意一个，并不会自动忽略null或空值。它通常按照定义的顺序或内部处理机制选择第一个匹配到的值，即使该值为null。因此，我们需要更高级的策略来满足“优先选择非空非null别名”的需求。
策略一：利用多个智能Setter方法
一种直接的方法是为POJO中的目标属性定义多个Setter方法，每个方法对应一个可能的JSON别名。通过@JsonSetter注解将这些Setter与特定的JSON字段关联起来。在这些Setter方法内部，我们可以加入条件逻辑，确保只有当当前POJO属性的值为null或空时，才更新它。
实现示例
首先，定义一个静态的Predicate来检查字符串是否为null或空，这有助于代码复用。
import com.fasterxml.jackson.annotation.JsonSetter;
import java.util.function.Predicate;
public class MyPojo {
// 用于检查字符串是否为null或空的Predicate
public static final Predicate<String> NULL_OR_EMPTY =
s -> s == null || s.isEmpty();
private String name;
// 核心Setter方法，包含更新逻辑
@JsonSetter("name")
public void setName(String name) {
// 只有当当前name属性为null或空时才进行更新
if (NULL_OR_EMPTY.test(this.name)) {
this.name = name;
}
}
// 为"full_name"别名定义的Setter，委托给核心setName方法
@JsonSetter("full_name")
public void setFullNameAlias(String name) {
setName(name);
}
// 为"fullName"别名定义的Setter，委托给核心setName方法
@JsonSetter("fullName")
public void setCamelCaseFullNameAlias(String name) {
setName(name);
}
// Getter方法
public String getName() {
return name;
}
@Override
public String toString() {
return "MyPojo{name='" + name + "'}";
}
}使用示例
import com.fasterxml.jackson.databind.ObjectMapper;
public class DeserializationExample {
public static void main(String[] args) throws Exception {
String json = "{ \"name\" : null, \"full_name\" : \"\", \"fullName\" : \"John Doe\"}";
ObjectMapper mapper = new ObjectMapper();
MyPojo myPojo = mapper.readValue(json, MyPojo.class);
System.out.println(myPojo);
// 预期输出: MyPojo{name='John Doe'}
}
}优缺点分析
- 优点： 实现相对直观，不需要引入额外的类，对于少量别名和简单逻辑比较适用。
-
缺点：
- POJO污染： 领域对象MyPojo中包含了多个功能类似的Setter方法，增加了类的复杂性。
- 违反单一职责原则： Setter方法除了设置属性外，还承担了值验证和选择的逻辑，这通常被认为是“智能Setter”的反模式。
- 可维护性差： 当需要处理的别名或属性增多时，POJO会变得非常臃肿且难以维护。
策略二：自定义Converter实现解耦
为了解决“智能Setter”带来的问题，我们可以采用更专业、更解耦的方法：自定义Jackson Converter。Converter允许我们在Jackson完成初步反序列化后，将一个POJO（通常是辅助性的，用于直接映射原始JSON结构）转换成另一个POJO（我们的目标领域对象）。
实现思路
- 定义辅助POJO： 创建一个辅助性的POJO，其字段直接映射JSON中所有可能的别名。这个POJO的职责是简单地接收原始JSON数据，不包含任何业务逻辑。
- 实现Converter： 创建一个继承自StdConverter的自定义转换器。这个转换器将负责从辅助POJO中提取数据，并根据非空非null的逻辑，构建出最终的目标领域POJO。
- 应用Converter： 在目标领域POJO上使用@JsonDeserialize(converter = ...)注解，指定我们自定义的转换器。
实现示例
1. 辅助POJO (AuxiliaryPojo)
这个POJO用于直接接收所有可能的JSON别名，不做任何逻辑处理。这里使用Java 17+的record类型，简洁高效。
import com.fasterxml.jackson.annotation.JsonProperty;
// 辅助POJO，直接映射所有可能的JSON字段
public record AuxiliaryPojo(
@JsonProperty("name") String name,
@JsonProperty("full_name") String name1,
@JsonProperty("fullName") String name2
) {}2. 自定义转换器 (AuxiliaryPojoToMyPojo)
这个转换器负责从AuxiliaryPojo中选择第一个非null且非空的name值，并构建MyPojo实例。
import com.fasterxml.jackson.databind.util.StdConverter;
import java.util.Arrays;
import java.util.function.Predicate;
public class AuxiliaryPojoToMyPojo extends StdConverter<AuxiliaryPojo, MyPojo> {
// 用于检查字符串是否为非null且非空的Predicate
public static final Predicate<String> NOT_NULL_OR_EMPTY =
s -> s != null && !s.isEmpty();
@Override
public MyPojo convert(AuxiliaryPojo v) {
// 从辅助POJO的多个name字段中查找第一个非null非空的值
String selectedName = findMatching(v.name(), v.name1(), v.name2());
// 使用Builder模式构建MyPojo实例（假设MyPojo支持Builder）
return MyPojo.builder()
.name(selectedName)
.build();
}
// 辅助方法，用于从可变参数中查找第一个满足条件的字符串
private String findMatching(String... args) {
return Arrays.stream(args)
.filter(NOT_NULL_OR_EMPTY) // 过滤掉null或空字符串
.findFirst() // 找到第一个匹配项
.orElse(null); // 如果没有找到，则返回null
}
}3. 目标领域POJO (MyPojo)
通过@JsonDeserialize注解指定使用自定义的Converter。注意，此时MyPojo无需包含任何与别名或值选择相关的逻辑，保持了其领域模型的纯净性。这里假设使用了Lombok的@Getter、@Builder和@ToString注解。
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import lombok.Builder;
import lombok.Getter;
import lombok.ToString;
@Getter
@Builder
@ToString
@JsonDeserialize(converter = AuxiliaryPojoToMyPojo.class) // 指定使用自定义Converter
public class MyPojo {
private String name;
}使用示例
import com.fasterxml.jackson.databind.ObjectMapper;
public class DeserializationExample {
public static void main(String[] args) throws Exception {
String json = "{ \"name\" : null, \"full_name\" : \"\", \"fullName\" : \"John 
