002_Gson类

1. Gson是Google Gson库的主要类。它提供了将Java对象转换为匹配JSON结构的功能, 反之亦然。首先使用GsonBuilder构造Gson, 然后使用toJson(Object)或fromJson(String)方法来读/写JSON结构。

2. 类声明和无参构造函数

package com.google.gson;

public final class Gson {
	public Gson() { }
}

3. Gson类重要方法

3.1. T fromJson(JsonElement json, Class<T> classOfT)将指定的json解析树反序列化为指定类的对象。

3.2. T fromJson(JsonElement json, Type typeOfT)将指定的json解析树按指定类型的适配器将其反序列化为对象。

3.3. T fromJson(JsonReader reader, Type typeOfT)将指定的JsonReader按指定类型的适配器将其反序列化为对象。

3.4. T fromJson(Reader json, Class<T> classOfT)将指定的json读取器反序列化为指定类的对象。

3.5. T fromJson(Reader json, Type typeOfT)将指定的json读取器按指定类型的适配器将其反序列化为对象。

3.6. T fromJson(String json, Class<T> classOfT)将指定的json字符串反序列化为指定类的对象。

3.7. T fromJson(String json, Type typeOfT)将指定的json字符串按指定类型的适配器将其反序列化为对象。

3.8. String toJson(JsonElement jsonElement)将指定的json解析树序列化为JSON字符串。

3.9. void toJson(JsonElement jsonElement, Appendable writer)将指定的json解析树序列化为writer。

3.10. void toJson(JsonElement jsonElement, JsonWriter writer)将指定的json解析树序列化为writer。

3.11. String toJson(Object src)将指定的对象序列化为JSON字符串。

3.12. void toJson(Object src, Appendable writer)将指定的对象序列化为writer。

3.13. String toJson(Object src, Type typeOfSrc)将指定的对象按指定类型的适配器将其序列化为JSON字符串。

3.14. void toJson(Object src, Type typeOfSrc, Appendable writer)将指定的对象按指定类型的适配器将其序列化为writer。

3.15. void toJson(Object src, Type typeOfSrc, JsonWriter writer)将指定的对象按指定类型的适配器将其序列化为writer。

3.16. JsonElement toJsonTree(Object src)将指定的对象序列化为解析树。

3.17. JsonElement toJsonTree(Object src, Type typeOfSrc) 将指定的对象按指定类型的适配器将其序列化为解析树。

3.18. <T> TypeAdapter<T> getAdapter(Class<T> type)返回指定类的类型适配器。

3.19. <T> TypeAdapter<T> getAdapter(TypeToken<T> type)返回指定类型的类型适配器。

3.20. <T> TypeAdapter<T> getDelegateAdapter(TypeAdapterFactory skipPast, TypeToken<T> type)返回指定类型的备用类型适配器。