Gson源码分析之Json结构抽象和注解使用

github上的博客地址：
http://chuyun923.github.io/blog/2015/01/06/gsonyuan-ma-fen-xi/

XML和Json做为最经常使用的两种网络传输格式而被普遍使用，XML在早期数据传输中做为首选，可是近年来Json以其轻量级和更容易编写和解析而愈来愈流行，Gson做为google的一个开源Json解析框架提供了稳定和快速解析的功能，能够读读它的源代码了解一番。

说到Gson，其实它无非就是作两个工做，序列化(Object--->JsonString)和反序列化(JsonString--->Object)，后文所说的两个方向从Object到String和String到Object的两个方向。可想而知，对于序列化来讲，是较为容易的工做，而对于反序列化即Json解析才是Gson的重头戏。既然是对Json字符串的解析，那么少不了对Json字符串中的结构进行抽象。

Json抽象类

JsonElement

这是Json中元素的基类，它只提供了若干个类型判断的接口，简单判断这个Json元素的类型。如下几个类型都是它的子类。

一、JsonObject

包含多个JsonElement的集合，它在Json中对应这种类型的数据：

{
    "count":100,
    "users":[],
    "paging":{
        "offset":0,
        "limit":10,
        "hasMore":true
    }
}

这个data是一个典型的JsonObject，它以{开头，其中包含了一些相似数值，数组，对象等其余JsonElement的内容。其实每个Json字符串的根节点都是一个JsonObject。

JsonObject提供了比较多的方法来获得Json中的信息，addProperty()函数能够在当前Json节点下新建子结点。

二、JsonArray

JsonArray也表示JsonElement的集合，注意：Json中的数组并不要求全部的数据类型都同样。

[true,"hello"] //JsonArray,包括一个boolean和一个hello类型。

须要讨论的是JsonArray和JsonObject的区别是什么？从集合的角度来讲，JsonObject中的JsonElement是无序的，而JsonArray中的集合元素是有序的，从直观感觉来讲，你能够经过下标来引用JsonArray中的元素，而JsonObject是经过键值对的方式来访问的,get("name")--->value。

三、JsonPrimitive

对应Json中的基本类型，好比boolean，int，固然提供了基本类型和包装类的自动替换。

"count":100

四、JsonNull

空，对应null

"person":null

以上就是Gson对应Json结构的封装。

注解-Annotations

Expose

在对象进行序列化和反序列化的过程当中，咱们能够经过注解来屏蔽某一些字段。这个注解默认有两个参数，serialize和deserialize都是默认true。若是设置为false，表示这个序列化(反)的过程当中，这一个属性不须要进行处理。

经过Expose标注的属性在直接new Gson()的状况下不能生效，咱们必须经过Gson gson = new GsonBuilder().excludeFieldsWithoutExposeAnnotation().create()来建立一个能够识别Expose注解的Gson。

小小的吐槽一把，这个地方的使用确实不太方便，举个栗子，通常来讲，咱们进行序列化的时候都是但愿某一个属性不会序列化到Json字符里面(反之亦然)，因此这里的通常思惟是我要去处理这些特殊的属性。而若是你想经过Expose来去掉10个属性中的某一个，对不起，10个属性你都须要加上@Expose,而后对你想要处理的那个属性的Expose注解增长false参数，简直就是坑爹。。。。

//我想让Person类在序列化时，不去序列化password，是否是很坑爹？
class Person {
    @Expose
    private String userName;
    @Expose (serialize = false)
    private String passWord;
}

此外，和java自己的序列化同样，若是一个属性设置为transient或者static,那么两个序列化的两个方向上都会屏蔽掉这个属性，虽然比Expose简单，可是不够灵活。

SerializedName

这个注解使用较多，它会改变两个方向上这个属性的名称，在序列化是，JsonElement的键值会被替换成这个名字；解析时，Json中键值为这个名字的JsonElement会赋值给被注解的属性。

class Person {

@SerializedName(value = "A")
private int a ＝ 1;
private int b = 2;
}

//{"A":1,"b":2}  这个Json字符串和前面的Person等价

它使用场景最多的地方就是好比后端返回的json中的名称和咱们定义的model类名称不同时使用。

Since 和 Until

咱们能够对咱们的Model类进行序列化(两个方向)的版本控制，Since和Until恰好是两个相反的意义。

例子：

class Person {
    @Since(value = 1.0)     //GsonBuilder指定版本要从1.0开始的Gson才能解析
    private int a = 1;
    
    @Until(value = 1.5)   //GsonBuilder指定版本到1.5的Gson均可以解析，超过了不能解析
    private int b = 2;
}

和Expose同样，要想Gson识别这两个注解，一样须要经过GsonBuilder.setVersion(double).create()来实现。

未完