如何配置JSON实现值对象的平序列化与反序列化？最简方案是什么？

不需要自行编写序列化器与反序列化器，借助Jackson的@JsonValue和@JsonCreator两个注解就能实现需求，让EmailAddress在API Schema中以字符串形式呈现，而非嵌套对象。

具体修改步骤 #

1. 序列化配置（对象转字符串）：在EmailAddress的value字段对应的getter方法上添加@JsonValue注解，告诉Jackson直接序列化该字段的字符串值，而非整个对象结构。
2. 反序列化配置（字符串转对象）：在静态工厂方法of上添加@JsonCreator注解，让Jackson知道用传入的字符串参数调用该方法创建EmailAddress实例。

修改后的代码示例 #

@Getter
@ToString
@Embeddable
@NoArgsConstructor(access = AccessLevel.PROTECTED, force = true)
@EqualsAndHashCode
public class EmailAddress {
    private final String value;

    // 显式定义工厂方法并添加@JsonCreator，用于反序列化
    @JsonCreator
    public static EmailAddress of(String value) {
        return new EmailAddress(value);
    }

    // 添加@JsonValue，指定序列化时直接输出value的字符串值
    @JsonValue
    public String getValue() {
        return value;
    }

    public static String getValue(EmailAddress object) {
        if(object == null)
            return null;
        return object.value;
    }
}

效果说明 #

• 序列化：当API返回包含EmailAddress的对象时，会直接输出字符串格式，例如{"email": "user@example.com"}，而非嵌套的{"email": {"value": "user@example.com"}}。
• 反序列化：前端传入字符串格式的邮箱地址时，Jackson会自动调用of方法将其转换为EmailAddress实例，无需传递嵌套结构。

内容的提问来源于stack exchange，提问作者user2590727