如何自定义Jackson序列化 @JsonSerialize

下面是我对于如何自定义Jackson序列化 @JsonSerialize的完整攻略，包括两条示例说明：

什么是Jackson序列化？

Jackson是一个常用的Java数据序列化库，可以将Java对象转换为JSON格式的数据并输出。在序列化的过程中，Jackson将Java对象属性映射为JSON键值对，同时支持自定义序列化逻辑。

@JsonSerialize 注解简介

@JsonSerialize是Jackson库中的一个注解，用于指定一个Java类属性在被序列化为JSON格式时应该如何编码。可以通过自定义@JsonSerialize注解的实现类来实现自定义的序列化逻辑。

自定义Jackson序列化的步骤

1.定义一个实现了JsonSerializer类的Jackson自定义序列化器类

public class MyCustomSerializer extends JsonSerializer<MyCustomType> {
    @Override
    public void serialize(MyCustomType value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        // 实现自定义的序列化逻辑
        gen.writeString(value.toString());
    }
}

2.使用@JsonSerialize注解指定自定义序列化器类

public class MyClass {
    @JsonSerialize(using = MyCustomSerializer.class)
    private MyCustomType myCustomField;
    // other fields
}

3.注册自定义序列化器类到ObjectMapper中

ObjectMapper mapper = new ObjectMapper();
SimpleModule module = new SimpleModule("MyModule");
module.addSerializer(MyCustomType.class, new MyCustomSerializer());
mapper.registerModule(module);

示例1：自定义序列化一个自定义数据类型

如果你需要序列化一个自定义的数据类型，例如下面的例子中的Pair类，你可以通过实现一个PairSerializer类来自定义Pair类型的序列化逻辑。

public class Pair {
    public int x;
    public int y;
    public Pair(int x, int y) {
        this.x = x;
        this.y = y;
    }
}

public class PairSerializer extends JsonSerializer<Pair> {
    @Override
    public void serialize(Pair value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        gen.writeStartObject();
        gen.writeStringField("pair", value.x + ";" + value.y);
        gen.writeEndObject();
    }
}

public class Main {
    public static void main(String[] args) throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        SimpleModule module = new SimpleModule("MyModule");
        module.addSerializer(Pair.class, new PairSerializer());
        mapper.registerModule(module);
        Pair pair = new Pair(1, 2);
        String json = mapper.writeValueAsString(pair);
        System.out.println(json);
    }
}

当运行Main类的时候，将输出以下JSON数据：

{"pair":"1;2"}

示例2：自定义序列化一个Java内置数据类型

如果你需要自定义序列化Java内置的数据类型，例如下面的例子中的LocalDate类，你需要实现一个LocalDateSerializer类来自定义LocalDate类型的序列化逻辑。

public class LocalDateSerializer extends JsonSerializer<LocalDate> {
    @Override
    public void serialize(LocalDate value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        gen.writeStartObject();
        gen.writeNumberField("year", value.getYear());
        gen.writeNumberField("month", value.getMonthValue());
        gen.writeNumberField("day", value.getDayOfMonth());
        gen.writeEndObject();
    }
}

public class Order {
    public int id;
    @JsonSerialize(using = LocalDateSerializer.class)
    public LocalDate createDate;
    // other fields and methods
}

public class Main {
    public static void main(String[] args) throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        SimpleModule module = new SimpleModule("MyModule");
        module.addSerializer(LocalDate.class, new LocalDateSerializer());
        mapper.registerModule(module);
        Order order = new Order();
        order.id = 1;
        order.createDate = LocalDate.of(2019, 12, 31);
        String json = mapper.writeValueAsString(order);
        System.out.println(json);
    }
}