JSON資料處理框架Jackson精解第一篇-序列化與反序列化核心用法

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


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

一、基礎準備

在任意專案中引入下面的jar就可以使用jackson進行JSON的資料序列化與反序列化的功能。

<dependency>
	<groupId>com.fasterxml.jackson.core</groupId>
	<artifactId>jackson-databind</artifactId>
	<version>2.9.8</version>
</dependency>

寫一個PlayerStar的實體類,實體類主要體現籃球明星的名字、年齡、業餘愛好、朋友、年收入等資訊,為了儘可能地演示Jackson的序列化與反序列化功能,將陣列、List、Map都融合到這個類裡面。並通過getInstance初始化籃球明星Jordan這個物件。

@Data
public class PlayerStar {

  private String name;
  private Integer age;
  private String[] hobbies;    //業餘愛好,陣列
  private List<String> friends;   //  朋友
  private Map<String, BigDecimal> salary; //年收入 Map


  //初始化一個物件用於測試
  public static PlayerStar getInstance(){
    PlayerStar playerStar = new PlayerStar();

    playerStar.setName("喬丹");
    playerStar.setAge(45);
    playerStar.setHobbies(new String[]{"高爾夫球", "棒球"});
    Map<String, BigDecimal> salary = new HashMap<String, BigDecimal>() {{
      put("2000", new BigDecimal(10000000));
      put("2010", new BigDecimal(62000000));
      put("2020", new BigDecimal(112400000));
    }};
    playerStar.setSalary(salary);
    playerStar.setFriends(Arrays.asList("kobe", "curry", "james"));

    return playerStar;
  }

}

二、序列化方法

下面程式碼演示瞭如何將PlayerStar物件序列化為JSON字串。

  • writeValue可以接收File作為引數,將JSON序列化結果儲存到檔案中
  • writeValueAsString將JSON序列化結果以String形式返回
  • writerWithDefaultPrettyPrinter方法可以將JSON序列化結果進行格式化,更好的顯示結構,易於檢視
@Test
void testObject2JSON() throws IOException {
  //獲取物件例項
  PlayerStar player = PlayerStar.getInstance();

  //ObjectMapper作為Jackson的API工具類存在
  ObjectMapper mapper = new ObjectMapper();
  //將player物件以JSON格式進行序列化,並將序列化結果寫入檔案
  mapper.writeValue(new File("d:\\data\\jackson\\player.json"), player);

  //將player物件以JSON格式進行序列化為String物件
  String jsonString = mapper.writeValueAsString(player);
  System.out.println(jsonString);

  //將player物件以JSON格式進行序列化為String物件(格式美化)
  String jsonInString2 = mapper.writerWithDefaultPrettyPrinter()
          .writeValueAsString(player);
  System.out.println(jsonInString2);
}

jsonString的控制檯列印輸出結果,也是d:\data\jackson\player.json檔案的內容


{"name":"喬丹","age":45,"hobbies":["高爾夫球","棒球"],"friends":["kobe","curry","james"],"salary":{"2000":10000000,"2010":62000000,"2020":112400000}}

jsonString2的控制檯列印輸出,格式進行了美化,因為使用了writerWithDefaultPrettyPrinter()方法

{
  "name" : "喬丹",
  "age" : 45,
  "hobbies" : [ "高爾夫球", "棒球" ],
  "friends" : [ "kobe", "curry", "james" ],
  "salary" : {
    "2000" : 10000000,
    "2010" : 62000000,
    "2020" : 112400000
  }
}

三、反序列化方法

下面程式碼演示瞭如何將JSON字串反序列化為Java物件

@Test
void testJSON2Object() throws IOException {
  ObjectMapper mapper = new ObjectMapper();
  //從檔案中讀取JSON字串,反序列化為java物件
  PlayerStar player = mapper.readValue(new File("d:\\data\\jackson\\player.json"), PlayerStar.class);
  System.out.println(player);

  //將JSON字串反序列化為java物件
  String jsonInString = "{\"name\":\"喬丹\",\"age\":45,\"hobbies\":[\"高爾夫球\",\"棒球\"]}";
  PlayerStar jordan = mapper.readValue(jsonInString, PlayerStar.class);

  System.out.println(jordan);

}

PlayerStar物件控制檯輸出結果如下(注意這裡的輸出不是JSON格式,而是java物件的toString()方法值):

PlayerStar(name=喬丹, age=45, hobbies=[高爾夫球, 棒球], friends=[kobe, curry, james], salary={2000=10000000, 2010=62000000, 2020=112400000})
PlayerStar(name=喬丹, age=45, hobbies=[高爾夫球, 棒球], friends=null, salary=null)

四、欄位重新命名 @JsonProperty

可以使用 @JsonProperty來影響序列化和反序列化物件屬性的重新命名。

@Data
public class PlayerStar {

  @JsonProperty("playerName")
  private String name;  //將屬性name序列化為playerName,同時影響反序列化

使用上面程式碼的註解之後,JSON序列化的結果name屬性變成playerName屬性

{"playerName":"喬丹"  ……

同時影響反序列化,下面的反序列化程式碼會報錯,因為使用了name屬性。應該使用playerName才可以。

String jsonInString = "{\"name\":\"喬丹\",\"age\":45,\"hobbies\":[\"高爾夫球\",\"棒球\"]}";
PlayerStar jordan = mapper.readValue(jsonInString, PlayerStar.class);

五、忽略null欄位的序列化@JsonInclude

當我們不為物件的成員變數賦值的時候,預設情況下,Jackson的序列化結果是下面的這樣的。

{
  "age" : 45,
  "hobbies" : null,
  "friends" : null,
  "salary" : null,
  "playerName" : "喬丹"
}

如果我們不希望將null值,體現在JSON序列化結果中,我們可以使用下面的方法。如果希望在某次序列化的全域性範圍內,忽略null成員變數,可以使用下面的API

ObjectMapper mapper = new ObjectMapper();
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);

或者是在類名的上面加上如下註解。該註解將針對類裡面的所有成員變數生效,只要成員變數為null,將不會被包含在序列化結果中。

@JsonInclude(JsonInclude.Include.NON_NULL)
public class PlayerStar {
   ......
}

如果我們想針對PlayerStar類裡面某些成員變數單獨忽略null,可以在成員變數上面加註解。

@JsonInclude(JsonInclude.Include.NON_NULL)
private String[] hobbies;    //業餘愛好,陣列
@JsonInclude(JsonInclude.Include.NON_NULL)
private List<String> friends;   //  朋友
@JsonInclude(JsonInclude.Include.NON_NULL)
private Map<String, BigDecimal> salary; //年收入 Map

忽略為null的成員變數後,JSON序列化結果是下面這樣的

{
  "age" : 45,
  "playerName" : "喬丹"
}

六、忽略指定的欄位

預設情況下,jackson不會將static和transient的成員變數進行序列化與反序列化操作。我們還可以通過

  • @JsonIgnore加在類成員變數上面,該成員變數將被排除在序列化和反序列化的過程之外
  • @JsonIgnoreProperties加在類宣告上面,指定該類裡面哪些欄位被排除在序列化和反序列化的過程之外

上面的兩種註解選其一即可,下面的程式碼兩種註解我都用了,功能是重複的

@Data
@JsonIgnoreProperties({"hobbies", "friends","salary"})
public class PlayerStar {

  @JsonProperty("playerName")
  private String name;
  private Integer age;

  @JsonIgnore
  private String[] hobbies;    //業餘愛好,陣列
  @JsonIgnore
  private List<String> friends;   //  朋友
  @JsonIgnore
  private Map<String, BigDecimal> salary; //年收入 Map

......

在類或成員變數上面加上註解之後,序列化結果如下,指定欄位被忽略。

{
  "age" : 45,
  "playerName" : "喬丹"
}

需要注意的是這兩個註解不只是影響序列化為JSON字串的過程,也影響JSON字串反序列化為java物件的過程。舉例:如果JSON字串包含了類中被JsonIgnore的屬性值hobbies,不會被反序列化賦值給java物件的成員變數hobbies。

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

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

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

相關文章