JSON用法介绍

定义和优点 
   JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于JavaScript Programming Language, Standard ECMA-262 3rd Edition - December 1999的一个子集。 JSON采用完全独立于语言的文本格式，但是也使用了类似于C语言家族的习惯（包括C, C++, C#, Java, JavaScript, Perl, Python等）。这些特性使JSON成为理想的数据交换语言。
    尽管有许多宣传关于 XML 如何拥有跨平台，跨语言的优势，然而，除非应用于 Web Services，否则，在普通的 Web 应用中，开发者经常为 XML 的解析伤透了脑筋，无论是服务器端生成或处理 XML，还是客户端用 JavaScript 解析 XML，都常常导致复杂的代码，极低的开发效率。实际上，对于大多数 Web 应用来说，他们根本不需要复杂的 XML 来传输数据，XML 的扩展性很少具有优势，许多 AJAX 应用甚至直接返回 HTML 片段来构建动态 Web 页面。和返回 XML 并解析它相比，返回 HTML 片段大大降低了系统的复杂性，但同时缺少了一定的灵活性。

     现在， JSON 为 Web 应用开发者提供了另一种数据交换格式。让我们来看看 JSON 到底是什么，同 XML 或 HTML 片段相比，JSON 提供了更好的简单性和灵活性。
JSON的优点

1.轻量级的数据交换格式
2.人们读写更加容易
3.易于机器的解析和生成
4.能够通过JavaScript中eval()函数解析JSON
5.JSON支持多语言。包括：ActionScript, C, C#, ColdFusion, E, Java, JavaScript, ML, Objective CAML, Perl, PHP, Python, Rebol, Ruby, and Lua.

JSON 数据格式解析

   和 XML 一样，JSON 也是基于纯文本的数据格式。由于 JSON 天生是为 JavaScript 准备的，因此，JSON 的数据格式非常简单，您可以用 JSON 传输一个简单的 String，Number，Boolean，也可以传输一个数组，或者一个复杂的 Object 对象。


JSON建构于两种结构：
•“名称/值”对的集合（A collection of name/value pairs）。不同的语言中，它被理解为对象（object），纪录（record），结构（struct），字典（dictionary），哈希表（hash table），有键列表（keyed list），或者关联数组 （associative array）。
•值的有序列表（An ordered list of values）。在大部分语言中，它被理解为数组（array）。
这些都是常见的数据结构。事实上大部分现代计算机语言都以某种形式支持它们。这使得一种数据格式在同样基于这些结构的编程语言之间交换成为可能。

JSON具有以下这些形式：

1）对象是一个无序的“‘名称/值’对”集合。一个对象以“{”（左括号）开始，“}”（右括号）结束。每个“名称”后跟一个“:”（冒号）；“‘名称/值’ 对”之间使用“,”（逗号）分隔。
如：

{"city":"Beijing","street":" Chaoyang Road ","postcode":100025}


2）数组是值（value）的有序集合。一个数组以“[”（左中括号）开始，“]”（右中括号）结束。值之间使用“,”（逗号）分隔。
如：

[
{"UserID":11, "Name":{"FirstName":"Truly","LastName":"Zhu"}, "Email":"[e-mail]"},
{"UserID":12, "Name":{"FirstName":"Jeffrey","LastName":"Richter"}, "Email":"xxx◎xxx.com"},
{"UserID":13, "Name":{"FirstName":"Scott","LastName":"Gu"}, "Email":"xxx2◎xxx2.com"}
]

3）值（value）可以是双引号括起来的字符串（string）、数值(number)、true、false、 null、对象（object）或者数组（array）。这些结构可以嵌套。


如：

{"UserID":13, "Name":{"FirstName":"Scott","LastName":"Gu"}, "Email":"xxx2◎xxx2.com"}
  字符串（string）是由双引号包围的任意数量Unicode字符的集合，使用反斜线转义。一个字符（character）即一个单独的字符串（character string）。

字符串（string）与C或者Java的字符串非常相似。


5）数值（number）也与C或者Java的数值非常相似。除去未曾使用的八进制与十六进制格式。除去一些编码细节。


如：

这与绝大多数编程语言的表示方法一致，例如：{12345，-12345}

JavaScript 处理 JSON 数据


   上面介绍了如何用 JSON 表示数据，接下来，我们还要解决如何在服务器端生成 JSON 格式的数据以便发送到客户端，以及客户端如何使用 JavaScript 处理 JSON 格式的数据。

我们先讨论如何在 Web 页面中用 JavaScript 处理 JSON 数据。我们通过一个简单的 JavaScript 方法就能看到客户端如何将 JSON 数据表示给用户：

function handleJson() {
  var j={"name":"Michael","address":      {"city":"Beijing","street":" Chaoyang Road ","postcode":100025}  };   document.write(j.name); 
document.write(j.address.city);
}

假定服务器返回的 JSON 数据是上文的：

{"name":"Michael","address":

    {"city":"Beijing","street":" Chaoyang Road ","postcode":100025}

}
   只需将其赋值给一个 JavaScript 变量，就可以立刻使用该变量并更新页面中的信息了，相比 XML 需要从 DOM 中读取各种节点而言，JSON 的使用非常容易。我们需要做的仅仅是发送一个 Ajax 请求，然后将服务器返回的 JSON 数据赋值给一个变量即可。有许多 Ajax 框架早已包含了处理 JSON 数据的能力，例如 Prototype（一个流行的 JavaScript 库：http://prototypejs.org）提供了 evalJSON() 方法，能直接将服务器返回的 JSON 文本变成一个 JavaScript 变量：


new Ajax.Request("http://url", {

  method: "get",

  onSuccess: function(transport) {

    var json = transport.responseText.evalJSON();

    // TODO: document.write(json.xxx);

  }

});

服务器端输出 JSON 格式数据

下面我们讨论如何在服务器端输出 JSON 格式的数据。以 Java 为例，我们将演示将一个 Java 对象编码为 JSON 格式的文本。

将 String 对象编码为 JSON 格式时，只需处理好特殊字符即可。另外，必须用 (") 而非 (') 表示字符串：

static String string2Json(String s) {

    StringBuilder sb = new StringBuilder(s.length()+20);

    sb.append('\"');

    for (int i=0; i<s.length(); i++) {

        char c = s.charAt(i);

        switch (c) {

        case '\"':

            sb.append("\\\"");

            break;

        case '\\':

            sb.append("\\\\");

            break;

        case '/':

            sb.append("\\/");

            break;

        case '\b':

            sb.append("\\b");

            break;

        case '\f':

            sb.append("\\f");

            break;

        case '\n':

            sb.append("\\n");

            break;

        case '\r':

            sb.append("\\r");

            break;

        case '\t':

            sb.append("\\t");

            break;

        default:

            sb.append(c);

        }

    }

    sb.append('\"');

    return sb.toString();

}




将 Number 表示为 JSON 就容易得多，利用 Java 的多态，我们可以处理 Integer，Long，Float 等多种 Number 格式：


static String number2Json(Number number) {

    return number.toString();

}





Boolean 类型也可以直接通过 toString() 方法得到 JSON 的表示：


static String boolean2Json(Boolean bool) {

    return bool.toString();

}






要将数组编码为 JSON 格式，可以通过循环将每一个元素编码出来：


static String array2Json(Object[] array) {

    if (array.length==0)

        return "[]";

    StringBuilder sb = new StringBuilder(array.length << 4);

    sb.append('[');

    for (Object o : array) {

        sb.append(toJson(o));

        sb.append(',');

    }

    // 将最后添加的 ',' 变为 ']':

    sb.setCharAt(sb.length()-1, ']');

    return sb.toString();

}





最后，我们需要将 Map<String, Object> 编码为 JSON 格式，因为 JavaScript 的 Object 实际上对应的是 Java 的 Map<String, Object> 。该方法如下：


static String map2Json(Map<String, Object> map) {

    if (map.isEmpty())

        return "{}";

    StringBuilder sb = new StringBuilder(map.size() << 4);

    sb.append('{');

    Set<String> keys = map.keySet();

    for (String key : keys) {

        Object value = map.get(key);

        sb.append('\"');

        sb.append(key);

        sb.append('\"');

        sb.append(':');

        sb.append(toJson(value));

        sb.append(',');

    }

    // 将最后的 ',' 变为 '}':

    sb.setCharAt(sb.length()-1, '}');

    return sb.toString();

}






为了统一处理任意的 Java 对象，我们编写一个入口方法 toJson(Object)，能够将任意的 Java 对象编码为 JSON 格式：


public static String toJson(Object o) {

    if (o==null)

        return "null";

    if (o instanceof String)

        return string2Json((String)o);

    if (o instanceof Boolean)

        return boolean2Json((Boolean)o);

    if (o instanceof Number)

        return number2Json((Number)o);

    if (o instanceof Map)

        return map2Json((Map<String, Object>)o);

    if (o instanceof Object[])

        return array2Json((Object[])o);

    throw new RuntimeException("Unsupported type: " + o.getClass().getName());

}






我们并未对 Java 对象作严格的检查。不被支持的对象（例如 List）将直接抛出 RuntimeException 。此外，为了保证输出的 JSON 是有效的，Map<String, Object> 对象的 Key 也不能包含特殊字符。细心的读者可能还会发现循环引用的对象会引发无限递归，例如，精心构造一个循环引用的 Map，就可以检测到 StackOverflowException：


@Test(expected=StackOverflowError.class)

public void testRecurrsiveMap2Json() {

    Map<String, Object> map = new HashMap<String, Object>();

    map.put("key", map);

    JsonUtil.map2Json(map);

}






好在服务器处理的 JSON 数据最终都应该转化为简单的 JavaScript 对象，因此，递归引用的可能性很小。

最后，通过 Servlet 或 MVC 框架输出 JSON 时，需要设置正确的 MIME 类型（application/json）和字符编码。假定服务器使用 UTF-8 编码，则可以使用以下代码输出编码后的 JSON 文本：


response.setContentType("application/json;charset=UTF-8");

response.setCharacterEncoding("UTF-8");

PrintWriter pw = response.getWriter();

pw.write(JsonUtil.toJson(obj));

pw.flush();