Android解析JSON,你真的需要三方库?

一般情况下,如果服务器返回 JSON 数据,而且你又是做 Android 的,那么你首先想到的可能是GSON,或是fastJson这样的框架。这些框架能够很方便和快速的让我们将 JSON 转换成本地对象,是开发的首选。但是引用三方库也是有代价的,显而易见的就是包体积增大,库的升级等。这个时候,就需要想一想我们是不是必须要使用三方库了。

其实在 Android 上处理 JSON ,Google 已经给我们提供了一些类,而这些类满足了大多数简单的需求。如果我们只是需要对 JSON 进行简单的解析处理,那么完全可以避免引入第三方库。

json_icon.png

org.json

Android的参考文档中,我们能发现一个包,名为:org.json。这个包下主要有四个类:

类名 描述
JSONArray A dense indexed sequence of values.
JSONObject A modifiable set of name/value mappings.
JSONStringer Implements toString() and toString()
JSONTokener Parses a JSON (RFC 4627) encoded string into the corresponding object.

关于 org.json 的代码,还可以在 https://github.com/stleary/JSON-java 上找到,而且里面的类远不止这4个,里面很多内容都值得去探索一下。但是由于本文仅专注于在 Android 上利用此工具处理 JSON,所以就仅仅讨论着四个类,下面将分别对着四个类逐一讲解。

JSONObject

这个类是这四个类中最关键的一个,它表示了一个可更改且无序的键值对集合,更简单一点,可以直接认为这个类表示了一个 JSON 的信息。在 JSON 字符串中,其表示了一个包裹在花括号的字符串,键和值之间使用冒号隔开,键值和键值之间使用逗号隔开的。

在这个类中,其键名是唯一且不为null的字符串。而值则可以为 JSONObjectJSONArrayStringsBooleansIntegersLongsDouble 或者 JSONObject.NULL。特别注意,这里的NULL可不是null,而是JSONObject的一个内部类。

对于这个类,在使用时要要注意的就是在调用时,其会按照调用的方法进行类型转换。下面就介绍一下三类函数:

  • getXXX() 获取一个值,此方法如果发生失败,例如没有找到对应的键值或类型转换失败,就会抛出一个JSONException异常;
  • optXXX() 此类方法也是用于获取一个值,但是如果发生失败,其不会抛出异常,而是返回一个默认值;
  • put()此类方法就是向对象中插入一个键值对。特别注意其插入NULLnull是不同的;

刚说到此类中的 NULL,它与 JAVA 中的null是不一样的,它仅仅是JSONObject中用于标识null的对象。举个例子:

  1. put(name, null) 这个方法调用将会移除该对象中对应的键值;
  2. put(name, JSONObject.NULL) 将会往对象中添加一个键值,而其值为 JSONObject.NULL

下面通过一个实际使用的代码来演示该类:

JSONObject jsonObject = new JSONObject("{\"first_name\":\"Taylor\",\"last_name\":\"swifter\"}");
String firstName = jsonObject.getString("first_name");
String lastName = jsonObject.getString("last_name");
Log.i("swifter", firstName + " " + lastName);   //输出 Taylor swifter

jsonObject.put("first_name", "Avril");
Log.i("swifter", jsonObject.toString());   //输出 {"first_name":"Avril","last_name":"swifter"}

通过代码也可以看到JSONObject的简单用法,可以看到这个类也可以用来进行构建 JSON 字符串,只要不断向类中使用put()方法插入或是修改,在最后使用toString()就可以得到最终的 JSON 了。

关于这个toString()这个函数后面还会提到,下面介绍的是在这四个类中第二重要的类:表示数组的JSONArray

JSONArray

该类表示了 JSON 中的值的数组,可以简单的理解其为一个普通数组,也有getXXX()optXXX()方法,但是基本都需要传入索引值。这个类代表了JSON 中的一个包裹在方括号的字符串,值和值之间使用逗号隔开的信息。

除此之外,这个类有很多性质都与JSONObject 一样,比如说类型转换,对于NULLnull的处理,有getputopt方法等,所以,只要你熟悉了JSONObject,那么使用这个类,也会非常容易:

JSONArray jsonArray = new JSONArray("[10,11,12,13,14,15,16]");
for(int index = 0; index < jsonArray.length(); index++) {
    Log.i("swifter", index+" : "+jsonArray.getInt(index));
}

此段代码的输出是将10到16这几个数组中的数打印出来。在更多情况下,该类一般都是与JSONObject一起使用的,因为普遍的 JSON 都是其中的某一个字段是数组,因此需要先使用JSONObject进行解析,然后使用getJSONArray()再来获取这个数组的信息并进行处理:

JSONObject jsonObject = new JSONObject("{\"first_name\":\"Taylor\",\"last_name\":\"swifter\",
                                         \"array\":[first, second, third, fourth]}");
JSONArray jsonArray = jsonObject.getJSONArray("array");
for(int index = 0; index < jsonArray.length(); index++) {
    Log.i("swifter", index+" : "+jsonArray.getString(index));
}

此段待会会将 JSON 中array的四个值以字符串的形式依次打印出来。

JSONStringer

此类可以用于快速构建 JSON 文本,它实现了JSONObject中的两个toString()方法,对于大多数程序员来说,应该直接调用JSONObjecttoString()方法而忽略这个类的:

JSONObject object = ...
String json = object.toString();

它使用了一种类似于 XML 事件解析的方式来实现 JSON 构建,例如它有key()方法用于插入键,有value()方法用于插入值,而且还有array()endArray()用于开始和结束插入数组,有object()endObject()方法用于开始和结束插入 JSON 内容。

仅仅说其有什么方法比较涩会难懂,那就上代码:

JSONStringer jsonStringer = new JSONStringer();
jsonStringer.object().key("first_name").value("Taylor").key("last_name").value("swifter");
jsonStringer.key("array").array().value(12).value(13).value(14).endArray().endObject();
Log.i("swifter", jsonStringer.toString());      //输出 {"first_name":"Taylor","last_name":"swifter","array":[12,13,14]}

可以看到对于 JSON 的构建,该类就是通过这几个方法的调用来实现的。

刚才说到JSONObject类的toString()方法就是通过这个类来实现的,那它是怎么实现的呢?现在就来看看代码吧。它有两个方法,为了简单起见,我们就看其中一个:

/**
 * Encodes this object as a compact JSON string, such as:
 * <pre>{"query":"Pizza","locations":[94043,90210]}</pre>
 */
@Override public String toString() {
    try {
        JSONStringer stringer = new JSONStringer();
        writeTo(stringer);
        return stringer.toString();
    } catch (JSONException e) {
        return null;
    }
}

void writeTo(JSONStringer stringer) throws JSONException {
    stringer.object();
    for (Map.Entry<String, Object> entry : nameValuePairs.entrySet()) {
        stringer.key(entry.getKey()).value(entry.getValue());
    }
    stringer.endObject();
}

这段代码显示了JSONObject是如何处理toString()的,其主要的工作在writeTo()这个函数中,而又可以看到,这个函数也是调用的JSONStringerkey()value()等方法来实现 JSON 构造的。另一个toString()也类似,仅仅是是用了JSONStringer的另一个构造函数而已。

JSONTokener

这个类是四个类中最不常用的一个类,它能够将一个 JSON 字符串(RFC 4627)解析到相关的对象,对于大多数客户端仅仅需要使用它的构造函数和nextValue()函数:

 String json = "{"
         + "  \"query\": \"Pizza\", "
         + "  \"locations\": [ 94043, 90210 ] "
         + "}";
 JSONObject object = (JSONObject) new JSONTokener(json).nextValue();
 String query = object.getString("query");
 JSONArray locations = object.getJSONArray("locations");

可见,这个类就是和JSONObject的构造函数一起使用的,用于解析 JSON 源字符串,还例如:

 JSONObject jsonobj = new JSONObject(new JSONTokener(new FileReader(new File("json.txt")))); 

上面的四个类的内容都如此吧。相比于其他第三方库,内置的JSON解析功能上确实非常简单,但在很多场景下也是完全够用的。当熟悉了这几个类之后,我们也就可以权衡一下是否真的需要引用第三方库才能完成需求了。如果能满足的话,为什么还需要引用其他库呢。

2b013df0-5b70-4c07-833e-6d95101e2d10.jpg
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,684评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,143评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,214评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,788评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,796评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,665评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,027评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,679评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,346评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1 331
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,412评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,015评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2 343

推荐阅读更多精彩内容