11.4--解析 JSON 格式数据

现在你已经掌握了 XML 格式数据的解析方式，那么接下来我们要去学习一下如何解析 JSON 格式的数据了。比起 XML, JSON 的主要优势在于它的体积更小，在网络上传输的时侯可以更省流量。但缺点在于，它的语义性较差，看起来不如 XML 直观。

在开始之前，我们还需要在 C: \Apache\htdocs 目录中新建一个 get_data.json 的文件，然后编辑这个文件，并加入如下 JSON 格式的内容：

[
  {
    "id": "5",
    "version": "5.5",
    "name": "Clash of Clans"
  },
  {
    "id": "6",
    "version": "7.0",
    "name": "Boom Beach"
  },
  {
    "id": "7",
    "version": "3.5",
    "name": "Lash Royale"
  }
]

这时在浏览器中访问 http://127.0.0.1/get_data.json 这个网址，就应该出现如图所示的内容：

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

 

11.4.1 使用 JSONObject

类似地，解析 JSON 数据也有很多种方法，可以使用官方提供的 JSONObject，也可以使用谷歌的开源库 GSON。另外，一些第三方的开源库如 Jackson、FastJSON 等也非常不错。本节中我们就来学习ー下前两种解析方式的用法。

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

    private fun sendRequestWithOkHttp() {
        // 开启线程发起网络请求
        thread {
            try {
                val client = OkHttpClient()
                val request = Request.Builder()
                        // 访问的服务器地址是计算机本机
                    .url("http://10.0.2.2/get_data.json")
                    .build()
                val response = client.newCall(request).execute()
                val responseData = response.body?.string()
                if (responseData != null){
                    parseJSONWithJSONObject(responseData)
                }
            }catch (e:Exception){
                e.printStackTrace()
            }
        }
    }

    private fun parseJSONWithJSONObject(jsonData: String) {
        try {
            val jsonArray = JSONArray(jsonData)
            // 回忆一下 0 until jsonArray.length() 区间遍历
            for (i in 0 until jsonArray.length()){
                val jsonObject = jsonArray.getJSONObject(i)
                val id = jsonObject.getString("id")
                val name = jsonObject.getString("name")
                val version = jsonObject.getString("version")
                Log.d("MainActivity","id is $id")
                Log.d("MainActivity","name is $name")
                Log.d("MainActivity","version is $version")
            }
        }catch (e:Exception){
            e.printStackTrace()
        }
    }

首先记得要将 HTTP 请求的地址改成 http: //10.0.2.2/get_data.json,然后在得到了服务器返回的数据后调用 parseJSONWithJSONObject() 方法来解析数据。可以看到，解析 JSON 的代码真的非常简单，由于我们在服务器中定义的是一个 JSON 数组，因此这里首先是将服务器返回的数据传入到了一个 JSONArray 对象中。然后循环遍历这个 JSONArray，从中取出的每一个元素都是一个 JSONObject 对象，每个 JSONObject 对象中又会包含 id、name 和 version 这些数据。接下来只需要调用 getString() 方法将这些数据取出，并打印出来即可。

好了，就是这么简单！现在重新运行一下程序，并点击 Send Request 按钮，结果如图所示：

 

11.4.2 使用GSON

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

不过 GSON 并没有被添加到 Android 官方的 API 中，因此如果想要使用这个功能的话，就必须要在项目中添加 GSON 库的依赖。编辑 app/build.gradie 文件，在 dependencies 闭包中添加如下内容：

dependencies {
    ...
    implementation 'com.google.code.gson:gson:2.8.5'
}

那么 GSON 库究竟是神奇在哪里呢？它的强大之处就在于可以将一段JSON 格式的字符串自动映射成一个对象，从而不需要我们再手动编写代码进行解析了。

比如说一段 JSON 格式的数据如下所示：

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

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

        val gson = Gson()
        val person = gson.fromJson(jsonData,Person::class.java)

如果需要解析的是一段 JSON 数组，会稍微麻烦一点，比如如下格式的数据：

[{"name":"Tom","age":20},{"name":"Jack","age":25},{"name":"Lily","age":22}]

这个时候，我们需要借助TypeToken 将期望解析成的数据类型传入fromJson() 方法中，如下所示：

val typeOf = object : TypeToken<List<Person>>(){}.type
val people = gson.fromJson<List<Person>>(jsonData,typeOf)

好了，基本的用法就是这样，下面就让我们来真正地尝试一下吧。首先新増一个 App 类，并加入 id、name 和 version 这 3 个字段，如下所示：

class App(val id:String,val name:String,val version:String)

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

    private fun sendRequestWithOkHttp() {
        // 开启线程发起网络请求
        thread {
            try {
                val client = OkHttpClient()
                val request = Request.Builder()
                        // 访问的服务器地址是计算机本机
                    .url("http://10.0.2.2/get_data.json")
                    .build()
                val response = client.newCall(request).execute()
                val responseData = response.body?.string()
                if (responseData != null){
                    parseJSONWithGSON(responseData)
                }
            }catch (e:Exception){
                e.printStackTrace()
            }
        }
    }

    private fun parseJSONWithGSON(jsonData: String) {
        val gson = Gson()
        val typeOf = object : TypeToken<List<App>>(){}.type
        val appList = gson.fromJson<List<App>>(jsonData, typeOf)
        for (app in appList) {
            Log.d("MainActivity","id is ${app.id}")
            Log.d("MainActivity","name is ${app.name}")
            Log.d("MainActivity","version is ${app.version}")
        }
    }

现在重新运行程序，点击 Send Request 按钮后观察 logcat 中的打印日志，你会看到和图中一样的结果。

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