Jackson中@JsonProperty等常用註解

  • 2019 年 10 月 21 日
  • 筆記

Java生態圈中有很多處理JSON和XML格式化的類庫,Jackson是其中比較著名的一個。雖然JDK自帶了XML處理類庫,但是相對來說比較低級

本文將介紹的Jackson常用註解:精簡概述

 

Jackson的依賴

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

 

1.@JsonProperty:此註解作用於屬性上,作用是把該屬性的名稱序列化成另一個自己想要的名稱

對屬性名進行重命名,在java里我們墨守規定駝峰命名,但是在一些特殊的場合下,比如資料庫是下劃線等,再此我們就可以進行映射

對屬性名稱重命名,比如在很多場景下Java對象的屬性是按照規範的駝峰書寫,但在資料庫設計時使用的是下劃線連接方式,此處在進行映射的時候 

 

public class CatNode {      //@JsonProperty 指定將java對象轉化為json格式的時候,對應的key      @JsonProperty(value = "u")      private String url;      @JsonProperty(value = "n")      private String name;      @JsonProperty(value = "i")      private List<?> list;        public String getUrl() {          return url;      }        public void setUrl(String url) {          this.url = url;      }        public String getName() {          return name;      }        public void setName(String name) {          this.name = name;      }        public List<?> getList() {          return list;      }        public void setList(List<?> list) {          this.list = list;      }  }

 

2.@JsonIgnore註解用於屬性或者方法上,用來完全忽略被注釋的欄位和方法對應的屬性,即便這個還有其它註解,

一般標記在屬性或者方法上,返回的json數據不包含被該註解引用的屬性或者方法

 

例如下面程式碼中:我們不想讓a屬性被轉換成json格式數據,即這個類jishi轉換成json格式,也不會包含該屬性欄位。

public class Test{       @JsonIgnore     private String a;       private String b;    }

 

3.@JsonFormat可以幫助我們完成格式轉換,

例如我們在進行json轉換的時候包含日期,通常不經過處理的話會是一個不是很友好的格式,那麼我們就可以通過@JsonFormat來進行指定格式

例如:

@JsonFormat(timezone="GTM+8",pattern="yyyy-MM-dd HH:mm:ss")  private Date createDate;

 

4.@JsonIgnoreProperties可以幫我們忽略類中不存在的欄位

例如:@JsonIgnoreProperties(ignoreUnknown = true)

還可以指定忽略類中多個欄位在類被轉成json的格式忽略掉

@JsonIngoreProperties(value={"name","sex"})  public class Test{      private String name;      private String pwd;      private String sex;  }

 

 

@JsonIgnoreProperties和@JsonIgnore我們日常使用中最大的區別就是前者修飾類的,後者多用於修飾類中的屬性

 

具體可以查看官方文檔:

https://fasterxml.github.io/jackson-annotations/javadoc/2.6/com/fasterxml/jackson/annotation/JsonIgnoreProperties.html