Using our custom serializer and deserializer requires the @JsonSerialize and @JsonDeserialize annotations. Let’s pass our implementations to them:

public class Event implements TimeStampTracker {

    @JsonSerialize(using = CustomInstantSerializer.class)
    @JsonDeserialize(using = CustomInstantDeserializer.class)
    private Instant timeStamp;

    // standard getters and setters
}

讓我們測試它，斷言生成的 JSON 包含預期的格式化日期，並且在反序列化時，時間戳字段與我們的原始日期匹配：

@Test
void givenDefaultMapper_whenUsingCustomSerializerDeserializer_thenExpectedInstantFormat()
  throws JsonProcessingException {
    Event object = new Event();
    object.setTimeStamp(DATE);

    ObjectMapper mapper = new ObjectMapper();

    assertSerializedInstantMatchesWhenDeserialized(object, mapper);
}

這個方法對我們有幫助，如果我們在幾個類中具有 Instant 字段用於日期，或者想要在某些類中使用特定的序列化/反序列化技術。

4. 添加 JavaTimeModule 擴展

由於 Instant 不是 Jackson 支持的默認日期類型之一，因此我們需要將 JavaTimeModule 依賴添加到我們的 pom.xml：

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-jsr310</artifactId>
    <version>1.17.1</version>
</dependency>

如果沒有它，如果我們嘗試序列化包含 Instant 字段的類，我們將收到錯誤：

com.fasterxml.jackson.databind.exc.InvalidDefinitionException: 
  Java 8 日期/時間類型 `java.time.Instant` 不受默認支持

此依賴項包含 JavaTimeModule 類，稍後我們會使用它。

4.1. 使用 @JsonFormat 選擇自定義格式

默認情況下，ObjectMapper 將日期字段序列化為數字時間戳。 當調用 disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS), 我們可以在 JsonMapper.builder() 上關閉此行為，但它不會允許我們設置特定的格式。 這是因為調用 defaultDateFormat() 僅適用於 Date 和 long 值。 因此，使用特定格式的一種方法是使用 @JsonFormat 註解：

public class Session implements TimeStampTracker {

    @JsonFormat(pattern = Instants.DATE_FORMAT, timezone = "UTC")
    private Instant timeStamp;

    // 標準的 getter 和 setter
}

同樣重要的是設置 timezone 屬性。 由於我們使用 “UTC”，我們將在這裏重用它，以及我們在 pattern 字段中指定的日期格式。

4.2. 測試我們的解決方案

讓我們把它們全部組合起來測試序列化和反序列化：

@Test
void givenTimeModuleMapper_whenJsonFormat_thenExpectedInstantFormat() 
  throws JsonProcessingException {
    Session object = new Session();
    object.setTimeStamp(DATE);

    ObjectMapper mapper = JsonMapper.builder()
      .addModule(new JavaTimeModule())
      .build();

    assertSerializedInstantMatchesWhenDeserialized(object, mapper);
}

禁用 WRITE_DATES_AS_TIMESTAMPS 不會影響，因為我們使用 @JsonFormat，所以我們不會在這裏停用它。

5. 擴展 InstantSerializer 以自定義格式

Jackson 提供了大多數類型的序列化器，包括 InstantSerializer，它提供了一個單例，我們可以使用它與 JavaTimeModule 結合使用：

JavaTimeModule module = new JavaTimeModule();
module.addSerializer(Instant.class, InstantSerializer.INSTANCE);

然而，這種替代方案也限制了我們使用不同格式的能力。 並且，由於 InstantSerializer 不包含公共構造函數，我們將對其進行擴展：

public class GlobalInstantSerializer extends InstantSerializer {

    public GlobalInstantSerializer() {
        super(InstantSerializer.INSTANCE, false, false, Instants.FORMATTER);
    }
}