Jaskson精講第7篇-類繼承關係下的JSON序列化與反序列化JsonTypeInfo

字母哥部落格發表於2020-09-28

Jackson是Spring Boot(SpringBoot)預設的JSON資料處理框架,但是其並不依賴於任何的Spring 庫。有的小夥伴以為Jackson只能在Spring框架內使用,其實不是的,沒有這種限制。它提供了很多的JSON資料處理方法、註解,也包括流式API、樹模型、資料繫結,以及複雜資料型別轉換等功能。它雖然簡單易用,但絕對不是小玩具,更多的內容我會寫成一個系列,5-10篇文章,請您繼續關注我。

本篇文章是系列文章的第7篇,主要是為大家介紹一下,在Java 類繼承的情況下如何實現父類及子類的JSON序列化與反序列化。

一、繼承關係物件構建

首先構建一個ClsShape類表示形狀。

public class ClsShape {
}

構建一個ClsCircle 類表示圓形。並新增了一系列的lombok註解,Data表示提供get、set、toString、hashCode等方法;EqualsAndHashCode註解在有繼承關係的字類中使用;AllArgsConstructor和NoArgsConstructor分別提供全參和無參構造方法。

@Data
@EqualsAndHashCode(callSuper = true)
@AllArgsConstructor
@NoArgsConstructor
public class ClsCircle extends ClsShape {
  Integer radius;    //弧度
}

構建一個長方形類ClsRectangle ,成員變數width寬度,height高度。

@Data
@EqualsAndHashCode(callSuper = true)
@AllArgsConstructor
@NoArgsConstructor
public class ClsRectangle extends ClsShape {
  private Integer width;
  private Integer height;
}

構建一個ClsView類,表示畫面。畫面中有很多的ClsShape形狀,所以用一個List封裝。

@Data
public class ClsView {
  private List<ClsShape> shapes;
}

二、序列化與反序列化測試

基礎的形狀類及畫面類寫完之後,下面的程式碼是用來完成:物件到Json字串的序列化過程,和Json字串反序列化為Java物件的過程程式碼。

@Test
void testJSON2Object() throws IOException {
  ClsRectangle rectangle = new ClsRectangle(7,9); //構建正方形物件
  ClsCircle circle = new ClsCircle(8); //構建長方形物件
  List<ClsShape> shapes = new ArrayList<>();  //List<多種形狀>
  shapes.add(circle);
  shapes.add(rectangle);
  ClsView view = new ClsView();  //將List放入畫面View
  view.setShapes(shapes);

  ObjectMapper mapper = new ObjectMapper();
  System.out.println("-- 序列化 --");
  String jsonStr = mapper.writeValueAsString(view);
  System.out.println(jsonStr);

  System.out.println("-- 反序列化 --");
  ClsView deserializeView = mapper.readValue(jsonStr, ClsView.class);
  System.out.println(deserializeView);

}

大家看最終在控制檯的輸出結果如下:序列化的過程是正常的,但是反序列化的時候報錯了。

-- 序列化 --
{"shapes":[{"radius":8},{"width":7,"height":9}]}

-- 反序列化 --
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field "radius" (class com.example.demo.javabase.ClsShape), not marked as ignorable (0 known properties: ])
 at [Source: (String)"{"shapes":[{"radius":8},{"width":7,"height":9}]}"; line: 1, column: 23] (through reference chain: com.example.demo.javabase.ClsView["shapes"]->java.util.ArrayList[0]->com.example.demo.javabase.ClsShape["radius"])

丟擲異常的主要原因是我們用來接收反序列化的結果時,使用的是List<ClsShape>,Java程式並不明確的知道,這個ClsShape形狀是圓形ClsCircle,還是正方形ClsRectangle。所以無法將字串正確的反序列化為java物件。

三、@JsonTypeInfo註解加到父類定義上

為了解決上面的這種繼承關係物件的反序列化出現的問題,jackson為我們提供了JsonTypeInfo註解,把它加在父類定義上面即可。

@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)
public class ClsShape {
}

在父類定義上面加上@JsonTypeInfo註解之後,序列化與反序列化的輸出結果如下。

-- 序列化 --
{"shapes":[
{"@class":"com.example.demo.javabase.ClsCircle","radius":8},
{"@class":"com.example.demo.javabase.ClsRectangle","width":7,"height":9}
]}
-- 反序列化 --
ClsView(shapes=[ClsCircle(radius=8), ClsRectangle(width=7, height=9)])

值得注意的是在序列化之後的java字串中,每個Json物件都包含了一個新的屬性@class,這也是該物件在繼承關係下能夠反序列化為正確的java物件(@class的值的類物件)的關鍵所在。

四、@JsonTypeInfo註解加到包含父類的成員變數上面

@JsonTypeInfo註解不僅可以加在父類的定義上面,也可以加到包含父類的成員變數上面。序列化和反序列化的結果和第三小節中的內容是一樣的。

@Data
public class ClsView {
  @JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)
  private List<ClsShape> shapes;
}

歡迎關注我的部落格,裡面有很多精品合集

  • 本文轉載註明出處(必須帶連線,不能只轉文字):字母哥部落格

覺得對您有幫助的話,幫我點贊、分享!您的支援是我不竭的創作動力! 。另外,筆者最近一段時間輸出瞭如下的精品內容,期待您的關注。

相關文章