JSON 的定义:

一种轻量级的数据交换格式,具有良好的可读和便于快速编写的特性。业内主流技术为其提供了完整的解决方案(有点类似于正则表达式
,获得了当今大部分语言的支持),从而可以在不同平台间进行数据交换。 JSON 采用兼容性很高的文本格式,同时也具备类似于 C 语言体系的行为。 – Json.org

JSON 的结构:

Name/Value Pairs ,类似所熟知的 Keyed list 、 Hash table 、 Disctionary 和 Associative array 。在 Android 平台中同时存在另外一个类 “Bundle “,某种程度上具有相似的行为。 org.json.JSONObject

Array ,一组有序的数据列表。 org.json.JSONArray

在 Android 中包含四个与 JSON 相关的类和一个 Exceptions :

JSONArray

JSONObject

JSONStringer

JSONTokener

JSONException

JSONObject:

这是系统中有关 JSON 定义的基本单元,其包含一对儿 (Key/Value) 数值。它对外部 (External :应用 toString() 方法输出的数值 ) 调用的响应体现为一个标准的字符串(例如: { “JSON ”: “Hello, World ”} ,最外被大括号包裹,其中的 Key 和 Value 被冒号 ”: ”分隔)。其对于内部 (Internal) 行为的操作格式略微,例如:初始化一个 JSONObject 实例,引用内部的 put() 方法添加数值: new JSONObject().put( “JSON ”, “Hello, World! ”) ,在 Key 和 Value 之间是以逗号 ”,” 分隔。

Value 的类型包括: Boolean 、 JSONArray 、 JSONObject 、 Number 、 String 或者默认值 JSONObject.NULL object 。

有两个不同的取值方法:

get(): 在确定数值存在的条件下使用,否则当无法检索到相关 Key 时,将会抛出一个 Exception 信息。

opt(): 这个方法相对比较灵活,当无法获取所指定数值时,将会返回一个默认数值,并不会抛出异常。

JSONArray:

它代表一组有序的数值。将其转换为 String 输出 (toString) 所表现的形式是用方括号包裹,数值以逗号 ”,” 分隔(例如: [value1,value2,value3] ,大家可以亲自利用简短的代码更加直观的了解其格式)。这个类的内部同样具有查询行为, get() 和 opt() 两种方法都可以通过 index 索引返回指定的数值, put() 方法用来添加或者替换数值。

同样这个类的 value 类型可以包括: Boolean 、 JSONArray 、 JSONObject 、 Number 、 String 或者默认值 JSONObject.NULL object 。

JSONStringer:

根据官方的解释,这个类可以帮助快速和便捷的创建 JSONtext 。其最大的优点在于可以减少由于格式的错误导致程序异常,引用这个类可以自动严格按照 JSON 语法规则( syntaxrules )创建 JSON text 。每个 JSONStringer 实体只能对应创建一个 JSON text 。

根据下边的实例来了解其它相关信息:

 

string myString = new JSONStringer().object() .key(“AR”).value(“www.Androidres.com!”).endObject().toString();

结果是一组标准格式的 JSON text : { ”AR ”: ”www.Androidres.com ! ”}

其中的 .object() 和 .endObject() 必须同时使用,是为了按照 Object 标准给数值添加边界。同样,针对数组也有一组标准的方法来生成边界 .array() 和 .endArray() 。

JSONTokener:

这个是系统为 JSONObject 和 JSONArray 构造器解析 JSON source string 的类,它可以从 source string 中提取数值信息。

JSONException:

是 JSON.org 类抛出的异常信息。

下面引用一个完整的应用实例
(来自: androidsnippets.org )

应用 JSONObject 存储 Map 类型数值:

 

 

public static JSONObject getJSON(Map map) {
    Iterator iter = map.entrySet().iterator();
    JSONObject holder = new JSONObject();
    while (iter.hasNext()) {
        Map.Entry pairs = (Map.Entry) iter.next();
        String key = (String) pairs.getKey();
        Map m = (Map) pairs.getValue();
        JSONObject data = new JSONObject();
      try {
            Iterator iter2 = m.entrySet().iterator();
            while (iter2.hasNext()) {
                Map.Entry pairs2 = (Map.Entry) iter2.next();
                data.put((String) pairs2.getKey(), (String) pairs2.getValue());
            }
            holder.put(key, data);
        } catch (JSONException e) {
            Log.e(“Transforming”, “There was an error packaging JSON”,e);
        }
    }
    return holder;
}