Gson 源码分析 总结

1   Gson 的简单使用：

简单对象的序列化和反序列化：

Gson gson = new Gson(); // Or use new GsonBuilder().create();
MyType target = new MyType();
String json = gson.toJson(target); // serializes target to Json
MyType target2 = gson.fromJson(json, MyType.class); // deserializes json into target2

集合类型的序列化和反序列化：

Type listType = new TypeToken>() {}.getType();
List target = new LinkedList();
target.add("blah");
Gson gson = new Gson();
String json = gson.toJson(target, listType);
List target2 = gson.fromJson(json, listType);

2   Gson 的源码解析：

 

2.1  Gson 的总体结构

Gson的类结构很简单，共约12个类，8个接口，2个枚举。其中主要和外界打交道的类就com.google.gson.Gson和com.google.gson.GsonBuilder这两个门面类，这两个类都提供了构造，序列化和反序列化等解析器所需要的几乎所有功能。

Gson和GsonBuilder他们的具体区别如下：

    -  通过Gson()构造的解析器，调用 toJson()方法生成的json字符串中删除了所有不必要的空白。可以通过设置GsonBuilder.setPrettyPrinting().来改变这规则。

    -  生成的JSON省略了所有为空的字段。注意在数组作为null，因为数组是有序列表。但是,如果一个字段没有空,但其生成JSON为空,这个字段是保留的。可以通过设置GsonBuilder.serializeNulls().来使  Gson系列化空的字段。

    -  Gson 提供了默认的序列化和反序列化的基本类型，如Enums, Map, URL, URI, Locale, Date, BigDecimal,  BigInteger classes等，这些基本上和Java中的类型是一样的，如果想改变默认的表现形式，可以通过注册adapterType，设置GsonBuilder.registerTypeAdapter(Type, Object).来完成。

    - Gson 中默认的 Date 的表现格式和Java中是一样的如DateFormat.DEFAULT.这种格式序列化期间忽略了日期的毫秒部分。可以通过GsonBuilder.setDateFormat(int) or GsonBuilder.setDateFormat(String).来改变。

    - Gson 中默认是忽略@Expose  @ Since 的注解的，可以通过设置GsonBuilder.excludeFieldsWithoutExposeAnnotation().和GsonBuilder.setVersion(double).改变序列化和反序列化规则。

    -  默认的字段命名策略为：输出Json和Java中的对象是一样。可以通过设置 GsonBuilder.setFieldNamingPolicy(FieldNamingPolicy).来自定义这个规则。

    -  默认的情况下，Gson将擦除所有标记为瞬态或静态的字段。可以通过GsonBuilder.excludeFieldsWithModifiers(int...).来配置擦除所有类中指定的修饰符的字段。

2.2  Gson 的解析过程：

       Gson解析中序列化比较简单。这里主要说下反序列化，主要涉及到Java中的 泛型和类型的获取。

       Java泛型的实现机制，使用了泛型的代码在运行期间相关的泛型参数的类型会被擦除，我们无法在运行期间获知泛型参数的具体类型（所有的泛型类型在运行时都是Object类型）。但是编译java源代码生成的Class文件中还是保存了泛型相关的信息，这些信息被保存在class字节码常量池中，使用了泛型的代码处会生成一个signature签名字段，该签名signature字段指明了这个常量池的地址，于是可从该常量池中获取到具体的类型。比如 Class类的getGenericSuperClass()方法， 对于带有泛型的class，返回一个ParameterizedType对象，对于Object、接口和原始类型返回null，对于数组class则是返回Object.class。ParameterizedType是表示带有泛型参数的类型的Java类型，JDK1.5引入了泛型之后，Java中所有的Class都实现了Type接口，ParameterizedType则是继承了Type接口，所有包含泛型的Class类都会实现这个接口。  

        对于简单的类对象，可以通过 传递一个Clazz进去，然后通过反射的方法来获得实际对象 如  (T)clazz.newInstance()，Gson中提供的方法也是如此：

public  T fromJson(String json, Class classOfT) throws JsonSyntaxException {
  Object object = fromJson(json, (Type) classOfT);
  return Primitives.wrap(classOfT).cast(object);
}

       对于复杂的集合类型中使用了泛型来限制如 List