Android：Gson解析 - 从简单数据到复杂数据

Json是一种轻量级的数据交换语言，以文字为基础，且易于让人阅读和编写，同时也易于机器解析和生成，因而在客户端与服务器交互中得到广泛应用。但Json自带的解析类用起来却差强人意，所以市面上因运而生了很多Json转换利器，本文主要介绍其中之一Gson。Gson是google发布的library，主要为了方便将Java对象序列化Serialization至轻量化的封包格式JSON，提供了很多方便快捷的方法。

通过gradle导入包

登录网站MVNRepository，在搜索框中搜索gson，即可出现各种不同的版本，选择gradle下需要的版本，并复制到gradle文件中即可。

Gson基本用法

Gson提供了两个方法直接用于解析和生成方法，二者都有重载方法：

• fromJson()：实现反序列化
• toJson()：实现序列化

基本数据类型的生成

Gson gson = new Gson();
String jsonNumber = gson.toJson(100); // 100
String jsonBoolean = gson.toJson(false); // false
String jsonString = gson.toJson("String"); //"String"

POJO类的生成与解析

对于普通Java类：

public class User {
   public String name; 
   public int age; 
}

生成JSON

Gson gson = new Gson();
User user = new User("Sunny",24);
String jsonObject = gson.toJson(user); // {"name":"Sunny","age":24}

解析JSON

Gson gson = new Gson();
String jsonString = "{\"name\":\"sunny\",\"age\":24}";
User user = gson.fromJson(jsonString, User.class);

注：POJO（Plain Old Java Object）表示普通Java对象，不是JavaBean，EntityBean或者SessionBean。POJO不担当任何特殊的角色，也不实现任何特殊的Java框架的接口。

Gson中的泛型

当我们解析Json数组时，一般有两种方式：使用数组，使用List。而List对于增删都比较方便，所以实际用List较多

数组

String[] strings = gson.fromJson(jsonArray, String[].class);

但对于List将上面代码中的 String[].class ，不能直接改为List.class。对于Java来说 List 和List这两个字节码文件只有一个，就是 List.class，这就是Java泛型使用时要注意的泛型擦除问题。

List

为了解决上述问题，Gson提供TypeToken来实现对泛型的支持。TypeToken 这个类帮助我们捕获（capture）像 List 这样的泛型信息。Java编译器会把捕获到的泛型信息编译到这个匿名内部类里，然后在运行时就可以被 getType() 方法用反射的 API 提取到。也就是将泛型T转成 .class

List stringList = gson.fromJson(jsonArray, new TypeToken>() {}.getType());

注：TypeToken
的构造方法是protected
修饰的,所以上面才会写成new TypeToken>() {}.getType()
而不是new TypeToken>().getType()

@Expose、@SerializeName注解的使用

Json解析的字段和值得名称和类型是一一对应的，但有时前端和后台使用的语言不同，二者语言规范风格不同，命名时常常会出现不和谐的地方。这时 @Expose @SerializeName 两个注解就要发挥他们的作用啦

• @Expose注解：区分实体中不想被序列化的属性，其自身包含两个属性deserialize(反序列化)和serialize(序列化)，默认都为true
• @SerializeName注解：定义属性序列化后的名称
  使用 new GsonBuilder().excludeFieldsWithoutExposeAnnotation().create();创建Gson对象，没有@Expose注释的属性将不会被序列化.。另外想要不序列化某个属性，也可以使用transient。

Gson在序列化和反序列化时需要使用反射，说到反射就想到注解,一般各类库都将注解放到annotations包下，打开源码在com.google.gson包下有一个annotations类，其中有一个SerializedName的注解类，这就是我们用到的。

Gson解析复杂Json数据

首先，要知道两个类：
1、JsonParse
从名称我们就可以看出，这是一个解析类。没错，它可以把 JSON 数据分别通过getAsJsonObject和getAsJsonArray解析成JsonObject和JsonArray。这跟普通的解析 JSON 差不多。
2、JsonElement
是一个抽象类，代表 JSON 串中的某一个元素，可以是JsonObject/JsonArray/JsonPrimitive/...中的任何一种元素。

没有数据头的纯数组

JSON里面只有一个数组，而数组中没有名字：

[
  {
    "name": "zhangsan",
    "age": "10",
    "phone": "11111",
    "email": "[email protected]"
  },
  {
    "name": "lisi",
    "age": "20",
    "phone": "22222",
    "email": "[email protected]"
  },
  ...
]

开始解析，首先定义一个用户类：

public class UserBean {
    //变量名跟JSON数据的字段名需要一致
    private String name ;
    private String age;
    private String phone;
    private String email;
    ...
}

方法一：Gson可以直接解析成一个List

List userList = gson.fromJson(jsonStr, new TypeToken>(){}.getType());

方法二：传统老实方法

    //Json的解析类对象
    JsonParser parser = new JsonParser();
    //将JSON的String 转成一个JsonArray对象
    JsonArray jsonArray = parser.parse(strByJson).getAsJsonArray();

    Gson gson = new Gson();
    ArrayList userBeanList = new ArrayList<>();

    //加强for循环遍历JsonArray
    for (JsonElement user : jsonArray) {
        //使用GSON，直接转成Bean对象
        UserBean userBean = gson.fromJson(user, UserBean.class);
        userBeanList.add(userBean);
    }

有数据头的纯数组数据

{
  "user": [
    {
      "name": "zhangsan",
      "age": "10",
      "phone": "11111",
      "email": "[email protected]"
    },
    {
      "name": "lisi",
      "age": "20",
      "phone": "22222",
      "email": "[email protected]"
    },
    ...
  ]
}

开始解析：

    //先转JsonObject
    JsonObject jsonObject = new JsonParser().parse(strByJson).getAsJsonObject();
    //再转JsonArray 加上数据头
    JsonArray jsonArray = jsonObject.getAsJsonArray("user");

    Gson gson = new Gson();
    ArrayList userBeanList = new ArrayList<>();

    //循环遍历
    for (JsonElement user : jsonArray) {
        //通过反射 得到UserBean.class
        UserBean userBean = gson.fromJson(user, new TypeToken() {}.getType());
        userBeanList.add(userBean);
    }

有数据头的复杂数据

{
  "code": 200,
  "msg": "OK",
  "user": [
    {
      "name": "zhangsan",
      "age": "10",
      "phone": "11111",
      "email": "[email protected]"
    },
    {
      "name": "lisi",
      "age": "20",
      "phone": "22222",
      "email": "[email protected]"
    },
    ...
  ]
}

开始解析：
第一步：根据 JSON 建立 Bean ，注意这里的 Bean 是返回所有字段，因为 GSON 能直接解析成 List ，同时把 get/set 省略。

public class ResultBean {
    //注意变量名与字段名一致
    private int code;
    private String msg;
    private List user;

    public class UserBean{
        private String name ;
        private String age;
        private String phone;
        private String email;
        ...
    }
    ...
}

注意：这个类中有一个UserBean，也可以定义在外面，可以作为JsonArray解析后存入List中的对象。

   //GSON直接解析成对象
    ResultBean resultBean = new Gson().fromJson(strByJson,ResultBean.class);
    //对象中拿到集合
    List userBeanList = resultBean.getUser();

另外，变量名与字段名不一致也可以，因为Json中字段通常为下划线方式，而Java中字段通常为驼峰方式，故需要能够转换对应，而Gson也有相关功能，例如：

public class UserBean {
      @SerializeName("user_name")
      private String userName;
      @SerializeName("user_age")
      private String userAge;
}

工具推荐

jsonschema2pojo：根据JSON结构产生POJO对象

参考资料

Gson User Guide
通透Gson@Expose注解、@SerializedName、解析json数据
Android：用GSON 五招之内搞定任何JSON数组
你真的会用Gson吗?Gson使用指南（一）