一般情况下,如果服务器返回 JSON 数据,而且你又是做 Android 的,那么你首先想到的可能是GSON,或是fastJson这样的框架。这些框架能够很方便和快速的让我们将 JSON 转换成本地对象,是开发的首选。但是引用三方库也是有代价的,显而易见的就是包体积增大,库的升级等。这个时候,就需要想一想我们是不是必须要使用三方库了。
其实在 Android 上处理 JSON ,Google 已经给我们提供了一些类,而这些类满足了大多数简单的需求。如果我们只是需要对 JSON 进行简单的解析处理,那么完全可以避免引入第三方库。

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:///stleary/JSON-java 上找到,而且里面的类远不止这4个,里面很多内容都值得去探索一下。但是由于本文仅专注于在 Android 上利用此工具处理 JSON,所以就仅仅讨论着四个类,下面将分别对着四个类逐一讲解。
JSONObject
这个类是这四个类中最关键的一个,它表示了一个可更改且无序的键值对集合,更简单一点,可以直接认为这个类表示了一个 JSON 的信息。在 JSON 字符串中,其表示了一个包裹在花括号的字符串,键和值之间使用冒号隔开,键值和键值之间使用逗号隔开的。
在这个类中,其键名是唯一且不为null的字符串。而值则可以为 JSONObject、JSONArray、Strings、Booleans、Integers、Longs、Double 或者 JSONObject.NULL。特别注意,这里的NULL可不是null,而是JSONObject的一个内部类。
对于这个类,在使用时要要注意的就是在调用时,其会按照调用的方法进行类型转换。下面就介绍一下三类函数:
-
getXXX()获取一个值,此方法如果发生失败,例如没有找到对应的键值或类型转换失败,就会抛出一个JSONException异常; -
optXXX()此类方法也是用于获取一个值,但是如果发生失败,其不会抛出异常,而是返回一个默认值; -
put()此类方法就是向对象中插入一个键值对。特别注意其插入NULL和null是不同的;
刚说到此类中的 NULL,它与 JAVA 中的null是不一样的,它仅仅是JSONObject中用于标识null的对象。举个例子:
-
put(name, null)这个方法调用将会移除该对象中对应的键值; -
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 一样,比如说类型转换,对于NULL和null的处理,有get,put,opt方法等,所以,只要你熟悉了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()方法,对于大多数程序员来说,应该直接调用JSONObject的toString()方法而忽略这个类的:
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()这个函数中,而又可以看到,这个函数也是调用的JSONStringer的key()和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解析功能上确实非常简单,但在很多场景下也是完全够用的。当熟悉了这几个类之后,我们也就可以权衡一下是否真的需要引用第三方库才能完成需求了。如果能满足的话,为什么还需要引用其他库呢。
















