GSON简单实用及常用方法(附 .jar 地址)

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 print ?
  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 print ?
  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 print ?
  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 list = Arrays.asList("1""a""3""rt""5");  
  26.         log("---->list convert jsonStr:" + gson.toJson(list));  
  27.   
  28.         Map content = new HashMap();  
  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 print ?
  1. 运行结果:  
[java] view plain copy print ?
  1. ---->list convert jsonStr:["1","a","3","rt","5"]  
  2. ---->map convert jsonStr:{"name":"xuanyouwu","age":"26"}  

       Json字符串转JavaBean

[java] view plain copy print ?
  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 print ?
  1. String listJsonStr="[\"1\",\"a\",\"3\",\"rt\",\"5\"]";  
[java] view plain copy print ?
  1. Type type = new TypeToken>() {  
  2. }.getType();  
  3. ArrayList sList=gson.fromJson(listJsonStr, type);  
  4. log("------->json convert List:"+sList);  
[java] view plain copy print ?
  1. 运行结果:  
[java] view plain copy print ?
  1. ------->json convert List:[1, a, 3, rt, 5]  
[java] view plain copy print ?
  1. "1687762" snippet_file_name="blog_20160518_11_939636" name="code" class="java">  Gson封装的类型体系  
[java] view plain copy print ?
  1.    Gson里面有一个非常有意思的抽象基类JsonElement,他的继承体系:  
[java] view plain copy print ?
  1. "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 print ?
  1.  JsonObject等同于org的JSONObject,JsonArray也类似,  
[java] view plain copy print ?
  1. JsonNull 其实就是null 字段  
[java] view plain copy print ?
  1. JsonNull jsonNull=new JsonNull();//构造方法过时,推荐INSTANCE  
[java] view plain copy print ?
  1. JsonNull jsonNull=JsonNull.INSTANCE;  
  2.   log("-----"+jsonNull);  
[java] view plain copy print ?
  1. 运行结果:  
[java] view plain copy print ?
  1. -----null  

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

     

[java] view plain copy print ?
  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 print ?
  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 print ?
  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 print ?
  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 print ?
  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 print ?
  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 print ?
  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 print ?
  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 print ?
  1. "1687762" snippet_file_name="blog_20160518_25_4965554" name="code" class="java">可以排除不需要序列化的字段,需要配合GsonBuilder使用  
[java] view plain copy print ?
  1. "font-family: 宋体; font-size: 9pt; background-color: rgb(255, 255, 255);">"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 print ?
  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 print ?
  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 print ?
  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 print ?
  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 print ?
  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

[java] view plain copy print ?
  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 print ?
  1. public class PointAdapter extends TypeAdapter {  
  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 print ?
  1. GsonBuilder builder = new GsonBuilder();  
  2.  *   builder.registerTypeAdapter(Point.classnew 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 print ?
  1. //   String json = "{'origin':'0,0','points':['1,2','3,4']}";  
  2. //   TypeAdapter graphAdapter = gson.getAdapter(Graph.class);  
  3. //   Graph graph = graphAdapter.fromJson(json);  
  4. // }
  
  • // And an example for serialization: 
       {@code  
  • //  
  • //   Graph graph = new Graph(...);  
  • //   TypeAdapter graphAdapter = gson.getAdapter(Graph.class);  
  • //   String json = graphAdapter.toJson(graph);  
  • // }  
  •    实例:使用TypeAdapter 来序列化和反序列化
       
       
       
       
       
    [java] view plain copy print ?
    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 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 print ?
    1. 运行结果:  
    [java] view plain copy print ?
    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 print ?
    1. gson = new GsonBuilder()  
    2.                   .setLenient()// json宽松  
    3.                   .create();  
    2:使用JsonReader
       JsonReader jsonReader = gson.newJsonReader(value.charStream());
       
       
       
       
    [java] view plain copy print ?
    1. jsonReader."font-family: 宋体; font-size: 9pt;">setLenient(true)  

        3:自定义TypeAdapter

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

     

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

     能解决bug 

    [java] view plain copy print ?
    1. com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Use JsonReader.setLenient(true) to accept malformed JSON"font-family:宋体; font-size:9pt; background-color:rgb(228,228,255)"  

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

     实例:

       

    [java] view plain copy print ?
    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 {  
    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.classnew 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 print ?
    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 {  
    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 print ?
    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 print ?
    1. 可以看到我们成功地跳过服务端返回json不合理的坑了吧  
    [java] view plain copy print ?
    1. "1687762" snippet_file_name="blog_20160519_47_1535429" name="code" class="java">不得不吐槽啊,像这种服务器端错误,应该完全归结服务端json不合理返回,  
    [java] view plain copy print ?
    1. 往往老板都会找客户端原因,怎么又崩溃了?怎么又不显示了?老板不会关心是不是数据返回不合理的问题的!  
    [java] view plain copy print ?
    1. 做客户端需要相当的承受能力哈,同意的点个赞哈  
    [java] view plain copy print ?
    1. 其实上面的方式保险是很保险,但是需要维护的地方多,代码量大,我们介绍另外一种方式:JsonSerializer与JsonDeserializer 之关系单方面的处理,可以全局注册某个类型的处理:看实例:

      "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 jsonDeserializer = new JsonDeserializer() {  
    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 解析:" + user);  
    59.         } catch (Exception e) {  
    60.             log("------>  JsonDeserializer 解析异常:" + 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 解析:User{name='zhangsan', age=0}
    ------>  默认gson 解析异常:com.google.gson.JsonSyntaxException: java.lang.NumberFormatException: empty String

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



    GSON : http://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.0/      

    你可能感兴趣的:(数据)