Gson 源码分析

 最近研究了google开源的Json库Gson，在这里进行总结一下，应该会分为3篇博客。第一篇主要讲一下Gson的整个框架吧；第二篇主要总结一下Gson关于反射的部分;最后一篇会总结一下JsonWriter和JsonReader，主要是Json对象的处理啦。

Gson

 Gson是可以转换Java对象为JSON表示的java库，也可以将JSON转换为Java对象，并且可以转换你没有源代码的预设的复杂对象
 现在有一些JSON转换库，但是大多数都需要你在class中设置annotation；如果没有class的源代码你就无法实现转换，而且大多数无法支持全部的Java范型。Gson把实现上述作为设计的主要目标。
 Gson的目标

• 提供简单的toJson(),和fromJson来实现Java对象和JSON数据的相互转换
• 运行预先存在的无法修改的对象与Json的转换
• 支持Java范型
• 运行用户自定义对象的结构
• 支持复杂对象的处理

框架描述

 这是Gson库的类图，没有将所有类都表现上去，只是画了几个比较主要的类和我研究过的类。这篇文章就主要梳理一下这个框架，研究一下几个比较主要的函数的流程和各个对象的协作。

1.GsonBuilder

 GsonBuilder是Gson对象的Builder类啦，我们可以先看一下Gson对象的构造函数的复杂度啦,所以如果希望配置Gson,就只有使用Builder模式啦，这也是Java设计模式中所推荐的

Gson(final Excluder excluder, final FieldNamingStrategy fieldNamingPolicy,
      final Map> instanceCreators, boolean serializeNulls,
      boolean complexMapKeySerialization, boolean generateNonExecutableGson, boolean htmlSafe,
      boolean prettyPrinting, boolean serializeSpecialFloatingPointValues,
      LongSerializationPolicy longSerializationPolicy,
      List typeAdapterFactories)

  GsonBuilder文件中的注释也有说明：

使用这个对象去配置你的Gson对象，当你希望修改默认配置时

 我们现在可以依次介绍一下GsonBuilder的成员变量或者说是其所依赖的类型吧。

• Exculder 是用来配置一些你不希望被转换成JSON格式的对象的成员变量的，比如你只希望自己的对象中所有public的成员变量被转换为JSON格式，那么就需要使用到这个对象，添加规则去除去所有非pulbic的成员变量。

• LongSerializationPolicy

• FieldNamingStragety

• InstanceCreator

• TypeAdapterFactory

2.Gson

 Gson对象就是我们最常使用的对象啦，它有一系列的fromJson,toJson的成员函数供我们调用，这篇文章的一个重点就是梳理同这两类函数的逻辑。
 我们先来看一下Gson的构造函数吧。构造函数名和参数列表在前边已经列出来啦，构造函数中就是将参数列表中的对象配置为成员变量，不过要注意的是对TypeAdapterFactory的操作啦。

	....
    List factories = new ArrayList();

    // built-in type adapters that cannot be overridden
    factories.add(TypeAdapters.JSON_ELEMENT_FACTORY);
    factories.add(ObjectTypeAdapter.FACTORY);
    ..... //还有很多基本的TypeAdapterFactory
    // the excluder must precede all adapters that handle user-defined types
    factories.add(excluder);

    // user's type adapters
    factories.addAll(typeAdapterFactories);

    // type adapters for basic platform types
    factories.add(TypeAdapters.STRING_FACTORY); //里边是一些基本类型的adapter啦
       ......
    this.factories = Collections.unmodifiableList(factories);

 Gson内置了很多基本类型和对象的转换组件，类型为TypeAdapter,可以通过相应的TypeAdapterFactory来获得，所以这里factories就预先加载了很多基本类型转换组件的Factory,然后factories.addAll(typeAdapterFactories)是添加构造函数中传入的用户自定义的TypeAdapterFactory
 fromJson和toJson这两类函数我们在介绍完所有的类之后在解析吧。

3.TypeAdapter

 这是一个抽象类，提供了两个抽象函数作为hook函数来让用户重载，分别是public abstract void write(JsonWriter out, T value) throws IOException;和public abstract T read(JsonReader in) throws IOException;一读一写，用户如果要解析自己自定义的对象，就可以继承这个类，然后实现上述两个方法，并在GsonBuilder中使用GsonBuilder registerTypeAdapter(Type type, Object typeAdapter) 来注册这个转换类，然后Gson就可以对你的自定义对象进行转换啦。需要注意的是，这里的转换完全由你自己控制，所以可定制性比较强。在介绍TypeAdapters`时，我们会介绍几个简单的TypeAdapter的实现。

4.TypeAdapterFactory

 这是一个接口，自定义了一个函数: TypeAdapter create(Gson gson, TypeToken type);,具体的实现方法，我们可以在后边的TypeAdapters类中看到.

5.TypeAdapters

 这个类中定义了几乎所有的基础类型的TypeAdapter和Factory,我们现在挑出一个来研究一下。这是一个URL对象的JSON转换器啦。

public static final TypeAdapter URL = new TypeAdapter() {
    @Override
    public URL read(JsonReader in) throws IOException {
      if (in.peek() == JsonToken.NULL) {
        in.nextNull();
        return null;
      }
      String nextString = in.nextString(); //读出in中的内容
      return "null".equals(nextString) ? null : new URL(nextString);//根据读出的内容，创建URL对象
    }
    @Override
    public void write(JsonWriter out, URL value) throws IOException {
      out.value(value == null ? null : value.toExternalForm()); //写入内容
    }
  };

  public static final TypeAdapterFactory URL_FACTORY = newFactory(URL.class, URL);//创建Facotry啦

  我们可以看到，这是一个URL的转换器，JsonReader和JsonWriter后边会介绍到，现在你就可以把他们当做类似于StringBuilder一类的Json的生成器和解释器。

6.TypeToken

 TypeToken可以看做是对Java范型的扩展，大家都知道Java范型是有类型擦除效果的，无法获得其真实类型。而这个类就是为了处理这种情况的，我们从文件中的注释也可以了解到。具体的内容，我们希望在Gson相关的第二篇博文中再详细说明，主要就是涉及围绕TypeToken的一系列的Gson对范型的支持和处理。
 而在Gson对象中，TypeToken主要是用于根据Type来获得相应的TypeAdapter。

其他类

 还有很多其他的类没有介绍，其中有些不太重要，我也没有太多了解，另外一些我会在接下去的两篇博文中详细介绍。

转换流程

 接下来，我们就主要理通Gson两个最重要的函数的逻辑，之后的两篇博文会详细介绍其中的重要的细节，这篇博文就只诉说每一步大致的作用啦。

1 fromJson()

 函数名为fromJson的函数比较多，我们只看下边这个

 @SuppressWarnings("unchecked")
  public  T fromJson(JsonReader reader, Type typeOfT) throws JsonIOException, JsonSyntaxException {
    boolean isEmpty = true;
    boolean oldLenient = reader.isLenient();
    reader.setLenient(true);
    try {
      reader.peek();
      isEmpty = false;
      // 反射部分的精髓,主要的就是TypeToken和TypeAdapter啦
      TypeToken typeToken = (TypeToken) TypeToken.get(typeOfT);  //1:工厂方法,其中调用typeToken的构造器
      TypeAdapter typeAdapter = getAdapter(typeToken); //2:通过type来获得Adapter啊
      T object = typeAdapter.read(reader);//3:通过typeAdapter来转换对象
      return object;
    } catch (EOFException e) {
      /*
       * For compatibility with JSON 1.5 and earlier, we return null for empty
       * documents instead of throwing.
       */
      if (isEmpty) {
        return null;
      }
      throw new JsonSyntaxException(e);
    } catch (IllegalStateException e) {
      throw new JsonSyntaxException(e);
    } catch (IOException e) {
      // TODO(inder): Figure out whether it is indeed right to rethrow this as JsonSyntaxException
      throw new JsonSyntaxException(e);
    } finally {
      reader.setLenient(oldLenient);
    }
  }

 如同代码中标注的一样，fromJson中大致分为3个比较重要的步奏.

• TypeToken typeToken = (TypeToken) TypeToken.get(typeOfT); 获得要转换类型对应的TypeToken对象，主要涉及的Gson中范型和反射的部分逻辑，我们第二篇博文再讲

• TypeAdapter typeAdapter = getAdapter(typeToken); //通过type来获得Adapter啊,这个我们先来看一下getAdapter函数,就是找出TypeToken所对应的TypeAdapter对象，用于下一步的解析。

@SuppressWarnings("unchecked")
  public  TypeAdapter getAdapter(TypeToken type) {
    TypeAdapter cached = typeTokenCache.get(type);  // typeTokenCache?? 创造adapter是很麻烦的事情吗？有cache
    if (cached != null) {
      return (TypeAdapter) cached;

    }

    Map, FutureTypeAdapter> threadCalls = calls.get();  //threadLocal get
    boolean requiresThreadLocalCleanup = false; //是否需要清理threadLocal中的数据
    if (threadCalls == null) {
      threadCalls = new HashMap, FutureTypeAdapter>();
      calls.set(threadCalls);
      requiresThreadLocalCleanup = true;
    }

    // the key and value type parameters always agree
    FutureTypeAdapter ongoingCall = (FutureTypeAdapter) threadCalls.get(type);
    if (ongoingCall != null) {
      return ongoingCall;
    }

    try {
      FutureTypeAdapter call = new FutureTypeAdapter();
      threadCalls.put(type, call);

      for (TypeAdapterFactory factory : factories) {
        TypeAdapter candidate = factory.create(this, type);  // 通过factory 来创建TypeAdapter啊，由于需要遍历list比较麻烦
        if (candidate != null) {
          call.setDelegate(candidate);
          typeTokenCache.put(type, candidate);
          return candidate;
        }
      }
     ....
    } finally {
      threadCalls.remove(type);
	  ....
    }
  }

• T object = typeAdapter.read(reader);//3:通过typeAdapter来转换对象,具体过程，和JsonReader，JsonWriter的原理，第三篇博文再进行讲述

2 toJson

 其实toJson和fromJson很像，就是获得相应的TypeAdapter,只不过这次调用的是write方法。这里就不累赘多说啦。

总结

 博客还未写完，代码还没有看透…