Jackson序列化&&FastJson序列化API使用

Java中的RPC(遠程服務調用)可以通過序列化的方式進行。

JDK英文文檔,墻裂不推薦看中文!!!

1. Jackson 進行JSON的解析和序列化

1.1 Jackson的API

ObjectMapper的API文檔

1 需要注意的是:

  • ObjectMapperJSON操作的核心,Jackson的JSON操作都是在ObjectMapper中實現的。
  • ObjectMapper有多個JSON序列化的方法,可以把JSON串保存在FileOutputStream等不同的介質中。

2 Jackson的API:`

  • writeValue(File resultFile, Object value)可以用于所有Java值的序列化,將JSON輸出到File中。

  • writeValue(OutputStream out, Object value) 可以用于所有Java對象的序列化,并將JSON串保存到流中。注意,此方法不會顯示的關閉流。

  • writeValueAsString(Object value)可以用于任何Java對象的序列化方式,并輸出字符串。等效于writeValue(Writer,Object) 并構造String,但是效率更高。

  • writeValueAsBytes(Object value)可用于任何Java對象的序列化方式,并輸出byte[]數組。等效于writeValue(Writer,Object) 并得到byte[]數組,注意數組的編碼是UTF-8

  • <T> T readValue(String content, Class<T> valueType)注意,我們在傳入Class<T>對象,注意一般是傳入Class<?>,因為Class類中并不使用泛型對象,但是此處使用泛型對象,因為我們的返回值就是T,避免了類型強轉。溫故知新——泛型實踐篇

3. Jackson提供的注解
Jackson提供了一系列的注解,方便對JSON序列化和反序列化進行控制,下面介紹一些常用的注解:

  • JsonIgnore 此注解用于屬性上,作用是Json操作時,忽略該屬性。
  • JsonFormat 此注解用于屬性上, 作用是把Date類型轉化成為想要的格式。
  • JsonProperty 此注解用于屬性上,作用是把改屬性的名稱序列化成另一個名稱。
  • JsonSerialize 此注解用于屬性上,作用是指定屬性序列化的類型。
  • JsonDeserialize 此注解用于屬性上,作用是指定屬性反序列化的類型。

1.2 Jackson源碼分析

1.2.1 源碼

1. 引入MAVEN依賴:

     <!--Jackson的API-->
      <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.9.4</version>
        </dependency>
      <!--JDK1.8時間類序列化-->
      <dependency>
            <groupId>com.fasterxml.jackson.datatype</groupId>
            <artifactId>jackson-datatype-jsr310</artifactId>
      </dependency>

2. 實體類

public class User implements Serializable {

    private String name;
    private List<String> sports;
    //序列化格式
    //@JsonSerialize(using = LocalDateSerializer.class)
    //反序列化格式
    //@JsonDeserialize(using = LocalDateDeserializer.class)
    //Json格式
    //@JsonFormat(pattern = "yyyy-MM-dd")
    private LocalDate date;
   //節省篇幅,省略get/set方法
}

3. 測試類:

public static void main(String[] args) {
        //創建用戶對象
        User user = new User();
        user.setName("小胖");
        List sports = new ArrayList<>();
        sports.add("足球");
        sports.add("游泳");
        user.setSports(sports);
        user.setDate(LocalDate.now());
        //創建對象
        //Json序列化和反序列化
        ObjectMapper mapper = new ObjectMapper();
//        mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
//        mapper.registerModule(new JavaTimeModule());
        //User轉化為Json
        try {
            //對象轉化為Json數據
            String s = mapper.writeValueAsString(user);
            System.out.println("s:" + s);
            //Json轉化為對象
            User user1 = mapper.readValue(s, User.class);
            System.out.println(user1.toString());
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

注意點:Jackson序列化對象時,對象必須實現getXxx方法。但是對象中若存在普通方法以get開頭,那么在序列化時,也會將該方法進行序列化。此時需要在方法上添加@JsonIgnore注解。

public class School {

    @JsonIgnore
    public String getData(){
        User user = new User();
        return user.getFields().get(0);
    }
}

1.2.2 源碼分析

首先注意的是JDK1.8中時間類,采用了一套新的API。

在這里我們采用是LocalDate類,若是User類中,沒有使用注解,那么序列化結果為:

{
    "name": "小胖",
    "sports": ["足球", "游泳"],
    "date": {
        "year": 2019,
        "month": "MARCH",
        "chronology": {
            "id": "ISO",
            "calendarType": "iso8601"
        },
        "dayOfMonth": 27,
        "dayOfWeek": "WEDNESDAY",
        "dayOfYear": 86,
        "era": "CE",
        "monthValue": 3,
        "leapYear": false
    }
}

顯然,這不是我們預期的Json串。并且,我們在反序列化過程中,會出現異常:

com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Cannot construct instance of java.time.LocalDate (no Creators, like default construct, exist):
cannot deserialize from Object value (no delegate- or property-based Creator)
at [Source: (String)"{"name":"小胖","sports":["足球","游泳"],"date":{"year":2019,"month":"MARCH","chronology":{"id":"ISO","calendarType":"iso8601"},"dayOfMonth":27,"dayOfWeek":"WEDNESDAY","dayOfYear":86,"era":"CE","monthValue":3,"leapYear":false}}"; line: 1, column: 43] (through reference chain: com.JsonSerializer.User["date"])

大概意思:就是LocalDate的沒有參數是Object的構造函數。不能實例化對象。


華麗的分割線SpringBoot的處理

SpringBoot的解決方案:

  1. 首先在MAVEN 中加入ckson-datatype-jsr310依賴。
<dependency>
  <groupId>com.fasterxml.jackson.datatype</groupId>
  <artifactId>jackson-datatype-jsr310</artifactId>
</dependency>
  1. 配置Configuration中的ObjectMapper
@Bean
public ObjectMapper serializingObjectMapper() {
  ObjectMapper objectMapper = new ObjectMapper();
  objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
  objectMapper.registerModule(new JavaTimeModule());
  return objectMapper;
}

Java bean的解決方案:
Java Bean中使用注解,就可以進行反序列化和序列化。

    //序列化格式
    @JsonSerialize(using = LocalDateSerializer.class)
    //反序列化格式
    @JsonDeserialize(using = LocalDateDeserializer.class)
    //Json格式
    @JsonFormat(pattern = "yyyy-MM-dd")
    private LocalDate date;

執行結果:

Jackson序列化和反序列化的結果

1.3 Jackson序列化工具類

為了便于使用Jackson進行序列化操作,故實現該工具類:

@Slf4j
public class JacksonUtils {

    private static ObjectMapper objectMapper = new ObjectMapper();


    /**
     * 將對象序列化為JSON
     */
    public static <T> String toJSONString(T obj) {
        try {
            return objectMapper.writeValueAsString(obj);
        } catch (JsonProcessingException e) {
            log.error("序列化失敗", e);
            throw new RuntimeException(e);
        }
    }


    /**
     * @param str   反序列化的JSON串
     * @param clazz 反序列化的目標對象
     */
    public static <T> T parseObject(String str, Class<T> clazz) {
        try {
            return objectMapper.readValue(str, clazz);
        } catch (IOException e) {
            log.error("反序列化失敗", e);
            throw new RuntimeException(e);
        }
    }

    /**
     * 帶泛型的反序列化
     *
     * @param str  待序列化的字符串
     * @param type {@code new TypeReference<List<Student>>(){}}
     * @param <T>  泛型對象
     * @return 序列化為泛型對象
     */
    public static <T> T parseObject(String str, TypeReference<T> type) {
        try {
            return objectMapper.readValue(str, type);
        } catch (JsonProcessingException e) {
            log.error("反序列化失敗", e);
            throw new RuntimeException(e);
        }
    }

    /**
     * 驗證字符串是否為JSON格式。
     * <p>
     * 注意:該方法是比較簡易的判斷,只是判斷字符串以什么開頭。
     *
     * @param str 待驗證的字符串
     * @return true:為JSON格式,false不為JSON格式
     */
    public static boolean validateJSON(String str) {
        return str.startsWith("{") || str.startsWith("[");
    }

}

2. FastJson 序列化

2.1 FastJson的API

FastJson是性能極好的JSON解析器和生成器。

1. FastJson的優點:

  • 速度快:超越其他任何java json parser
  • 功能強大:支持Java BeanCollectionMap、日期、枚舉、支持泛型和自省。
  • 零依賴:只依賴于JDK

2. FastJson的主要類:

  1. JSON:FastJson解析器,用于JSON格式字符串與JSON對象以及javaBean之間轉換。
  2. JSONObject:FastJson提供的json對象。
  3. JSONArray:FastJson提供的json數組對象。

2.2 FastJson的準備工作

1. FastJson的MAVEN依賴:

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.2</version>
        </dependency>

2. JSON準備:

    private static final String OBJ_JSON = "{\"studentName\":\"lily\",\"studentAge\":12}";
    private static final String ARR_JSON = "[{\"studentName\":\"lily\",\"studentAge\":12},{\"studentName\":\"lucy\",\"studentAge\":15}]";
    private static final String COMPLEX_JSON = "{\"teacherName\":\"crystall\",\"teacherAge\":27,\"course\":{\"courseName\":\"english\",\"code\":1270},\"students\":[{\"studentName\":\"lily\",\"studentAge\":12},{\"studentName\":\"lucy\",\"studentAge\":15}]}";

ARR_JSON格式:

[{
    "studentName": "lily",
    "studentAge": 12
}, {
    "studentName": "lucy",
    "studentAge": 15
}]

COMPLEX_JSON格式:

{
    "teacherName": "crystall",
    "teacherAge": 27,
    "course": {
        "courseName": "english",
        "code": 1270
    },
    "students": [{
        "studentName": "lily",
        "studentAge": 12
    }, {
        "studentName": "lucy",
        "studentAge": 15
    }]
}

2.3 JSON字符串和JSONObject或JSONArray之間的轉換

我們日常操作是:JSON字符串JavaBean對象之間的轉換。但是為什么存在JSONObject或者JSONArray對象呢?因為我們不想為每一個JSON字符串都創建一個Bean對象,但是我們還是想像對象一樣操作JSON串時。就可這樣操作

2.3.1 JSON字符串和JSONObject之間的轉換

1 JSON到JSONObject的轉換;
JSONObject object = JSONObject.parseObject(OBJ_JSON);

  1. JSONObject到JSON的轉換;
    String toJSONString = JSONObject.toJSONString(object);
JSONObject和JSON的轉換

2.3.2 數組對象型——JSON和JSONArray轉換

  1. JSON到JSONArray的轉換;
    JSONArray jsonArray = JSONArray.parseArray(ARR_JSON);
    需要注意的是JSONArray實現了List<Object>接口。
  2. JSONArray到JSON的轉換;
    String string = jsonArray.toJSONString();

2.3.3 如何操作JSONObject對象

  1. 獲取JSONObject里面的JSONObject對象;
    jsonObject.getJSONObject("course");
  2. 獲取JSONObject里面的JSONArray對象;
    jsonObject.getJSONArray("students");
  3. 獲取JSONObject里面的String或基本數據類型;
    jsonObject.getXXX("students");
  public static void main(String[] args) {
        JSONObject jsonObject = JSONObject.parseObject(COMPLEX_JSON);
        //獲取JSON中的參數
        jsonObject.getString("teacherName");
        //獲取JSON中的對象
        jsonObject.getJSONObject("course");
        //獲取JSON中數組
        jsonObject.getJSONArray("students");
        //JSON轉換為Object
        String jsonString = jsonObject.toJSONString();
        System.out.println("序列化后的對象"+jsonString);
    }

2.4 JSON字符串和JavaBean之間的轉換

JSON和JavaBean之間的轉化,其實是將轉化Bean的class對象傳入即可。

    public static <T> T parseJWT2Sub(String token, Class<T> clazz) {
        SecretKey key = obtainKey();
        Claims body = Jwts.parser().setSigningKey(key).parseClaimsJws(token).getBody();
        return JSON.parseObject(body.getSubject(), clazz);
    }

2.4.1 JSON轉化為Object(TypeReference方式)

FastJson中提供了一個可用來處理泛型反序列化的類TypeRefernce

2.4.1.1 TypeRefrence進行反序列化

通過設置new TypeReference<Teacher<String>>() {};,JSON字符串反序列化成Teacher對象會保留泛型<String>;

使用方式:github的使用文檔

1. 通過TypeReference處理泛型對象

     Teacher<String> teacher = JSONObject.parseObject(COMPLEX_JSON, new TypeReference<Teacher<String>>() {
        });

2. 使用getType()可以獲取更好的性能。

        Type type = new TypeReference<Teacher<String>>() {
        }.getType();
        Teacher<String> teacher = JSONObject.parseObject(COMPLEX_JSON, type);

2.4.1.2 TypeRefrence源碼分析

1. TypeRefrence部分源碼分析:

public class TypeReference<T> {
    static ConcurrentMap<Type, Type> classTypeCache = new ConcurrentHashMap(16, 0.75F, 1);
    protected final Type type;
    public static final Type LIST_STRING = (new TypeReference<List<String>>() {
    }).getType();

    protected TypeReference() {
        Type superClass = this.getClass().getGenericSuperclass();
        Type type = ((ParameterizedType)superClass).getActualTypeArguments()[0];
        Type cachedType = (Type)classTypeCache.get(type);
        if (cachedType == null) {
            classTypeCache.putIfAbsent(type, type);
            cachedType = (Type)classTypeCache.get(type);
        }

        this.type = cachedType;
    }

    public Type getType() {
        return this.type;
    }

為什么這里的構造方法要是protected的,即我們無法直接創建該對象,只能使用匿名類創建子類對象。

getGenericSuperclass()的API方法

public Type getGenericSuperclass();

  • Returns the Type representing the direct superclass of the entity (class, interface, primitive type or void) represented by this Class.
  • If the superclass is a parameterized type, the Type object returned must accurately reflect the actual type parameters used in the source code.

返回Class對象(類,接口,基本數據類型,void)的直接父類的Type類型。
如果父類是parameterized [p?'r?m?t?ra?zd]類型(也可以理解為父類是泛型對象),那么返回的參數類型是父類的泛型類型。

基本原理:

  • 類型擦除是擦除的方法中Code字節碼,但是會把泛型類型保存在Signature中,不能通過反射直接獲取,但是可以通過子類獲取父類的泛型類型。

  • 類型擦除不會將元數據(即類結構)上的泛型擦除,還是可以通過反射直接獲取。復習盤點——泛型擦除

  • 可以通過匿名內部類的方式獲取子類,在這里,推薦使用protected構造方法,創建匿名類。復習盤點——內部類


2.4.2 JSON轉化為Object(Class方式)

不保留泛型的反序列化。

使用public static <T> T parseObject(String text, Class<T> clazz)方法,邊可完成JSON的反序列化。

1. 特殊JSON反序列化

需要注意的是,若是text為null的情況下,最后反序列化的結構也是為null

 public static void main(String[] args) {
        UserPO userPO = JSON.parseObject(null, UserPO.class);
        System.out.println(userPO);    //若是null,反序列化對象也是null
        UserPO userPO1 = JSON.parseObject("", UserPO.class);
        System.out.println(userPO1);  //若是空串,拋出異常
        UserPO userPO2 = JSON.parseObject("{}", UserPO.class);
        System.out.println(userPO2);  //若是空JSON,返回空對象
    }

2. 泛型丟失

Teacher teacher = JSONObject.parseObject(COMPLEX_JSON, Teacher.class);

我們可以看到,因為返回值需要泛型類型T所以我們采用的是Class<T>,防止返回Object對象,讓用戶強轉。但需要注意:這種方式在反序列化的時候,會丟失泛型類型。

2.4.3 JSON轉化為Object集合對象

方式一:TypeReference

//獲取數組對象的List<Student>的Type
Type type = new TypeReference<ArrayList<Student>>() {
}.getType();

List<Student> list = JSONObject.parseObject(ARR_JSON, type);
System.out.println(list);

方式二:使用parseArray

    List<Student> students = JSONObject.parseArray(ARR_JSON, Student.class);

2.4.4 Object轉化為(自定義格式)的JSON

我們通過:fastjson如何json數組串轉換為Object[]時如何指定各個數據項的數據類型引出fastjson SerializerFeature對象

我們可以通過這個API,完成Bean對象轉換成String類型。
String toJSONString(Object object, SerializerFeature... features)

SerializerFeature模式的使用
  Student stu = new Student();
        stu.setStudentAge(null);
        stu.setStudentName("黎明");
        String toJSONString = JSONObject.toJSONString(stu,
                SerializerFeature.PrettyFormat,
                SerializerFeature.WriteNullStringAsEmpty,  //如果字符串是空,那么返回"",而非不返回
                SerializerFeature.WriteNullNumberAsZero,  //如果字符串是空,那么返回0,而不是不返回、
                SerializerFeature.WriteClassName,     //序列化時寫入類型信息,反序列化時用到
                SerializerFeature.DisableCircularReferenceDetect); //消除對同一對象循環引用問題。
        System.out.println(toJSONString);
SerializerFeature序列化方式

2.5 JSON轉化為Object到底采用哪種方式

在項目中,一般都是使用JSON進行數據的傳輸。那么通常采用Class方式還是TypeRefrence方式進行反序列化呢?

1. JSON轉化為簡單對象

若是對象的屬性只是簡單數據類型(基本數據類型,或者String類型)那么可以使用Class方式轉化為Object對象。

JSON.parseObject(dataInfo.getData(), Order.class);

2. JSON轉化為復雜對象

若是一個對象里面的屬性依舊是一個對象,那么我們就可以使用TypeRefrence進行轉換。

public class ApiResponseVo<T> {
    private String subCode;
    private String subMsg;
    private String count;
    private List<T> list;
    //省略 getter、setter方法
}

我們在將JSON轉換為對象的時候,就可以保留List<T>的泛型。即:

ApiResponseVo<Order> apiResponseVo=
JSON.parseObject(dataInfo.getData(), new TypeReference<ApiResponseVo<Order>>(){});

參考文章:
Java下利用Jackson進行JSON解析和序列化

使用FastJson處理JSON數據

fastjson如何json數組串轉換為Object[]時如何指定各個數據項的數據類型

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,825評論 6 546
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,814評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,980評論 0 384
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 64,064評論 1 319
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,779評論 6 414
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,109評論 1 330
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,099評論 3 450
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,287評論 0 291
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,799評論 1 338
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,515評論 3 361
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,750評論 1 375
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,221評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,933評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,327評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,667評論 1 296
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,492評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,703評論 2 380