知識庫 / JSON / Jackson RSS 訂閱

讓我們將一個空 Sample 實例轉換為一個 map，以驗證由於我們的自定義默認值，只有 amount 字段才會出現：

@Test
void whenSerializingNonDefault_thenOnlyNonJavaDefaultsIncluded() {
    ObjectMapper mapper = new ObjectMapper();
    mapper.setSerializationInclusion(Include.NON_DEFAULT);

    Sample zeroArg = new Sample();
    Map<String, Serializable> map = mapper.convertValue(
      zeroArg, Map.class);

    assertEquals(zeroArg.getAmount(), map.get("amount"));
    assertEquals(1, map.keySet().size());
}

精簡的序列化使得在修補對象時更容易確定要更新哪些字段。

5. 修補方法

現在，讓我們運用對 Jackson 如何處理缺失和 null 值以及 null 值的理解，將其應用於實際場景：部分更新。

簡而言之，處理部分更新有多種方法。我們來看兩種：

• 僅更新非 null 值，因為 null 值表示“此值未更改”
• 更新所有非缺失值，因為 null 值和非缺失值表示“此值應設置為 null”

讓我們來看一些實現這些方法的事實代碼，偏離了常規的“複製所有屬性”方法，同時利用我們的 Jackson 配置。

5.1. 只更新非空值

我們的第一種方法是忽略序列化後所有的 null 值。 這樣，在發送補丁時，我們只需要關注我們想要更改的值：

void updateIgnoringNulls(String json, Sample current) 
  throws JsonProcessingException {
    Sample update = MAPPER.readValue(json, Sample.class);

    if (update.getId() != null)
        current.setId(update.getId());

    if (update.getName() != null)
        current.setName(update.getName());

    current.setAmount(update.getAmount());

    if (update.getKeys() != null)
        current.setKeys(update.getKeys());

    if (update.getValues() != null)
        current.setValues(update.getValues());
}

如果不需要擔心刪除現有值，此解決方案效果很好。

5.2. 測試非空字段更新策略

讓我們添加一些設置來測試這一點，首先在我們的 Sample 類中添加一些默認值：

public static Sample basic() {
    Sample defaults = new Sample();

    List keys = List.of("foo", "bar");
    List values = List.of(1, 2);

    defaults.setId(1l);
    defaults.setKeys(keys);
    defaults.setValues(values);

    return defaults;
}

然後，我們通過僅包含 JSON 輸入中的 values 字段來測試，檢查該字段是否已更新，以及缺失的字段是否保留了值：

@Test
void whenPatchingNonNulls_thenNullsIgnored() {
    List<Integer> values = List.of(3);

    Sample defaults = Sample.basic();

    String json = """
      {
        "values": %s
      }
    """.formatted(values);

    updateIgnoringNulls(json, defaults);

    assertEquals(values, defaults.getValues());
    assertNotNull(defaults.getKeys());
}

5.3. 更新所有非空值

我們的下一項解決方案會更新 JSON 輸入中包含的所有字段，即使這些字段為 null 也是如此：

void updateNonAbsent(String json, Sample current) 
  throws JsonProcessingException {
    Map<String, Serializable> update = MAPPER.readValue(json, Map.class);

    if (update.containsKey("id"))
        current.setId((Long) update.get("id"));

    if (update.containsKey("name"))
        current.setName((String) update.get("name"));

    if (update.containsKey("amount"))
        current.setAmount((int) update.get("amount"));

    if (update.containsKey("keys"))
        current.setKeys((List<String>) update.get("keys"));

    if (update.containsKey("values"))
        current.setValues((List<Integer>) update.get("values"));
}