Kotlin入门(31)JSON字符串的解析
json是App进行网络通信最常见的数据交互格式，Android也自带了json格式的处理工具包org.json，该工具包主要提供了JSONObject（json对象）与JSONArray（json数组）的解析处理。下面分别介绍这两个工具类的用法：
1、JSONObject
JSONObject的常用方法如下所示：
构造函数 : 从指定字符串构造出一个JSONObject对象。
getJSONObject : 获取指定名称的JSONObject对象。
getString : 获取指定名称的字符串。
getInt : 获取指定名称的整型数。
getDouble : 获取指定名称的双精度数。
getBoolean : 获取指定名称的布尔数。
getJSONArray : 获取指定名称的JSONArray数组对象。
put : 添加一个JSONObject对象。
toString : 把当前JSONObject输出为一个json字符串。
2、JSONArray
JSONArray的常用方法如下所示：
length : 获取JSONArray数组对象的长度。
getJSONObject : 获取JSONArray数组对象在指定位置处的JSONObject对象。
put : 往JSONArray数组对象中添加一个JSONObject对象。
使用JSONObject和JSONArray对json串进行手工解析，处理过程比较常规，完成该功能的Kotlin代码与Java代码大同小异。下面直接给出Kotlin解析json串的常用代码片段，包括如何构造json串、如何解析json串，以及如何遍历json串：
//构造json串
private val jsonStr: String
get() {
val obj = JSONObject()
obj.put("name", "地址信息")
val array = JSONArray()
for (i in 0..2) {
val item = JSONObject()
item.put("item", "第${i+1}个元素")
array.put(item)
}
obj.put("list", array)
obj.put("count", array.length())
obj.put("desc", "这是测试串")
return obj.toString()
}
//解析json串
private fun parserJson(jsonStr: String?): String {
val obj = JSONObject(jsonStr)
var result = "name=${obj.getString("name")}\n" +
"desc=${obj.getString("desc")}\n" +
"count=${obj.getInt("count")}\n"
val listArray = obj.getJSONArray("list")
//util表示的范围是左闭右开区间。以下语句相当于for (i in 0..listArray.length() - 1)
for (i in 0 until listArray.length()) {
val item = listArray.getJSONObject(i)
result = "${result}\titem=${item.getString("item")}\n"
}
return result
}
//遍历json串
private fun traverseJson(jsonStr: String?): String {
var result = ""
val obj = JSONObject(jsonStr)
val it = obj.keys()
while (it.hasNext()) { // 遍历JSONObject
var key = it.next().toString()
result = "${result}key=$key, value=${obj.getString(key)}\n"
}
return result
}
前面提到Kotlin对json串的手工解析没有什么好办法，其实是有更高层次的办法。手工解析json串实在是麻烦，费时费力还容易犯错，所以好汉不吃眼前亏，此路难走不如另寻捷径，捷径便是甩开手工解析几条街的自动解析。
既然是自动解析，首先要制定一个规则，约定json串有哪些元素，具体对应怎样的数据结构；其次还得有个自动解析的工具，俗话说得好，没有金刚钻、不揽瓷器活。对于捷径第一要素的json数据结构定义，Kotlin特有的数据类正好派上用场了，字段名、字段类型、字段默认值等色香味俱全，还有equals、copy、toString等下酒小菜，只要开发者轻拉珠帘便是一大桌的满汉全席。到底有多么省事，且看下面的用户信息数据类，包括姓名、年龄、身高体重、婚否等字段存取在内的完整功能，仅需一行Kotlin代码就全部搞定了：
data class UserInfo(var name: String="", var age: Int=0, var height: Long=0L, var weight: Float=0F, var married: Boolean=false)
接着解决捷径第二要素的工具使用，json解析除了系统自带的org.json，谷歌公司也提供了一个增强库gson，专门用于json串的自动解析。不过由于是第三方库，因此首先要修改模块的build.gradle文件，在里面的dependencies节点下添加下面一行配置，表示导入指定版本的gson库：
compile "com.google.code.gson:gson:2.8.2"
其次还要在kt源码文件头部添加如下一行导入语句，表示后面会用到Gson工具类：
import com.google.gson.Gson
完成了以上两个步骤，然后就能在代码中调用Gson的各种处理方法了，Gson常用的方法有两个，一个名叫toJson，可把数据对象转换为json字符串；另一个名叫fromJson，可将json字符串自动解析为数据对象，方法调用的代码格式为“fromJson(json串, 数据类的类名::class.java)”。Kotlin的数据类定义代码尚且只有一行，这里的json串自动解析仍旧只需一行代码，实实在在为开发者节省了不少功夫。下面是个通过gson库实现json自动解析的Kotlin代码例子：
class JsonConvertActivity : AppCompatActivity() {
private val user = UserInfo(name="阿四", age=25, height=160L, weight=45.0f, married=false)
private val json = Gson().toJson(user)
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_json_convert)
btn_origin_json.setOnClickListener { tv_json.text = "json串内容如下：\n$json" }
btn_convert_json.setOnClickListener {
//利用Gson包直接将json串解析为对应格式的数据类对象
val newUser = Gson().fromJson(json, UserInfo::class.java)
tv_json.text = "从json串解析而来的用户信息如下：" +
"\n\t姓名=${newUser.name}" +
"\n\t年龄=${newUser.age}" +
"\n\t身高=${newUser.height}" +
"\n\t体重=${newUser.weight}" +
"\n\t婚否=${newUser.married}"
}
}
}
