Gson 解析教程

Gson 是google解析Json的一个开源框架,同类的框架fastJson,JackJson等等

本人fastJson用了两年，也是从去年才开始接触Gson,希望下面的总结会对博友有用,至于Gson与FastJson的对比,其实半斤八两的问题,不再赘述

第一步:在AS下面创建java工程 并添加gson依赖

compile 'com.google.code.gson:gson:2.6.2'

Gson的实例化方式:

1:Gson gson=newGson();

2:通过GsonBuilder 可以配置多种选项

[java]  view plain  copy

1. gson = new GsonBuilder()  
2.                    .setLenient()// json宽松  
3.                    .enableComplexMapKeySerialization()//支持Map的key为复杂对象的形式  
4.                    .serializeNulls() //智能null  
5.                    .setPrettyPrinting()// 调教格式  
6.                    .disableHtmlEscaping() //默认是GSON把HTML 转义的  
7.                    .create();  

Gson的基本用法:

 JavaBean转换Json字符串

 gson提供 publicString toJson(Object src) 方法可以将对象转换成jsonStr

  

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4.   
5. /** 
6.  * @author xuanyouwu 
7.  * @email [email protected] 
8.  * @time 2016-05-18 10:39 
9.  */  
10. public class GsonTest1 {  
11.     public static class Student {  
12.         private String name;  
13.         private int age;  
14.   
15.         //省略setter getter equals  
16.     }  
17.   
18.     private static void log(String msg) {  
19.         System.out.println(msg);  
20.     }  
21.   
22.   
23.     public static void main(String[] args) throws Exception {  
24.         Gson gson = new Gson();  
25.         Student student = new Student();  
26.         student.setName("xuanyouwu");  
27.         student.setAge(26);  
28.         String jsonStr = gson.toJson(student);  
29.         log("---->javabean convert jsonStr:" + jsonStr);  
30.     }  
31.   
32. }  

运行结果:

---->javabean convert jsonStr:{"name":"xuanyouwu","age":26}

    List Map转Json字符串

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4.   
5. import java.util.Arrays;  
6. import java.util.HashMap;  
7. import java.util.List;  
8. import java.util.Map;  
9.   
10. /** 
11.  * @author xuanyouwu 
12.  * @email [email protected] 
13.  * @time 2016-05-18 10:39 
14.  */  
15. public class GsonTest1 {  
16.   
17.     private static void log(String msg) {  
18.         System.out.println(msg);  
19.     }  
20.   
21.   
22.     public static void main(String[] args) throws Exception {  
23.         Gson gson = new Gson();  
24.   
25.         List<String> list = Arrays.asList("1", "a", "3", "rt", "5");  
26.         log("---->list convert jsonStr:" + gson.toJson(list));  
27.   
28.         Map<String, Object> content = new HashMap<String, Object>();  
29.         content.put("name", "xuanyouwu");  
30.         content.put("age", "26");  
31.         log("---->map convert jsonStr:" + gson.toJson(content));  
32.     }  
33.   
34. }  

[java]  view plain  copy

1. 运行结果:  

[java]  view plain  copy

1. ---->list convert jsonStr:["1","a","3","rt","5"]  
2. ---->map convert jsonStr:{"name":"xuanyouwu","age":"26"}  

       Json字符串转JavaBean

[java]  view plain  copy

1. String studentJsonStr="{\"name\":\"xuanyouwu\",\"age\":26}";  
2.   
3. Student student1 = gson.fromJson(studentJsonStr, Student.class);  
4. log("------->json convert JavaBean:"+student1);  

      运行结果:

            ------->json convert JavaBean:Student{name='xuanyouwu', age=26}

   Json字符串转List

[java]  view plain  copy

1. String listJsonStr="[\"1\",\"a\",\"3\",\"rt\",\"5\"]";  

[java]  view plain  copy

1. Type type = new TypeToken<ArrayList<String>>() {  
2. }.getType();  
3. ArrayList<String> sList=gson.fromJson(listJsonStr, type);  
4. log("------->json convert List:"+sList);  

[java]  view plain  copy

1. 运行结果:  

[java]  view plain  copy

1. ------->json convert List:[1, a, 3, rt, 5]  

[java]  view plain  copy

1. </pre><pre code_snippet_id="1687762" snippet_file_name="blog_20160518_11_939636" name="code" class="java">  Gson封装的类型体系  

[java]  view plain  copy

1.    Gson里面有一个非常有意思的抽象基类JsonElement,他的继承体系:  

[java]  view plain  copy

1. <img src="https://img-blog.csdn.net/20160518135136864?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center" alt="" />  

[java]  view plain  copy

1.  JsonObject等同于org的JSONObject,JsonArray也类似,  

[java]  view plain  copy

1. JsonNull 其实就是null 字段  

[java]  view plain  copy

1. JsonNull jsonNull=new JsonNull();//构造方法过时，推荐INSTANCE  

[java]  view plain  copy

1. JsonNull jsonNull=JsonNull.INSTANCE;  
2.   log("-----"+jsonNull);  

[java]  view plain  copy

1. 运行结果:  

[java]  view plain  copy

1. -----null  

     JsonPrimitive非常有意思,我们知道如果json转换成字符串 可能包含引号的转义，但是通过JsonPrimative我们可以获得为转义的字符串，看实例：

     

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.JsonNull;  
4. import com.google.gson.JsonPrimitive;  
5.   
6. /** 
7.  * @author xuanyouwu 
8.  * @email [email protected] 
9.  * @time 2016-05-18 11:20 
10.  */  
11. public class GsonTest2 {  
12.     private static void log(String msg) {  
13.         System.out.println(msg);  
14.     }  
15.     public static void main(String[] args) throws Exception {  
16.         String studentJsonStr="{\"name\":\"xuanyouwu\",\"age\":26}";  
17.         log("------>studentJsonStr:"+studentJsonStr);  
18.         JsonPrimitive jsonPrimitive=new JsonPrimitive(studentJsonStr);  
19.         log("------>jsonPrimitive:"+jsonPrimitive);  
20.         log("------>jsonPrimitive:"+jsonPrimitive.toString());  
21.         log("------>jsonPrimitive:"+jsonPrimitive.getAsString());  
22.   
23.         JsonPrimitive jsonPrimitive2=new JsonPrimitive("this is String");  
24.         log("------>jsonPrimitive2:"+jsonPrimitive2);  
25.         log("------>jsonPrimitive2:"+jsonPrimitive2.toString());  
26.         log("------>jsonPrimitive2:"+jsonPrimitive2.getAsString());  
27.     }  
28. }  

     运行结果:

------>studentJsonStr:{"name":"xuanyouwu","age":26}
------>jsonPrimitive:"{\"name\":\"xuanyouwu\",\"age\":26}"
------>jsonPrimitive:"{\"name\":\"xuanyouwu\",\"age\":26}"
------>jsonPrimitive:{"name":"xuanyouwu","age":26}
------>jsonPrimitive2:"this is String"
------>jsonPrimitive2:"this is String"
------>jsonPrimitive2:this is String

       创建JsonObject

           通过addPropert(key,value)可以向jsonObject中添加字段 跟hashMap类似

[java]  view plain  copy

1. JsonObject jsonObject=new JsonObject();  
2. jsonObject.addProperty("name","xuanyouwu");  
3. jsonObject.addProperty("age",26);  
4. log("------>create jsonObject:"+jsonObject);  

            运行结果:

                ------>create jsonObject:{"name":"xuanyouwu","age":26}

    创建JsonArray       

[java]  view plain  copy

1. JsonArray jsonElements=new JsonArray();  
2.    jsonElements.add("a");  
3.    jsonElements.add("b");  
4.    jsonElements.add("c");  
5.    jsonElements.add("d");  
6.    log("------>create jsonArray:"+jsonElements);  

          运行结果:

          ------>create jsonArray:["a","b","c","d"]

     JsonObject 嵌套数组或者说嵌套JsonArray

           通过JsonObject的add(key,JsonElement)可以为jsonObject 添加一个数组的字段

[java]  view plain  copy

1. JsonObject jsonObject2=new JsonObject();  
2. jsonObject2.addProperty("name","xuanyouwu");  
3. jsonObject2.addProperty("age",26);  
4. JsonArray jsonElements2=new JsonArray();  
5. jsonElements2.add("骑车");  
6. jsonElements2.add("打游戏");  
7. jsonElements2.add("看电视");  
8. jsonObject2.add("hobby",jsonElements2);  
9. log("------>create jsonObject inner JsonArray:"+jsonObject2);  

           运行结果:

            ------>create jsonObject inner JsonArray:{"name":"xuanyouwu","age":26,"hobby":["骑车","打游戏","看电视"]}

Gson注解

          在Gson中有五类注解

          

          重命名注解:SerializedName 

             作用:转换关键字key,json转换成JavaBean时,json字段的key 默认必须和我们声明类的字段名称一样,当服务器端返回了关键字怎么办，比如key 为new switch这样,我们    在声明类的时候不能写这样的字段,可能你想服务器端改动，他可能要改数据库，但是我告诉你，做服务端的大部分不愿意改动他的json,是很自私的!这时候重命名注解都排上用场了   第二种场景:服务器端返回的json 的key 简直太丑，或者太长,你想简化,my_parent_name,可以简化成mpn 比较优雅简介

          实例:

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.annotations.SerializedName;  
5.   
6. /** 
7.  * @author xuanyouwu 
8.  * @email [email protected] 
9.  * @time 2016-05-18 11:20 
10.  */  
11. public class GsonTest3 {  
12.     private static void log(String msg) {  
13.         System.out.println(msg);  
14.     }  
15.   
16.     public static class User {  
17.         public String name;  
18.         public int age;  
19.         @SerializedName("new")  
20.         public int isnew;  
21.   
22.         @Override  
23.         public String toString() {  
24.             return "User{" +  
25.                     "name='" + name + '\'' +  
26.                     ", age=" + age +  
27.                     ", isnew=" + isnew +  
28.                     '}';  
29.         }  
30.     }  
31.   
32.     public static void main(String[] args) throws Exception {  
33.   
34.         String jsonFromServer = "{\n" +  
35.                 "    \"age\": 26,\n" +  
36.                 "    \"name\": \"zhangsan\",\n" +  
37.                 "    \"new\": 1\n" +  
38.                 "}";  
39.         Gson gson = new Gson();  
40.         User user = gson.fromJson(jsonFromServer, User.class);  
41.         log("------>user:" + user);  
42.     }  
43. }  

运行结果: ------>user:User{name='zhangsan', age=26, isnew=1}

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.annotations.SerializedName;  
5.   
6. /** 
7.  * @author xuanyouwu 
8.  * @email [email protected] 
9.  * @time 2016-05-18 11:20 
10.  */  
11. public class GsonTest3 {  
12.     private static void log(String msg) {  
13.         System.out.println(msg);  
14.     }  
15.   
16.     public static class User2 {  
17.         public String name;  
18.         public int age;  
19.         @SerializedName("my_parent_name")  
20.         public String pn;  
21.   
22.         @Override  
23.         public String toString() {  
24.             return "User2{" +  
25.                     "name='" + name + '\'' +  
26.                     ", age=" + age +  
27.                     ", pn='" + pn + '\'' +  
28.                     '}';  
29.         }  
30.     }  
31.   
32.     public static void main(String[] args) throws Exception {  
33.         String jsonFromServer2="{\n" +  
34.                 "    \"age\": 26,\n" +  
35.                 "    \"my_parent_name\": \"zhangsanf\",\n" +  
36.                 "    \"name\": \"zhangsan\"\n" +  
37.                 "}";  
38.         Gson gson2 = new Gson();  
39.         User2 user2 = gson2.fromJson(jsonFromServer2, User2.class);  
40.         log("------>user2:" + user2);  
41.     }  
42. }  

运行结果: ------>user2:User2{name='zhangsan', age=26, pn='zhangsanf'}

        作用2:结合alternate 提供多种备用字段key来解析,@SerializedName(value ="desc",alternate = {"other","note"})  如果json中有other就会解析成desc 如果有note也会解析成desc,注意1:value中的值不能出现在alternate中,注意2:alternate的备选字段 会后面的替换前面的

   实例：

   

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.annotations.SerializedName;  
5.   
6. /** 
7.  * @author xuanyouwu 
8.  * @email [email protected] 
9.  * @time 2016-05-18 11:20 
10.  */  
11. public class GsonTest4 {  
12.     private static void log(String msg) {  
13.         System.out.println(msg);  
14.     }  
15.   
16.     public static class User {  
17.         public String name;  
18.         public int age;  
19.         @SerializedName(value = "desc",alternate = {"other","note"})  
20.         public String desc;  
21.   
22.         @Override  
23.         public String toString() {  
24.             return "User{" +  
25.                     "name='" + name + '\'' +  
26.                     ", age=" + age +  
27.                     ", desc='" + desc + '\'' +  
28.                     '}';  
29.         }  
30.     }  
31.   
32.     public static void main(String[] args) throws Exception {  
33.         String jsonFromServer = "{\n" +  
34.                 "    \"age\": 26,\n" +  
35.                 "    \"other\": \"成都人\",\n" +  
36.                 "    \"name\": \"zhangsan\"\n" +  
37.                 "}";  
38.         Gson gson = new Gson();  
39.         User user = gson.fromJson(jsonFromServer, User.class);  
40.         log("------>user:" + user);  
41.   
42.   
43.         String jsonFromServer2 = "{\n" +  
44.                 "    \"age\": 26,\n" +  
45.                 "    \"note\": \"成都人\",\n" +  
46.                 "    \"name\": \"zhangsan\"\n" +  
47.                 "}";  
48.         User user2 = gson.fromJson(jsonFromServer2, User.class);  
49.         log("------>user:" + user2);  
50.   
51.         //包括desc 与note note在desc之后  
52.         String jsonFromServer3="{\n" +  
53.                 "    \"age\": 26,\n" +  
54.                 "    \"desc\": \"desc成都人\",\n" +  
55.                 "    \"name\": \"zhangsan\",\n" +  
56.                 "    \"note\": \"note成都人\"\n" +  
57.                 "}";  
58.         User user3 = gson.fromJson(jsonFromServer3, User.class);  
59.         log("------>user:" + user3);  
60.   
61.         //包括desc 与note note在desc之前  
62.         String jsonFromServer4="{\n" +  
63.                 "    \"age\": 26,\n" +  
64.                 "    \"note\": \"note成都人\",\n" +  
65.                 "    \"name\": \"zhangsan\",\n" +  
66.                 "    \"desc\": \"desc成都人\"\n" +  
67.                 "}";  
68.         User user4 = gson.fromJson(jsonFromServer4, User.class);  
69.         log("------>user:" + user4);  
70.     }  
71. }  

  运行结果:

     ------>user:User{name='zhangsan', age=26, desc='成都人'}
------>user:User{name='zhangsan', age=26, desc='成都人'}
------>user:User{name='zhangsan', age=26, desc='note成都人'}
------>user:User{name='zhangsan', age=26, desc='desc成都人'}

  Gson @Expose过滤注解 

  源码:默认既可以序列化又可以反序列化

[java]  view plain  copy

1. @Retention(RetentionPolicy.RUNTIME)  
2. @Target(ElementType.FIELD)  
3. public @interface Expose {  
4.     
5.   public boolean serialize() default true;  
6.   
7.   public boolean deserialize() default true;  
8. }  

[java]  view plain  copy

1. </pre><pre code_snippet_id="1687762" snippet_file_name="blog_20160518_25_4965554" name="code" class="java">可以排除不需要序列化的字段,需要配合GsonBuilder使用  

[java]  view plain  copy

1. <pre style="font-family: 宋体; font-size: 9pt; background-color: rgb(255, 255, 255);"><pre name="code" class="java"> Gson gson = new GsonBuilder()  
2.                 .excludeFieldsWithoutExposeAnnotation()  
3.                 .create();  

  不添加@Expose注解的字段将不会解析:

   分为以下几种情况:

    1:不添加@Expose注解等同于@Expose(deserialize = false,serialize = false) 不做任何解析

    2:@Expose(deserialize = true,serialize = false) 只解析用用，也就是反序列化可以，序列化不可以

    3:@Expose(deserialize = false,serialize = true) 序列化可以，反序列化不行

    4:@Expose(deserialize = true,serialize = true) 既可以序列化，也可以反序列化

    实例:将分别演示这四种情况

  不添加@Expose注解:等同于@Expose(deserialize = false,serialize = false)

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5.   
6. /** 
7.  * @author xuanyouwu 
8.  * @email [email protected] 
9.  * @time 2016-05-18 11:20 
10.  */  
11. public class GsonTest5 {  
12.     private static void log(String msg) {  
13.         System.out.println(msg);  
14.     }  
15.   
16.     public static class User {  
17.         public String name;  
18.   
19.         @Override  
20.         public String toString() {  
21.             return "User{" +  
22.                     "name='" + name + '\'' +  
23.                     '}';  
24.         }  
25.     }  
26.   
27.     public static void main(String[] args) throws Exception {  
28.         String jsonFromServer = "{\"name\": \"zhangsan\"}";  
29.         Gson gson = new GsonBuilder()  
30.                 .excludeFieldsWithoutExposeAnnotation()  
31.                 .create();  
32.         User user = gson.fromJson(jsonFromServer, User.class);  
33.         log("------>反序列化:" + user);  
34.   
35.         User user1 = new User();  
36.         user1.name = "zhangsan2";  
37.         String userStr = gson.toJson(user1);  
38.         log("------>序列化:" + userStr);  
39.     }  
40. }  

运行结果:

------>反序列化:User{name='null'}
------>序列化:{}

  添加@Expose注解 

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5. import com.google.gson.annotations.Expose;  
6.   
7. /** 
8.  * @author xuanyouwu 
9.  * @email [email protected] 
10.  * @time 2016-05-18 11:20 
11.  */  
12. public class GsonTest5 {  
13.     private static void log(String msg) {  
14.         System.out.println(msg);  
15.     }  
16.   
17.     public static class User {  
18.         @Expose //等同于 @Expose(deserialize = true,serialize = true)  
19.         public String name;  
20.   
21.         @Override  
22.         public String toString() {  
23.             return "User{" +  
24.                     "name='" + name + '\'' +  
25.                     '}';  
26.         }  
27.     }  
28.   
29.     public static void main(String[] args) throws Exception {  
30.         String jsonFromServer = "{\"name\": \"zhangsan\"}";  
31.         Gson gson = new GsonBuilder()  
32.                 .excludeFieldsWithoutExposeAnnotation()  
33.                 .create();  
34.         User user = gson.fromJson(jsonFromServer, User.class);  
35.         log("------>反序列化:" + user);  
36.   
37.         User user1 = new User();  
38.         user1.name = "zhangsan2";  
39.         String userStr = gson.toJson(user1);  
40.         log("------>序列化:" + userStr);  
41.     }  
42. }  

运行结果:

------>反序列化:User{name='zhangsan'}
------>序列化:{"name":"zhangsan2"}

@Expose注解 只序列化

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5. import com.google.gson.annotations.Expose;  
6.   
7. /** 
8.  * @author xuanyouwu 
9.  * @email [email protected] 
10.  * @time 2016-05-18 11:20 
11.  */  
12. public class GsonTest5 {  
13.     private static void log(String msg) {  
14.         System.out.println(msg);  
15.     }  
16.   
17.     public static class User {  
18.         @Expose(deserialize = false,serialize = true)  
19.         public String name;  
20.   
21.         @Override  
22.         public String toString() {  
23.             return "User{" +  
24.                     "name='" + name + '\'' +  
25.                     '}';  
26.         }  
27.     }  
28.   
29.     public static void main(String[] args) throws Exception {  
30.         String jsonFromServer = "{\"name\": \"zhangsan\"}";  
31.         Gson gson = new GsonBuilder()  
32.                 .excludeFieldsWithoutExposeAnnotation()  
33.                 .create();  
34.         User user = gson.fromJson(jsonFromServer, User.class);  
35.         log("------>反序列化:" + user);  
36.   
37.         User user1 = new User();  
38.         user1.name = "zhangsan2";  
39.         String userStr = gson.toJson(user1);  
40.         log("------>序列化:" + userStr);  
41.     }  
42. }  

运行结果:

------>反序列化:User{name='null'}------>序列化:{"name":"zhangsan2"}

      @Expose 只反序列化

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5. import com.google.gson.annotations.Expose;  
6.   
7. /** 
8.  * @author xuanyouwu 
9.  * @email [email protected] 
10.  * @time 2016-05-18 11:20 
11.  */  
12. public class GsonTest5 {  
13.     private static void log(String msg) {  
14.         System.out.println(msg);  
15.     }  
16.   
17.     public static class User {  
18.         @Expose(deserialize = true, serialize = false)  
19.         public String name;  
20.   
21.         @Override  
22.         public String toString() {  
23.             return "User{" +  
24.                     "name='" + name + '\'' +  
25.                     '}';  
26.         }  
27.     }  
28.   
29.     public static void main(String[] args) throws Exception {  
30.         String jsonFromServer = "{\"name\": \"zhangsan\"}";  
31.         Gson gson = new GsonBuilder()  
32.                 .excludeFieldsWithoutExposeAnnotation()  
33.                 .create();  
34.         User user = gson.fromJson(jsonFromServer, User.class);  
35.         log("------>反序列化:" + user);  
36.   
37.         User user1 = new User();  
38.         user1.name = "zhangsan2";  
39.         String userStr = gson.toJson(user1);  
40.         log("------>序列化:" + userStr);  
41.     }  
42. }  

运行结果:

 ------>反序列化:User{name='zhangsan'}
------>序列化:{}

    @Since(float v)注解  版本控制 

      结合GsonBuilder.setVersion(n)使用 当n>=v时 才会序列化解析

 

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5. import com.google.gson.annotations.Since;  
6.   
7. /** 
8.  * @author xuanyouwu 
9.  * @email [email protected] 
10.  * @time 2016-05-18 11:20 
11.  */  
12. public class GsonTest6 {  
13.     private static void log(String msg) {  
14.         System.out.println(msg);  
15.     }  
16.   
17.     public static class User {  
18.         @Since(2)  
19.         public String name;  
20.   
21.         @Override  
22.         public String toString() {  
23.             return "User{" +  
24.                     "name='" + name + '\'' +  
25.                     '}';  
26.         }  
27.     }  
28.   
29.     public static void main(String[] args) throws Exception {  
30.         String jsonFromServer = "{\"name\": \"zhangsan\"}";  
31.         Gson gson = new GsonBuilder()  
32.                 .setVersion(1)//版本为1  
33.                 .create();  
34.         User user1 = gson.fromJson(jsonFromServer, User.class);  
35.         log("------>反序列化v=1:" + user1);  
36.   
37.         User user1_1 = new User();  
38.         user1_1.name = "zhangsan2";  
39.         String userStr = gson.toJson(user1_1);  
40.         log("------>序列化v=1:" + userStr);  
41.   
42.   
43.         Gson gson2 = new GsonBuilder()  
44.                 .setVersion(2)//版本为2  
45.                 .create();  
46.         User user2 = gson2.fromJson(jsonFromServer, User.class);  
47.         log("------>反序列化v=2:" + user2);  
48.   
49.         User user2_1 = new User();  
50.         user2_1.name = "zhangsan2";  
51.         String userStr2_1 = gson2.toJson(user2_1);  
52.         log("------>序列化v=2:" + userStr2_1);  
53.   
54.         Gson gson3 = new GsonBuilder()  
55.                 .setVersion(3)//版本为3  
56.                 .create();  
57.         User user3 = gson3.fromJson(jsonFromServer, User.class);  
58.         log("------>反序列化v=3:" + user3);  
59.   
60.         User user3_1 = new User();  
61.         user3_1.name = "zhangsan2";  
62.         String userStr3_1 = gson3.toJson(user3_1);  
63.         log("------>序列化v=3:" + userStr3_1);  
64.     }  
65. }  

运行结果:

------>反序列化v=1:User{name='null'}
------>序列化v=1:{}
------>反序列化v=2:User{name='zhangsan'}
------>序列化v=2:{"name":"zhangsan2"}
------>反序列化v=3:User{name='zhangsan'}
------>序列化v=3:{"name":"zhangsan2"}

    @Util(float v)注解 版本控制

      当gson的setVersion(n) n<v 才解析

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5. import com.google.gson.annotations.Until;  
6.   
7. /** 
8.  * @author xuanyouwu 
9.  * @email [email protected] 
10.  * @time 2016-05-18 11:20 
11.  */  
12. public class GsonTest6 {  
13.     private static void log(String msg) {  
14.         System.out.println(msg);  
15.     }  
16.   
17.     public static class User {  
18.         @Until(2)  
19.         public String name;  
20.   
21.         @Override  
22.         public String toString() {  
23.             return "User{" +  
24.                     "name='" + name + '\'' +  
25.                     '}';  
26.         }  
27.     }  
28.   
29.     public static void main(String[] args) throws Exception {  
30.         String jsonFromServer = "{\"name\": \"zhangsan\"}";  
31.         Gson gson = new GsonBuilder()  
32.                 .setVersion(1)//版本为1  
33.                 .create();  
34.         User user1 = gson.fromJson(jsonFromServer, User.class);  
35.         log("------>反序列化v=1:" + user1);  
36.   
37.         User user1_1 = new User();  
38.         user1_1.name = "zhangsan2";  
39.         String userStr = gson.toJson(user1_1);  
40.         log("------>序列化v=1:" + userStr);  
41.   
42.   
43.         Gson gson2 = new GsonBuilder()  
44.                 .setVersion(2)//版本为2  
45.                 .create();  
46.         User user2 = gson2.fromJson(jsonFromServer, User.class);  
47.         log("------>反序列化v=2:" + user2);  
48.   
49.         User user2_1 = new User();  
50.         user2_1.name = "zhangsan2";  
51.         String userStr2_1 = gson2.toJson(user2_1);  
52.         log("------>序列化v=2:" + userStr2_1);  
53.   
54.         Gson gson3 = new GsonBuilder()  
55.                 .setVersion(3)//版本为3  
56.                 .create();  
57.         User user3 = gson3.fromJson(jsonFromServer, User.class);  
58.         log("------>反序列化v=3:" + user3);  
59.   
60.         User user3_1 = new User();  
61.         user3_1.name = "zhangsan2";  
62.         String userStr3_1 = gson3.toJson(user3_1);  
63.         log("------>序列化v=3:" + userStr3_1);  
64.     }  
65. }  

运行结果:

------>反序列化v=1:User{name='zhangsan'}
------>序列化v=1:{"name":"zhangsan2"}
------>反序列化v=2:User{name='null'}
------>序列化v=2:{}
------>反序列化v=3:User{name='null'}
------>序列化v=3:{}

Gson 高级用法

    相信看过retrofit2.0 源码的同学都知道,其中有一个GsonConverterFactory 里面的用法十分精炼老成,这里来一段源码

 

   据说使用TypeAdapter 效率更高,本人还未对比测试,暂时放后吧,TypeAdapter是什么玩意呢？

   在源码中备注了一句 Converts Java objects to and from JSON 就是对象json之间的互相转换 接替了T 泛型类的序列化和反序列化的逻辑

   从源码中我们看到区分了2.1版本之前后之后的用法，2.1版本之前可以自定义adapter:

   

[java]  view plain  copy

1. public class PointAdapter extends TypeAdapter<Point> {  
2.  *     public Point read(JsonReader reader) throws IOException {  
3.  *       if (reader.peek() == JsonToken.NULL) {  
4.  *         reader.nextNull();  
5.  *         return null;  
6.  *       }  
7.  *       String xy = reader.nextString();  
8.  *       String[] parts = xy.split(",");  
9.  *       int x = Integer.parseInt(parts[0]);  
10.  *       int y = Integer.parseInt(parts[1]);  
11.  *       return new Point(x, y);  
12.  *     }  
13.  *     public void write(JsonWriter writer, Point value) throws IOException {  
14.  *       if (value == null) {  
15.  *         writer.nullValue();  
16.  *         return;  
17.  *       }  
18.  *       String xy = value.getX() + "," + value.getY();  
19.  *       writer.value(xy);  
20.  *     }  
21.  *   }}  

    使用

  

[java]  view plain  copy

1. GsonBuilder builder = new GsonBuilder();  
2.  *   builder.registerTypeAdapter(Point.class, new PointAdapter());  
3.  *   // if PointAdapter didn't check for nulls in its read/write methods, you should instead use  
4.  *   // builder.registerTypeAdapter(Point.class, new PointAdapter().nullSafe());  
5.  *   ...  
6.  *   Gson gson = builder.create();  

    在2.1版本之后更推荐直接插入泛型就使用

[java]  view plain  copy

1. //   String json = "{'origin':'0,0','points':['1,2','3,4']}";  
2. //   TypeAdapter<Graph> graphAdapter = gson.getAdapter(Graph.class);  
3. //   Graph graph = graphAdapter.fromJson(json);  
4. // }</pre>  
5. // And an example for serialization: <pre>   {@code  
6. //  
7. //   Graph graph = new Graph(...);  
8. //   TypeAdapter<Graph> graphAdapter = gson.getAdapter(Graph.class);  
9. //   String json = graphAdapter.toJson(graph);  
10. // }</pre>  

   实例:使用TypeAdapter 来序列化和反序列化

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.TypeAdapter;  
5.   
6. /** 
7.  * @author xuanyouwu 
8.  * @email [email protected] 
9.  * @time 2016-05-18 11:20 
10.  */  
11. public class GsonTest7 {  
12.     private static void log(String msg) {  
13.         System.out.println(msg);  
14.     }  
15.   
16.     public static class User {  
17.         public String name;  
18.         public int age;  
19.   
20.         @Override  
21.         public String toString() {  
22.             return "User{" +  
23.                     "name='" + name + '\'' +  
24.                     ", age=" + age +  
25.                     '}';  
26.         }  
27.     }  
28.   
29.     public static void main(String[] args) throws Exception {  
30.         Gson gson = new Gson();  
31.         TypeAdapter<User> userTypeAdapter = gson.getAdapter(User.class);  
32.         User user = new User();  
33.         user.name = "xuanyouwu";  
34.         user.age = 26;  
35.         String userJsonStr = userTypeAdapter.toJson(user);  
36.         log("------>序列化:" + userJsonStr);  
37.   
38.         User user1 = userTypeAdapter.fromJson(userJsonStr);  
39.         log("------>反序列化:" + user1);  
40.   
41.     }  
42. }  

[java]  view plain  copy

1. 运行结果:  

[java]  view plain  copy

1. ------>序列化:{"name":"xuanyouwu","age":26}  
2. ------>反序列化:User{name='xuanyouwu', age=26}  

Gson的容错机制:

   为什么要容错了,在javaBean中声明了int类型的age 如果服务端 返回的是"" 空字符串怎么办呢？崩溃？

   如果json格式不规范如 {name=zhangsan,age:26,hobby=null}  发现不是普通的key value

  容错实现方式1：

  1:创建Gson的方式

[java]  view plain  copy

1. gson = new GsonBuilder()  
2.                   .setLenient()// json宽松  
3.                   .create();  

2:使用JsonReader

   JsonReader jsonReader = gson.newJsonReader(value.charStream());

[java]  view plain  copy

1. jsonReader.<span style="font-family: 宋体; font-size: 9pt;">setLenient(true)</span>  

    3:自定义TypeAdapter

    4:使用注解JsonAdapter,其实也是自定义Adapter

 

 1.2归为一类 由框架实现,基本json大格式规范,键值对不标准,多引号的问题等等,而不报错停止解析,但是功能相对较弱

 能解决bug 

[java]  view plain  copy

1. com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Use JsonReader.setLenient(true) to accept malformed JSON<span style="font-family:'宋体';font-size:9pt;background-color:rgb(228,228,255);"> </span>  

3,4归为一类,都属于自定义adapter,但是3与gson绑定,4使用注解和字段绑定

 实例：

   

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5. import com.google.gson.JsonParseException;  
6. import com.google.gson.TypeAdapter;  
7. import com.google.gson.stream.JsonReader;  
8. import com.google.gson.stream.JsonWriter;  
9.   
10. import java.io.IOException;  
11.   
12. /** 
13.  * @author xuanyouwu 
14.  * @email [email protected] 
15.  * @time 2016-05-18 11:20 
16.  */  
17. public class GsonTest8 {  
18.     private static void log(String msg) {  
19.         System.out.println(msg);  
20.     }  
21.   
22.     public static class User {  
23.         public String name;  
24.         public int age;  
25.   
26.         @Override  
27.         public String toString() {  
28.             return "User{" +  
29.                     "name='" + name + '\'' +  
30.                     ", age=" + age +  
31.                     '}';  
32.         }  
33.   
34.   
35.         ;  
36.     }  
37.   
38.     public static class UserTypeAdapter extends TypeAdapter<User> {  
39.   
40.         @Override  
41.         public void write(JsonWriter out, User value) throws IOException {  
42.             out.beginObject();  
43.             out.name("name").value(value.name);  
44.             out.name("age").value(value.age);  
45.             out.endObject();  
46.         }  
47.   
48.         @Override  
49.         public User read(JsonReader in) throws IOException {  
50.             User user = new User();  
51.             in.beginObject();  
52.             while (in.hasNext()) {  
53.                 switch (in.nextName()) {  
54.                     case "name":  
55.                         user.name = in.nextString();  
56.                         break;  
57.                     case "age":  
58.                         try {  
59.                             String str = in.nextString();  
60.                             user.age = Integer.valueOf(str);  
61.                         } catch (Exception e) {  
62.                         }  
63.                         break;  
64.                 }  
65.             }  
66.             in.endObject();  
67.             return user;  
68.         }  
69.     }  
70.   
71.     public static void main(String[] args) throws Exception {  
72.         Gson gson = new Gson();  
73.   
74.         String jsonStrFromServer = "{\n" +  
75.                 "    \"age\": \"\",\n" +  
76.                 "    \"name\": \"zhangsan\"\n" +  
77.                 "}";  
78.         log("------->jsonFromServer:"+jsonStrFromServer);  
79.         try {  
80.             User user = gson.fromJson(jsonStrFromServer, User.class);  
81.             log("------>默认Gson 解析:" + user);  
82.         } catch (JsonParseException e) {//java.lang.NumberFormatException: empty String  
83.             log("------>默认Gson 解析 异常:" + e);  
84.         }  
85.   
86.         Gson gson2 = new GsonBuilder()  
87.                 .registerTypeAdapter(User.class, new UserTypeAdapter()).create();  
88.         try {  
89.             User user2 = gson2.fromJson(jsonStrFromServer, User.class);  
90.             log("------>自定义adapter 解析:" + user2);  
91.         } catch (JsonParseException e) {//java.lang.NumberFormatException: empty String  
92.             log("------>自定义adapter 异常:" + e);  
93.         }  
94.   
95.         try {  
96.             UserTypeAdapter userTypeAdapter = new UserTypeAdapter();  
97.             User user3 = userTypeAdapter.fromJson(jsonStrFromServer);  
98.             log("------>自定义adapter 解析2:" + user3);  
99.         } catch (Exception e) {  
100.             log("------>自定义adapter 异常2:" + e);  
101.         }  
102.     }  
103. }  

运行结果:

------->jsonFromServer:{
    "age": "",
    "name": "zhangsan"
}
------>默认Gson 解析 异常:com.google.gson.JsonSyntaxException: java.lang.NumberFormatException: empty String
------>自定义adapter 解析:User{name='zhangsan', age=0}
------>自定义adapter 解析2:User{name='zhangsan', age=0}

可以看到 age是空字符串 但是不影响整体的解析流程,这对客户端是十分友好的

  基于注解的方式,上面的方式倾向于整体,注解的方式倾向于字段

  

[java]  view plain  copy

1. package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.JsonParseException;  
5. import com.google.gson.TypeAdapter;  
6. import com.google.gson.annotations.JsonAdapter;  
7. import com.google.gson.stream.JsonReader;  
8. import com.google.gson.stream.JsonWriter;  
9.   
10. import java.io.IOException;  
11.   
12. /** 
13.  * @author xuanyouwu 
14.  * @email [email protected] 
15.  * @time 2016-05-18 11:20 
16.  */  
17. public class GsonTest9 {  
18.     private static void log(String msg) {  
19.         System.out.println(msg);  
20.     }  
21.   
22.     public static class User {  
23.         public String name;  
24.         @JsonAdapter(IntegerTypeAdapter.class)  
25.         public int age;  
26.   
27.         @Override  
28.         public String toString() {  
29.             return "User{" +  
30.                     "name='" + name + '\'' +  
31.                     ", age=" + age +  
32.                     '}';  
33.         }  
34.     }  
35.   
36.     public static class IntegerTypeAdapter extends TypeAdapter<Integer> {  
37.   
38.         @Override  
39.         public void write(JsonWriter out, Integer value) throws IOException {  
40.             out.value(value);  
41.         }  
42.   
43.         @Override  
44.         public Integer read(JsonReader in) throws IOException {  
45.             int i = 0;  
46.             try {  
47.                 String str = in.nextString();  
48.                 i = Integer.valueOf(str);  
49.             } catch (Exception e) {  
50.             }  
51.             return i;  
52.         }  
53.     }  
54.   
55.     public static class User2 {  
56.         public String name;  
57.         public int age;  
58.   
59.         @Override  
60.         public String toString() {  
61.             return "User{" +  
62.                     "name='" + name + '\'' +  
63.                     ", age=" + age +  
64.                     '}';  
65.         }  
66.     }  
67.   
68.   
69.     public static void main(String[] args) throws Exception {  
70.         Gson gson = new Gson();  
71.   
72.         String jsonStrFromServer = "{\n" +  
73.                 "    \"age\": \"\",\n" +  
74.                 "    \"name\": \"zhangsan\"\n" +  
75.                 "}";  
76.         log("------->jsonFromServer:" + jsonStrFromServer);  
77.         try {  
78.             User2 user2 = gson.fromJson(jsonStrFromServer, User2.class);  
79.             log("------>gson 解析:" + user2);  
80.         } catch (Exception e) {  
81.             log("------>gson 解析异常:" + e);  
82.         }  
83.   
84.   
85.         try {  
86.             User user = gson.fromJson(jsonStrFromServer, User.class);  
87.             log("------>JsonAdapter 注解 解析:" + user);  
88.         } catch (JsonParseException e) {//java.lang.NumberFormatException: empty String  
89.             log("------>JsonAdapter 注解 异常:" + e);  
90.         }  
91.     }  
92. }  

运行结果:

[java]  view plain  copy

1. ------->jsonFromServer:{  
2.     "age": "",  
3.     "name": "zhangsan"  
4. }  
5. ------>gson 解析异常:com.google.gson.JsonSyntaxException: java.lang.NumberFormatException: empty String  
6. ------>JsonAdapter 注解 解析:User{name='zhangsan', age=0}  

[java]  view plain  copy

1. 可以看到我们成功地跳过服务端返回json不合理的坑了吧  

[java]  view plain  copy

1. </pre><pre code_snippet_id="1687762" snippet_file_name="blog_20160519_47_1535429" name="code" class="java">不得不吐槽啊，像这种服务器端错误，应该完全归结服务端json不合理返回，  

[java]  view plain  copy

1. 往往老板都会找客户端原因，怎么又崩溃了？怎么又不显示了？老板不会关心是不是数据返回不合理的问题的！  

[java]  view plain  copy

1. 做客户端需要相当的承受能力哈,同意的点个赞哈  

[java]  view plain  copy

1. </pre><p>其实上面的方式保险是很保险，但是需要维护的地方多，代码量大，我们介绍另外一种方式:JsonSerializer与JsonDeserializer 之关系单方面的处理，可以全局注册某个类型的处理：看实例：</p><p><pre name="code" class="java">package com.xuan.gson;  
2.   
3. import com.google.gson.Gson;  
4. import com.google.gson.GsonBuilder;  
5. import com.google.gson.JsonDeserializationContext;  
6. import com.google.gson.JsonDeserializer;  
7. import com.google.gson.JsonElement;  
8. import com.google.gson.JsonParseException;  
9.   
10. import java.lang.reflect.Type;  
11.   
12. /** 
13.  * @author xuanyouwu 
14.  * @email [email protected] 
15.  * @time 2016-05-18 11:20 
16.  */  
17. public class GsonTest10 {  
18.     private static void log(String msg) {  
19.         System.out.println(msg);  
20.     }  
21.   
22.     public static class User {  
23.         public String name;  
24.         public int age;  
25.   
26.         @Override  
27.         public String toString() {  
28.             return "User{" +  
29.                     "name='" + name + '\'' +  
30.                     ", age=" + age +  
31.                     '}';  
32.         }  
33.     }  
34.   
35.   
36.     public static void main(String[] args) throws Exception {  
37.         JsonDeserializer<Integer> jsonDeserializer = new JsonDeserializer<Integer>() {  
38.             @Override  
39.             public Integer deserialize(JsonElement json, Type typeOfT, JsonDeserializationContext context) throws JsonParseException {  
40.                 try {  
41.                     return json.getAsInt();  
42.                 } catch (NumberFormatException e) {  
43.                     return 0;  
44.                 }  
45.             }  
46.         };  
47.         Gson gson = new GsonBuilder()  
48.                 .registerTypeAdapter(int.class, jsonDeserializer)  
49.                 .create();  
50.   
51.         String jsonStrFromServer = "{\n" +  
52.                 "    \"age\": \"\",\n" +  
53.                 "    \"name\": \"zhangsan\"\n" +  
54.                 "}";  
55.         log("------->jsonFromServer:" + jsonStrFromServer);  
56.         try {  
57.             User user = gson.fromJson(jsonStrFromServer, User.class);  
58.             log("------>  JsonDeserializer<Integer> 解析:" + user);  
59.         } catch (Exception e) {  
60.             log("------>  JsonDeserializer<Integer> 解析异常:" + e);  
61.         }  
62.   
63.         Gson gson1=new Gson();  
64.         try {  
65.             User user1 = gson1.fromJson(jsonStrFromServer, User.class);  
66.             log("------> 默认gson 解析:" + user1);  
67.         } catch (Exception e) {  
68.             log("------>  默认gson 解析异常:" + e);  
69.         }  
70.   
71.   
72.     }  
73. }  

运行结果:

------->jsonFromServer:{
    "age": "",
    "name": "zhangsan"
}
------>  JsonDeserializer<Integer> 解析:User{name='zhangsan', age=0}
------>  默认gson 解析异常:com.google.gson.JsonSyntaxException: java.lang.NumberFormatException: empty String

 这样定义全局的反序列化工具就能避免解析异常