4.2 JSONObject 和 GSON 解析 JSON 数据详解

点此进入：从零快速构建APP系列目录导图

点此进入：UI编程系列目录导图

点此进入：四大组件系列目录导图

点此进入：数据网络和线程系列目录导图

本节例程下载地址：WillFLowJSON

一、JSON简介

我们之前已经掌握了 XML 格式数据的解析方式，那么接下来我们要去学习一下如何解析 JSON 格式的数据，在学习之前，我们先将这两者做一个简单的比较。

XML与JSON的对比：

• JSON和XML的数据可读性基本相同
• JSON和XML同样拥有丰富的解析手段
• JSON相对于XML来讲，数据的体积小
• JSON与JavaScript的交互更加方便
• JSON对数据的描述性比XML较差
• JSON的速度要远远快于XML

总之，比起 XML， JSON 的主要优势在于它的体积更小，在网络上传输的时候可以更省流量。但缺点在于，它的语义性较差，看起来不如 XML 直观。

（1）JSON 的格式规范

就像协议一样，JSON 也是有一套规范的，毕竟服务端和客户端双方一般来讲都是通过 JSON 字符串来传递数据的。

它的语法规则如下：
- 数据在“名称/值”对中；
- 数据由逗号分隔；
- 花括号保存对象；
- 方括号保存数组；

（2）JSON数据的书写格式范例

[    { "id":"1","name":"WGH","age":"18" },    { "id":"2","name":"WillFlow","age":"16"  }]

（3）JSON校验工具

我们除了解析JSON还可以自己拼接JSON，当然如果你自己拼了一个JSON字符串又不知道对不对， 可以用校验工具进行校验，比如：点击这里，然后把自己拼接的JSON字符串贴上去，就可以校验正确与否了。

（4）Android给我们提供的JSON解析类

这些JSON解析类的API都存在于org.json包下，而我们用到的类有下面这些：
- JSONObject： JSON对象，可以完成Json字符串与Java对象的相互转换
- JSONArray： JSON数组，可以完成Json字符串与Java集合或对象的相互转换
- JSONStringer： JSON文本构建类，这个类可以帮助快速和便捷的创建JSON text， 每个JSONStringer实体只能对应创建一个JSON text
- JSONTokener：JSON解析类
- JSONException：JSON异常

二、用 JSONObject 解析 JSON 格式数据

首先在MainActivity中定义一个JSON 字符串常量，代码如下：

    private static final String JSON = "[\n" +            "  {\"id\":\"1\",\"version\":\"1.5\",\"name\":\"Apple\"},\n" +            "  {\"id\":\"2\",\"version\":\"1.6\",\"name\":\"WillFlow\"},\n" +            "  {\"id\":\"3\",\"version\":\"1.7\",\"name\":\"WGH\"}\n" +            "]";

这样我们就把 JSON 格式的数据准备好了，下面就开始在 Android 程序中解析这些数据。

修改 MainActivity 中的代码，如下所示：

    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        parseJSONWithJSONObject(JSON);    }    private void parseJSONWithJSONObject(String jsonData) {        try {            JSONArray jsonArray = new JSONArray(jsonData);            for (int i = 0; i < jsonArray.length(); i++) {                JSONObject jsonObject = jsonArray.getJSONObject(i);                String id = jsonObject.getString("id");                String name = jsonObject.getString("name");                String version = jsonObject.getString("version");                Log.i(TAG, "id : " + id);                Log.i(TAG, "name : " + name);                Log.i(TAG, "version : " + version);                Log.i(TAG, "————————————————————");            }        } catch (Exception e) {            e.printStackTrace();        }    }

可以看到，解析 JSON 的代码真的是非常简单，由于我们定义的是一个 JSON 数组，因此这里首先是将数据传入到了一个 JSONArray 对象中，然后循环遍历这个 JSONArray，从中取出的每一个元素都是一个 JSONObject 对象，每个 JSONObject 对象中又会包含 id、 name 和 version 这些数据。接下来只需要调用 getString() 方法将这些数据取出，并打印出来即可。

编译运行查看日志数出

三、用 GSON 解析 JSON 格式数据

如何你认为使用 JSONObject 来解析 JSON 数据已经非常简单了，那你就太容易满足了。谷歌提供的 GSON 开源库可以让解析 JSON 数据的工作简单到让你不敢想象的地步，那我们肯定是不能错过这个学习机会的。

首先，在Gradle中配置如下依赖：

dependencies {    ......    compile 'com.google.code.gson:gson:2.8.1'}

这时候GSON框架就加载好了，我们需要手动同步一下。

如果你的 Android Studio 中没有安装GSON插件的话，可以这样安装：

完成之后重启 Android Studio 即可。

那么 GSON 库究竟是神奇在哪里呢？其实它主要就是可以将一段 JSON格式的字符串自动映射成一个对象，从而不需要我们再手动去编写代码进行解析了，比如说一段 JSON 格式的数据如下所示：

{"name":"Tom","age":20}

那我们就可以定义一个 Person 类，并加入 name 和 age 这两个字段，然后只需简单地调用如下代码就可以将 JSON 数据自动解析成一个 Person 对象了：

Gson gson = new Gson();Person person = gson.fromJson(jsonData, Person.class);

如果需要解析的是一段 JSON 数组会稍微麻烦一点，我们需要借助 TypeToken 将期望解析成的数据类型传入到 fromJson() 方法中，如下所示：

List<Person> people = gson.fromJson(jsonData, new TypeToken<List<Person>>(){}.getType());

基本的用法就是这样，下面就让我们来真正地尝试一下。

这里我们首先准备好需要解析的JSON原始数据：

[  {"id":"1","version":"1.5","name":"Apple"},  {"id":"2","version":"1.6","name":"WillFlow"},  {"id":"3","version":"1.7","name":"WGH"}]

然后新建一个AppBean类，用于数据规范的定义：

/** * Created by   : WGH. */public class AppBean {}

然后在该类的任意位置“Alt + Insert”，然后选择“Gson Format”或者使用快捷键“Alt + S”

##### 然后会出现这样的界面，然后把我们刚才的JSON原始数据粘贴进去后点击OK：

继续点击OK，你会发现此时的AppBean变成了这个样子：

/** * Created by   : WGH. */public class AppBean {    /**     * id : 1     * version : 1.5     * name : Apple     */    private String id;    private String version;    private String name;    public String getId() {        return id;    }    public void setId(String id) {        this.id = id;    }    public String getVersion() {        return version;    }    public void setVersion(String version) {        this.version = version;    }    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }}

这是一个包含了id、 name 和 version 这三个字段的数据类，并且成员变量和JSON原始数据的Key值完全相同（这点尤为重要，这是采用GSON解析的必须）。

最后在 MainAcitivyt 中定义这样的方法：

    private void parseByGSON(String jsonData) {        Gson gson = new Gson();        List<AppBean> appList = gson.fromJson(jsonData, new TypeToken<List<AppBean>>() {}.getType());        for (AppBean app : appList) {            Log.i(TAG, "id : " + app.getId());            Log.i(TAG, "name : " + app.getName());            Log.i(TAG, "version : " + app.getVersion());            Log.i(TAG, "————————————————————");        }    }

然后调用输出即可。

编译运行查看Log输出

这样我们就就把 XML 和 JSON 这两种数据格式最常用的几种解析方法都学习完了，在网络数据的解析方面，我们已经成功毕业了。

点此进入：GitHub开源项目“爱阅”，下面是“爱阅”的效果图：

联系方式：

简书：WillFlow
CSDN：WillFlow
微信公众号：WillFlow