Jackson – 將對象解映射到集合/數組 - Data,Jackson,Java Collections, 知識庫詳情

1. 概述

本教程將演示如何使用 Jackson 2 將 JSON 數組反序列化為 Java 數組或集合。

如果您想深入瞭解並學習更多使用 Jackson 2 的技巧 – 請訪問主 Jackson 教程。

2. 將對象反序列化為數組

Jackson 可以輕鬆地將對象反序列化為 Java 數組：

@Test
public void givenJsonArray_whenDeserializingAsArray_thenCorrect() 
  throws JsonParseException, JsonMappingException, IOException {
 
    ObjectMapper mapper = new ObjectMapper();
    List<MyDto> listOfDtos = Lists.newArrayList(
      new MyDto("a", 1, true), new MyDto("bc", 3, false));
    String jsonArray = mapper.writeValueAsString(listOfDtos);
 
    // [{"stringValue":"a","intValue":1,"booleanValue":true},
    // {"stringValue":"bc","intValue":3,"booleanValue":false}]

    MyDto[] asArray = mapper.readValue(jsonArray, MyDto[].class);
    assertThat(asArray[0], instanceOf(MyDto.class));
}

3. 將 JSON 解讀為集合

將相同的 JSON 數組讀取到 Java 集合中會比較困難——默認情況下，Jackson 將無法獲取完整的泛型類型信息 而是會創建一個 LinkedHashMap 實例的集合：

@Test
public void givenJsonArray_whenDeserializingAsListWithNoTypeInfo_thenNotCorrect() 
  throws JsonParseException, JsonMappingException, IOException {
 
    ObjectMapper mapper = new ObjectMapper();

    List<MyDto> listOfDtos = Lists.newArrayList(
      new MyDto("a", 1, true), new MyDto("bc", 3, false));
    String jsonArray = mapper.writeValueAsString(listOfDtos);

    List<MyDto> asList = mapper.readValue(jsonArray, List.class);
    assertThat((Object) asList.get(0), instanceOf(LinkedHashMap.class));
}

有兩個方法可以幫助 Jackson 瞭解正確的類型信息——我們可以使用庫中提供的 TypeReference，專門為此目的而設：

@Test
public void givenJsonArray_whenDeserializingAsListWithTypeReferenceHelp_thenCorrect() 
  throws JsonParseException, JsonMappingException, IOException {
 
    ObjectMapper mapper = new ObjectMapper();

    List<MyDto> listOfDtos = Lists.newArrayList(
      new MyDto("a", 1, true), new MyDto("bc", 3, false));
    String jsonArray = mapper.writeValueAsString(listOfDtos);

    List<MyDto> asList = mapper.readValue(
      jsonArray, new TypeReference<List<MyDto>>() { });
    assertThat(asList.get(0), instanceOf(MyDto.class));
}

我們也可以使用重載的 readValue 方法，該方法接受一個 JavaType：

@Test
public void givenJsonArray_whenDeserializingAsListWithJavaTypeHelp_thenCorrect() 
  throws JsonParseException, JsonMappingException, IOException {
    ObjectMapper mapper = new ObjectMapper();

    List<MyDto> listOfDtos = Lists.newArrayList(
      new MyDto("a", 1, true), new MyDto("bc", 3, false));
    String jsonArray = mapper.writeValueAsString(listOfDtos);

    CollectionType javaType = mapper.getTypeFactory()
      .constructCollectionType(List.class, MyDto.class);
    List<MyDto> asList = mapper.readValue(jsonArray, javaType);
 
    assertThat(asList.get(0), instanceOf(MyDto.class));
}

最後需要注意的是，MyDto 類需要包含無參數默認構造函數——如果缺少該構造函數，Jackson 將無法實例化它：

com.fasterxml.jackson.databind.JsonMappingException: 
No suitable constructor found for type [simple type, class org.baeldung.jackson.ignore.MyDto]: 
can not instantiate from JSON object (need to add/enable type information?)

或者，我們還可以使用 @JsonCreator 註解來調整用於反序列化的構造函數。

4. 結論

將 JSON 數組映射到 Java 集合是 Jackson 最常用的任務之一，這些解決方案 對於實現正確、類型安全的映射至關重要.

知識庫 / JSON / Jackson RSS 訂閱