`
xiaoyu966
  • 浏览: 258198 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

JSON介绍(从网上找了一些资料,总结制作了一个文档,不是原创呵呵)

阅读更多

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. 能够通过JavaScripteval()函数解析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 传输一个简单的 StringNumberBoolean,也可以传输一个数组,或者一个复杂的 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":"zhuleipro@hotmail.com"},

{"UserID":12, "Name":{"FirstName":"Jeffrey","LastName":"Richter"}, "Email":"xxxxxx.com"},

{"UserID":13, "Name":{"FirstName":"Scott","LastName":"Gu"}, "Email":"xxx2xxx2.com"}

]

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

 

如:

{"UserID":13, "Name":{"FirstName":"Scott","LastName":"Gu"}, "Email":"xxx2xxx2.com"}

 

4)字符串(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 的多态,我们可以处理 IntegerLongFloat 等多种 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();

 

 

分享到:
评论

相关推荐

    JSON文档 JSON手册

    JSON文档 JSON手册

    json api json帮助文档

    其中,Jackson是最为流行的,它支持JSON API规范的解析和生成,可以方便地将Java对象转换为JSON格式,并从JSON字符串还原Java对象。 在实际开发中,为了遵循JSON API规范,我们需要设计符合规范的模型类,这些类...

    json开发文档API

    JSON开发文档API是开发者在处理JSON数据时的重要参考资料,它提供了详细的API接口说明和使用方法。 JSON的核心结构包括对象和数组。对象是以大括号 `{}` 包裹的一系列键值对,键与值之间用冒号 `:` 分隔,多个键值...

    json.net离线文档

    JSON.NET是James Newton-King开发的一个流行的开源库,主要用于.NET框架中的JSON序列化和反序列化。这个离线文档包含了关于JSON.NET的详尽信息,帮助开发者在没有网络连接的情况下也能查阅相关API和功能。 JSON...

    PL/JSON(json_v1_0_4及中文文档)

    PL/JSON是一个在Oracle数据库中处理JSON数据的开源库,专为那些需要在数据库内进行JSON数据操作的应用程序设计。这个库提供了丰富的功能,包括JSON数据的解析、创建、修改和输出,使得与JSON格式的数据交互变得更加...

    java json文档和示例

    JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,它基于JavaScript的一个子集,易于人阅读和编写,同时也易于机器解析和生成。在Java中,处理JSON数据通常使用一些库,如Jackson、Gson、org.json等...

    json-path-2.6.0-API文档-中文版.zip

    赠送jar包:json-path-2.6.0.jar; 赠送原API文档:json-path-2.6.0-javadoc.jar; 赠送源代码:json-path-2.6.0-sources.jar; 赠送Maven依赖信息文件:json-path-2.6.0.pom; 包含翻译后的API文档:json-path-...

    APIJson文档(内含代码和文档)

    APIJSON 是一个开源的、基于 JSON 的自动化 API 框架,它允许开发者通过 JSON 请求直接获取数据库中的数据,无需编写任何服务器端的业务逻辑代码。这个框架的主要目标是简化前后端开发流程,提高开发效率,并确保...

    JSON API帮助文档 CHM

    JSON API 帮助文档 CHM

    json-20170516-API文档-中文版.zip

    赠送jar包:json-20170516.jar; 赠送原API文档:json-20170516-javadoc.jar; 赠送源代码:json-20170516-sources.jar; 赠送Maven依赖信息文件:json-20170516.pom; 包含翻译后的API文档:json-20170516-javadoc-...

    json-smart-2.3-API文档-中文版.zip

    赠送jar包:json-smart-2.3.jar; 赠送原API文档:json-smart-2.3-javadoc.jar; 赠送源代码:json-smart-2.3-sources.jar; 赠送Maven依赖信息文件:json-smart-2.3.pom; 包含翻译后的API文档:json-smart-2.3-...

    json-smart-2.4.7-API文档-中文版.zip

    赠送jar包:json-smart-2.4.7.jar; 赠送原API文档:json-smart-2.4.7-javadoc.jar; 赠送源代码:json-smart-2.4.7-sources.jar; 赠送Maven依赖信息文件:json-smart-2.4.7.pom; 包含翻译后的API文档:json-smart...

    json帮助文档

    在这个名为"json帮助文档"的压缩包中,你将找到关于如何使用JSON以及JSON API的相关资料,这将是你学习JSON的理想资源。 JSON格式的基本结构包含键值对,其语法与JavaScript对象相似。例如: ```json { "name": ...

    使用java代码生成json文件和word文档!

    总结,使用Java生成JSON文件和Word文档需要理解数据序列化(如JSON)的概念,以及使用相关库(如Jackson和Apache POI)提供的API。通过这些库,你可以轻松地将Java对象转换为可读的JSON格式,或创建结构化的Word文档...

    json-20160810-API文档-中文版.zip

    赠送jar包:json-20160810.jar; 赠送原API文档:json-20160810-javadoc.jar; 赠送源代码:json-20160810-sources.jar; 赠送Maven依赖信息文件:json-20160810.pom; 包含翻译后的API文档:json-20160810-javadoc-...

    json-20180813-API文档-中文版.zip

    赠送jar包:json-20180813.jar; 赠送原API文档:json-20180813-javadoc.jar; 赠送源代码:json-20180813-sources.jar; 赠送Maven依赖信息文件:json-20180813.pom; 包含翻译后的API文档:json-20180813-javadoc-...

    XML与JSON文档

    XML与JSON

    json-org jar包、源代码及其javadoc文档

    本共享文档包含的`org.json.jar`包就是这个库的实现,方便开发者在项目中集成和使用。 `org.json.jar`包的核心类包括`JSONObject`、`JSONArray`、`JSONString`、`JSONTokener`等。其中,`JSONObject`用于表示JSON中...

    oshi-json-3.4.2-API文档-中文版.zip

    赠送jar包:oshi-json-3.4.2.jar; 赠送原API文档:oshi-json-3.4.2-javadoc.jar; 赠送源代码:oshi-json-3.4.2-sources.jar; 赠送Maven依赖信息文件:oshi-json-3.4.2.pom; 包含翻译后的API文档:oshi-json-...

    json使用手册 帮助文档

    JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,它基于JavaScript的一个子集,易于人阅读和编写,同时也易于机器解析和生成。这个“json使用手册帮助文档”显然是为了指导用户如何有效地使用和理解...

Global site tag (gtag.js) - Google Analytics