Jackson处理多别名JSON字段时优先选择非空值的策略与实践

import com.fasterxml.jackson.annotation.JsonSetter;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.Arrays;
import java.util.Objects;
import java.util.function.Predicate;

public class MyPojo {
    // 定义一个谓词，用于检查字符串是否为null或空
    public static final Predicate<String> NULL_OR_EMPTY = s -> s == null || s.isEmpty();

    private String name;

    // 核心setter，负责判断并更新字段
    @JsonSetter("name") // 映射到JSON字段"name"
    public void setName(String name) {
        // 只有当当前name字段为null或空时，才更新
        if (NULL_OR_EMPTY.test(this.name)) {
            this.name = name;
        }
    }

    // 别名setter 1，映射到JSON字段"full_name"
    @JsonSetter("full_name")
    public void setName1(String name) {
        setName(name); // 委托给核心setter
    }

    // 别名setter 2，映射到JSON字段"fullName"
    @JsonSetter("fullName")
    public void setName2(String name) {
        setName(name); // 委托给核心setter
    }

    // Getter方法
    public String getName() {
        return name;
    }

    @Override
    public String toString() {
        return "MyPojo{name='" + name + "'}";
    }

    public static void main(String[] args) throws Exception {
        // 示例JSON数据，其中"name"为null，"full_name"为空字符串，"fullName"为有效值
        String json = "{ \"name\" : null, \"full_name\" : \"\", \"fullName\" : \"name\"}";

        ObjectMapper mapper = new ObjectMapper();
        MyPojo myPojo = mapper.readValue(json, MyPojo.class);
        System.out.println(myPojo);

        // 示例2：第一个有效值
        json = "{ \"name\" : \"first\", \"full_name\" : \"\", \"fullName\" : \"name\"}";
        myPojo = mapper.readValue(json, MyPojo.class);
        System.out.println(myPojo);

        // 示例3：所有都为空或null
        json = "{ \"name\" : null, \"full_name\" : \"\", \"fullName\" : null}";
        myPojo = mapper.readValue(json, MyPojo.class);
        System.out.println(myPojo);
    }
}

MyPojo{name='name'}
MyPojo{name='first'}
MyPojo{name='null'}

import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.databind.util.StdConverter;

import lombok.Builder;
import lombok.Getter;
import lombok.ToString;

import java.util.Arrays;
import java.util.function.Predicate;

// 辅助POJO，用于接收所有可能的别名值
// 使用record可以简化代码
record AuxiliaryPojo(
    @JsonProperty("name") String name,
    @JsonProperty("full_name") String name1,
    @JsonProperty("fullName") String name2
) {}

// 自定义Converter，负责将AuxiliaryPojo转换为MyPojo
class AuxiliaryPojoToMyPojo extends StdConverter<AuxiliaryPojo, MyPojo> {
    // 定义一个谓词，用于检查字符串是否非null且非空
    public static final Predicate<String> NOT_NULL_OR_EMPTY = s -> s != null && !s.isEmpty();

    @Override
    public MyPojo convert(AuxiliaryPojo v) {
        // 从辅助POJO中找到第一个非null且非空的name值
        String selectedName = findMatching(v.name(), v.name1(), v.name2());
        // 构建最终的MyPojo实例
        return MyPojo.builder()
                .name(selectedName)
                .build();
    }

    // 辅助方法，用于从多个字符串中找到第一个非null且非空的字符串
    private String findMatching(String... args) {
        return Arrays.stream(args)
                .filter(NOT_NULL_OR_EMPTY)
                .findFirst() // 找到第一个匹配的
                .orElse(null); // 如果都没有匹配，则返回null
    }
}

// 最终的领域POJO，使用Lombok简化代码
@Getter
@Builder
@ToString
@JsonDeserialize(converter = AuxiliaryPojoToMyPojo.class) // 指定自定义Converter
public class MyPojo {
    private String name;

    public static void main(String[] args) throws Exception {
        // 示例JSON数据
        String json = "{ \"name\" : null, \"full_name\" : \"\", \"fullName\" : \"name\"}";

        ObjectMapper mapper = new ObjectMapper();
        MyPojo myPojo = mapper.readValue(json, MyPojo.class);
        System.out.println(myPojo);

        // 示例2：第一个有效值
        json = "{ \"name\" : \"first\", \"full_name\" : \"\", \"fullName\" : \"name\"}";
        myPojo = mapper.readValue(json, MyPojo.class);
        System.out.println(myPojo);

        // 示例3：所有都为空或null
        json = "{ \"name\" : null, \"full_name\" : \"\", \"fullName\" : null}";
        myPojo = mapper.readValue(json, MyPojo.class);
        System.out.println(myPojo);
    }
}

MyPojo(name=name)
MyPojo(name=first)
MyPojo(name=null)