📄 json 入门指南.htm
字号:
的表示结构 </B></A><BR><IMG alt=" 图 2. Number 的表示结构 "
src="JSON 入门指南.files/fig002.jpg"> <BR>
<P>这与绝大多数编程语言的表示方法一致,例如:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>12345(整数)
-3.9e10(浮点数)</PRE></TD></TR></TBODY></TABLE><BR>
<P>Boolean 类型表示为 <CODE>true</CODE> 或 <CODE>false</CODE>
。此外,JavaScript 中的 null 被表示为
<CODE>null</CODE>,注意,<CODE>true</CODE>、<CODE>false</CODE> 和
<CODE>null</CODE> 都没有双引号,否则将被视为一个 String 。 </P>
<P>JSON 还可以表示一个数组对象,使用 <CODE>[]</CODE> 包含所有元素,每个元素用逗号分隔,元素可以是任意的
Value,例如,以下数组包含了一个 String,Number,Boolean 和一个 null:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>["abc",12345,false,null]</PRE></TD></TR></TBODY></TABLE><BR>
<P>Object 对象在 JSON 中是用 <CODE>{}</CODE> 包含一系列无序的 Key-Value
键值对表示的,实际上此处的 Object 相当于 Java 中的 <CODE>Map<String,
Object></CODE>,而不是 Java 的 Class 。注意 Key 只能用 String 表示。 </P>
<P>例如,一个 Address 对象包含如下 Key-Value:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>city:Beijing
street:Chaoyang Road
postcode:100025(整数)</PRE></TD></TR></TBODY></TABLE><BR>
<P>用 JSON 表示如下:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>{"city":"Beijing","street":" Chaoyang Road ","postcode":100025}</PRE></TD></TR></TBODY></TABLE><BR>
<P>其中 Value 也可以是另一个 Object 或者数组,因此,复杂的 Object 可以嵌套表示,例如,一个 Person
对象包含 name 和 address 对象,可以表示如下:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>{"name":"Michael","address":
{"city":"Beijing","street":" Chaoyang Road ","postcode":100025}
}</PRE></TD></TR></TBODY></TABLE><BR>
<P><A name=N1010D><SPAN class=atitle>JavaScript 处理 JSON 数据
</SPAN></A></P>
<P>上面介绍了如何用 JSON 表示数据,接下来,我们还要解决如何在服务器端生成 JSON
格式的数据以便发送到客户端,以及客户端如何使用 JavaScript 处理 JSON 格式的数据。 </P>
<P>我们先讨论如何在 Web 页面中用 JavaScript 处理 JSON 数据。我们通过一个简单的 JavaScript
方法就能看到客户端如何将 JSON 数据表示给用户:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>function handleJson() {
var j={"name":"Michael","address":
{"city":"Beijing","street":" Chaoyang Road ","postcode":100025}
};
document.write(j.name);
document.write(j.address.city);
}</PRE></TD></TR></TBODY></TABLE><BR>
<P>假定服务器返回的 JSON 数据是上文的:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>{"name":"Michael","address":
{"city":"Beijing","street":" Chaoyang Road ","postcode":100025}
}</PRE></TD></TR></TBODY></TABLE><BR>
<P>只需将其赋值给一个 JavaScript 变量,就可以立刻使用该变量并更新页面中的信息了,相比 XML 需要从 DOM
中读取各种节点而言,JSON 的使用非常容易。我们需要做的仅仅是发送一个 Ajax 请求,然后将服务器返回的 JSON
数据赋值给一个变量即可。有许多 Ajax 框架早已包含了处理 JSON 数据的能力,例如 Prototype(一个流行的
JavaScript 库:http://prototypejs.org)提供了 <CODE>evalJSON()</CODE>
方法,能直接将服务器返回的 JSON 文本变成一个 JavaScript 变量:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>new Ajax.Request("http://url", {
method: "get",
onSuccess: function(transport) {
var json = transport.responseText.evalJSON();
// TODO: document.write(json.xxx);
}
});</PRE></TD></TR></TBODY></TABLE><BR>
<P><A name=N1012F><SPAN class=atitle>服务器端输出 JSON 格式数据
</SPAN></A></P>
<P>下面我们讨论如何在服务器端输出 JSON 格式的数据。以 Java 为例,我们将演示将一个 Java 对象编码为 JSON
格式的文本。 </P>
<P>将 String 对象编码为 JSON 格式时,只需处理好特殊字符即可。另外,必须用 (<CODE>"</CODE>) 而非
(<CODE>'</CODE>) 表示字符串:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>
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();
}
</PRE></TD></TR></TBODY></TABLE><BR>
<P>将 Number 表示为 JSON 就容易得多,利用 Java 的多态,我们可以处理 Integer,Long,Float 等多种
Number 格式:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>
static String number2Json(Number number) {
return number.toString();
}
</PRE></TD></TR></TBODY></TABLE><BR>
<P>Boolean 类型也可以直接通过 <CODE>toString()</CODE> 方法得到 JSON 的表示:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>
static String boolean2Json(Boolean bool) {
return bool.toString();
}
</PRE></TD></TR></TBODY></TABLE><BR>
<P>要将数组编码为 JSON 格式,可以通过循环将每一个元素编码出来:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>
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();
}
</PRE></TD></TR></TBODY></TABLE><BR>
<P>最后,我们需要将 <CODE>Map<String, Object></CODE> 编码为 JSON 格式,因为
JavaScript 的 Object 实际上对应的是 Java 的 <CODE>Map<String, Object>
</CODE>。该方法如下:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>
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();
}
</PRE></TD></TR></TBODY></TABLE><BR>
<P>为了统一处理任意的 Java 对象,我们编写一个入口方法 <CODE>toJson(Object)</CODE>,能够将任意的
Java 对象编码为 JSON 格式:</P>
<TABLE cellSpacing=0 cellPadding=0 width="100%" border=0>
<TBODY>
<TR>
<TD class=code-outline><PRE class=displaycode>
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());
}
</PRE></TD></TR></TBODY></TABLE><BR>
<P>我们并未对 Java 对象作严格的检查。不被支持的对象(例如 List)将直接抛出 RuntimeException
。此外,为了保证输出的 JSON 是有效的,<CODE>Map<String, Object></CODE> 对象的 Key
也不能包含特殊字符。细心的读者可能还会发现循环引用的对象会引发无限递归,例如,精心构造一个循环引用的 Map,就可以检测到
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -