一、Gson的基本用法
Gson提供了fromJson() 和toJson() 兩個直接用於解析和生成的方法，前者實現反序列化，后者實現了序列化；同時每個方法都提供了重載方法
1、基本數據類型的解析
Gson gson = new Gson();
int i = gson.fromJson("100", int.class); //100
double d = gson.fromJson("\"99.99\"", double.class); //99.99
boolean b = gson.fromJson("true", boolean.class); // true
String str = gson.fromJson("String", String.class); // String
2、基本數據類型的生成
Gson gson = new Gson();
String jsonNumber = gson.toJson(100); // 100
String jsonBoolean = gson.toJson(false); // false
String jsonString = gson.toJson("String"); //"String"
3、POJO類的生成與解析
public class User {
//省略其它
public String name;
public int age;
public String emailAddress;
}
生成JSON：
Gson gson = new Gson();
User user = new User("張三",24);
String jsonObject = gson.toJson(user); // {"name":"張三kidou","age":24}
解析JSON：
Gson gson = new Gson();
String jsonString = "{\"name\":\"張三\",\"age\":24}";
User user = gson.fromJson(jsonString, User.class);
二、屬性重命名 @SerializedName 注解的使用
從上面POJO的生成與解析可以看出json的字段和值是的名稱和類型是一一對應的，但也有一定容錯機制(如第一個例子第3行將字符串的99.99
轉成double型)，但有時候也會出現一些不和諧的情況，如：
期望的json格式：{"name":"張三","age":24,"emailAddress":"zhangsan@ceshi.com"}
實際：{"name":"張三","age":24,"email_address":"zhangsan@ceshi.com"}
Gson在序列化和反序列化時需要使用反射，一般各類庫都將注解放到annotations包下，打開源碼在com.google.gson包下有一個
annotations，里面有一個SerializedName的注解類。對於json中email_address這個屬性對應POJO的屬性則變成：
@SerializedName("email_address")
public String emailAddress;
為POJO字段提供備選屬性名：SerializedName注解提供了兩個屬性，上面用到了其中一個，別外還有一個屬性alternate，接收一個String數組
注：alternate需要2.4版本
@SerializedName(value = "emailAddress", alternate = {"email", "email_address"})
public String emailAddress;
//當三個屬性(email_address、email、emailAddress)都中出現任意一個時均可以得到正確的結果
//當多種情況同時出時，以最后一個出現的值為准。
Gson gson = new Gson();
String json = "{\"name\":\"張三kidou\",\"age\":24,\"emailAddress\":\"zhangsan@ceshi.com\",\"email\":\"zhangsan_2@ceshi.com\",\"email_address\":\"zhangsan_3@ceshi.com\"}";
User user = gson.fromJson(json, User.class);
System.out.println(user.emailAddress); // zhangsan_3@example.com
三、Gson中使用泛型
例如：JSON字符串數組：["Android","Java","PHP"]
當要通過Gson解析這個json時，一般有兩種方式：使用數組，使用List；而List對於增刪都是比較方便的，所以實際使用是還是List比較多
數組比較簡單：
Gson gson = new Gson();
String jsonArray = "[\"Android\",\"Java\",\"PHP\"]";
String[] strings = gson.fromJson(jsonArray, String[].class);
對於List將上面的代碼中的 String[].class 直接改為 List<String>.class 是不行的，對於Java來說List<String> 和List<User> 這
倆個的字節碼文件只一個那就是List.class，這是Java泛型使用時要注意的問題 泛型擦除
為了解決的上面的問題，Gson提供了TypeToken來實現對泛型的支持，所以將以上的數據解析為List<String>時需要這樣寫
Gson gson = new Gson();
String jsonArray = "[\"Android\",\"Java\",\"PHP\"]";
String[] strings = gson.fromJson(jsonArray, String[].class);
List<String> stringList = gson.fromJson(jsonArray, new TypeToken<List<String>>() {}.getType());
//TypeToken的構造方法是protected修飾的,所以上面才會寫成new TypeToken<List<String>>() {}.getType() 而不是 new
TypeToken<List<String>>().getType()
泛型解析對接口POJO的設計影響，泛型的引入可以減少無關的代碼：
{"code":"0","message":"success","data":{}}
{"code":"0","message":"success","data":[]}
我們真正需要的data所包含的數據，而code只使用一次，message則幾乎不用，如果Gson不支持泛型或不知道Gson支持泛型的同學一定會這么定義POJO
public class UserResponse {
public int code;
public String message;
public User data;
}
當其它接口的時候又重新定義一個XXResponse將data的類型改成XX，很明顯code，和message被重復定義了多次，通過泛型可以將code和message字段抽取到一個Result的類中，這樣只需要編寫data字段所對應的POJO即可：
public class Result<T> {
public int code;
public String message;
public T data;
}
//對於data字段是User時則可以寫為 Result<User> ,當是個列表的時候為 Result<List<User>>
四、Gson的流式反序列化
1、自動方式
Gson提供了fromJson()和toJson() 兩個直接用於解析和生成的方法，前者實現反序列化，后者實現了序列化。同時每個方法都提供了重載方法
Gson.toJson(Object);
Gson.fromJson(Reader,Class);
Gson.fromJson(String,Class);
Gson.fromJson(Reader,Type);
Gson.fromJson(String,Type);
2、手動方式：手動的方式就是使用stream包下的JsonReader類來手動實現反序列化，和Android中使用pull解析XML是比較類似的
String json = "{\"name\":\"張三\",\"age\":\"24\"}";
User user = new User();
JsonReader reader = new JsonReader(new StringReader(json));
reader.beginObject();
while (reader.hasNext()) {
String s = reader.nextName();
switch (s) {
case "name":
user.name = reader.nextString();
break;
case "age":
user.age = reader.nextInt(); //自動轉換
break;
case "email":
user.email = reader.nextString();
break;
}
}
reader.endObject(); // throws IOException
System.out.println(user.name); //張三
System.out.println(user.age); // 24
System.out.println(user.email); //zhangsan@ceshi.com
自動方式最終都是通過JsonReader來實現的，如果第一個參數是String類型，那么Gson會創建一個StringReader轉換成流操作
五、Gson的流式序列化
1、自動方式
Gson.toJson方法列表
//PrintStream(System.out) 、StringBuilder、StringBuffer和*Writer都實現了Appendable接口。
Gson gson = new Gson();
User user = new User("張三",24,"zhangsan@qq.com");
gson.toJson(user,System.out);
2、手動方式
JsonWriter writer = new JsonWriter(new OutputStreamWriter(System.out));
writer.beginObject() // throws IOException
.name("name").value("張三")
.name("age").value(24)
.name("email").nullValue() //演示null
.endObject(); // throws IOException
writer.flush(); // throws IOException
//{"name":"張三","age":24,"email":null}
//除了beginObject、endObject還有beginArray和endArray，兩者可以相互嵌套，注意配對即可。beginArray后不可以調用name方法，同樣
beginObject后在調用value之前必須要調用name方法。
六、 使用GsonBuilder導出null值、格式化輸出、日期時間
一般情況下Gson類提供的 API已經能滿足大部分的使用場景，但有時需要更多特殊、強大的功能時，這時候就引入一個新的類 GsonBuilder。
GsonBuilder從名上也能知道是用於構建Gson實例的一個類，要想改變Gson默認的設置必須使用該類配置Gson
GsonBuilder用法：
//各種配置 //生成配置好的Gson
Gson gson = new GsonBuilder().create();
1、Gson在默認情況下是不能導出值null的鍵的，如：
public class User {
public String name;
public int age;
public String email;
//省略
}
Gson gson = new Gson();
User user = new User(張三",24);
System.out.println(gson.toJson(user)); //{"name":"張三","age":24}
//email字段是沒有在json中出現的，當在調試時需要導出完整的json串時或API接中要求沒有值必須用Null時，就會比較有用。
使用方法：
Gson gson = new GsonBuilder().serializeNulls() .create();
User user = new User("張三", 24);
System.out.println(gson.toJson(user)); //{"name":"張三","age":24,"email":null}
2、格式化輸出、日期時間及其它：
Gson gson = new GsonBuilder()
//序列化null
.serializeNulls()
// 設置日期時間格式，另有2個重載方法
// 在序列化和反序化時均生效
.setDateFormat("yyyy-MM-dd")
// 禁此序列化內部類
.disableInnerClassSerialization()
//生成不可執行的Json（多了 )]}' 這4個字符）
.generateNonExecutableJson()
//禁止轉義html標簽
.disableHtmlEscaping()
//格式化輸出
.setPrettyPrinting()
.create();