现在, json 为 web 应用开发者提供了另一种数据交换格式。让我们来看看 json 到底是什么,同 xml 或 html 片段相比,json 提供了更好的简单性和灵活性。
ajax 资源中心
请访问 ajax 资源中心,这是有关 ajax 编程模型信息的一站式中心,包括很多文档、教程、论坛、blog、wiki 和新闻。任何 ajax 的新信息都能在这里找到。
json 数据格式解析
和 xml 一样,json 也是基于纯文本的数据格式。由于 json 天生是为 javascript 准备的,因此,json 的数据格式非常简单,您可以用 json 传输一个简单的 string,number,boolean,也可以传输一个数组,或者一个复杂的 object 对象。
string,number 和 boolean 用 json 表示非常简单。例如,用 json 表示一个简单的 string “ abc ”,其格式为:
abc
除了字符 ,,/ 和一些控制符(,f,, , )需要编码外,其他 unicode 字符可以直接输出。下图是一个 string 的完整表示结构:
图 1. string 的完整表示结构
一个 number 可以根据整型或浮点数表示如下:
图 2. number 的表示结构
这与绝大多数编程语言的表示方法一致,例如:
12345(整数)
-3.9e10(浮点数)
boolean 类型表示为 true 或 false 。此外,javascript 中的 null 被表示为 null,注意,true、false 和 null 都没有双引号,否则将被视为一个 string 。
json 还可以表示一个数组对象,使用 [] 包含所有元素,每个元素用逗号分隔,元素可以是任意的 value,例如,以下数组包含了一个 string,number,boolean 和一个 null:
[abc,12345,false,null]
object 对象在 json 中是用 {} 包含一系列无序的 key-value 键值对表示的,实际上此处的 object 相当于 java 中的 map,而不是 java 的 class 。注意 key 只能用 string 表示。
例如,一个 address 对象包含如下 key-value:
city:beijing
street:chaoyang road
postcode:100025(整数)
用 json 表示如下:
{city:beijing,street: chaoyang road ,postcode:100025}
其中 value 也可以是另一个 object 或者数组,因此,复杂的 object 可以嵌套表示,例如,一个 person 对象包含 name 和 address 对象,可以表示如下:
{name:michael,address:
{city:beijing,street: chaoyang road ,postcode:100025}
}
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; ichar 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 sb.append('[');
for (object o : array) {
sb.append(tojson(o));
sb.append(',');
}
// 将最后添加的 ',' 变为 ']':
sb.setcharat(sb.length()-1, ']');
return sb.tostring();
}
最后,我们需要将 map 编码为 json 格式,因为 javascript 的 object 实际上对应的是 java 的 map 。该方法如下:
复制代码 代码如下:
static string map2json(map map) {
if (map.isempty())
return {};
stringbuilder sb = new stringbuilder(map.size() sb.append('{');
set 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)o);
if (o instanceof object[])
return array2json((object[])o);
throw new runtimeexception(unsupported type: + o.getclass().getname());
}
我们并未对 java 对象作严格的检查。不被支持的对象(例如 list)将直接抛出 runtimeexception 。此外,为了保证输出的 json 是有效的,map 对象的 key 也不能包含特殊字符。细心的读者可能还会发现循环引用的对象会引发无限递归,例如,精心构造一个循环引用的 map,就可以检测到 stackoverflowexception:
复制代码 代码如下:
@test(expected=stackoverflowerror.class)
public void testrecurrsivemap2json() {
map map = new hashmap();
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 已经是 javascript 标准的一部分。目前,主流的浏览器对 json 支持都非常完善。应用 json,我们可以从 xml 的解析中摆脱出来,对那些应用 ajax 的 web 2.0 网站来说,json 确实是目前最灵活的轻量级方案。
