提要:本文將說明如何以 AJAX 與 JSON 解析器,在客戶端與服務器之間建立複雜的 JSON 數據傳輸層。
毫無疑問,AJAX 已成為當今 Web 開發中強大的用戶互動技術,但它的許多應用可能仍鮮為人知。本文將共同探討如何以 JavaScript 物件標記(JSON)與 JSON 解析器,在服務器與客戶端 AJAX 引擎之間建立強有力的數據傳輸層——包括如何創建一組物件、如何把它們序列化為 JSON 送往服務端,以及如何把服務端的 JSON 反序列化為客戶端 JavaScript 物件。(提示:本文所用 JSON 解析器可在 Douglas Crockford 的網站找到。)本文假定你已掌握 JavaScript,並了解如何建立基本的 AJAX 引擎、發出請求與接收響應。
為進一步抽象 AJAX 請求並便於跨應用共享引擎代碼,本文使用了一個自建的 AJAX 引擎。只需導入三個 JavaScript 檔,並向 AjaxUpdater 物件發出請求,剩下的(包括把響應代理到指定的回調方法)便交給引擎處理:
<script type="text/javascript" src="Javascript/model/ajax.js"></script>
<script type="text/javascript" src="Javascript/model/http.js"></script>
<script type="text/javascript" src="Javascript/model/ajaxUpdater.js"></script>
<script type="text/javascript">
document.load = AjaxUpdater.Update('GET', URL, callback);
</script>
JavaScript 常被誤解為只能用來做客戶端的圖形效果,其實它是一種強大的語言——尤其在與 AJAX 及服務端結合時。即便在客戶端,它也能實現遠超預料的功能,面向物件就是一例:我們能創建物件、擴展內在物件,甚至把物件組織成「包」以便管理。本例將創建三個物件:Auto、Car 與 Wheel。
首先,Auto 被聲明為新物件,並作為 Car 的父類:
var Auto = new Object();
接著,Car 成為 Auto 的子物件(為便於管理而置於另一個檔中):
Auto.Car = new Object();
Auto.Car.color = "#fff";
Auto.Car.setColor = function(_color)
{
Auto.Car.color = _color;
}
Auto.Car.setColor("#333");
Car 有一個 color 屬性與一個設置它的方法;此處把 color 設為灰色以覆蓋缺省白色——序列化時請牢記這一點。再下一層的 Wheel 是 Car 的子物件:
Auto.Car.Wheel = new Object(); Auto.Car.Wheel.color = "#000";
Wheel 展示物件層級中又一個層次,其 color 缺省為黑色。
借助 JSON 解析器,可輕易把上述物件序列化為 JSON。先下載解析器並加入文檔:
<script type="text/javascript" src="Javascript/utils/jsonparser.js"></script>
最終導入的代碼片段如下:
<script type="text/javascript" src="Javascript/Auto.js"></script> <script type="text/javascript" src="Javascript/Car.js"></script> <script type="text/javascript" src="Javascript/Wheel.js"></script> <script type="text/javascript" src="Javascript/utils/jsonparser.js"></script> <script type="text/javascript" src="Javascript/model/ajax.js"></script> <script type="text/javascript" src="Javascript/model/http.js"></script> <script type="text/javascript" src="Javascript/model/ajaxUpdater.js"></script>
導入後,在 HTML 中加入兩個 div(ID 分別為 loading 與 body),前者由 AJAX 引擎用來指示進度,後者用於顯示訊息:
<div id="loading"></div> <div id="body"></div>
onload 事件對應 body 元素,把它的 innerHTML 設為序列化後的 JSON 字串。為此,在 Auto 物件上使用前一小節提到的 toJSONString 方法:
<body onload="document.getElementById('body').innerHTML = Auto.toJSONString();">
這段代碼使用 Auto 及其所有子物件,透過 JSON 解析器的 toJSONString 方法將它們序列化為 JSON 字串,供作為與服務端交換的數據格式。前面曾調用 setColor 改變 Car 的顏色,正是為了說明序列化能在運行時的任一點實現,並反映物件的最新數據。若仔細分析 onload 事件,會注意到 Car 與 Wheel 都包裹在方括號內——這些方括號代表父物件 Auto。這意味著序列化後的 JavaScript 物件能在運行時發往服務端存儲最新數據,也能在應用啟動時從服務端接收、從資料庫檢索當前數據;而整個過程的數據交換都可無縫地以 JSON 完成。
本文以一個靜態 JSON 檔作為響應,實際開發中則可把數據存於資料庫並以服務端語言返回。這個靜態檔正是上一節序列化的數據:
{"Car":{"color":"#333","Wheel":{"color":"#000"}}}
作為請求示例,點擊下列連結即請求這個序列化的 Auto 物件:
<a href="javascript:AjaxUpdater.Update('GET', 'json/data.js', displayResponse);">Get remote JSON</a>
收到響應後,displayResponse 回調方法被激活,我們便能反序列化並使用這些物件:
<script type="text/javascript">
function displayResponse()
{
if(Ajax.checkReadyState('loading') == "OK")
{
var Auto = Ajax.request.responseText.parseJSON();
document.getElementById("body").innerHTML += "<br/><b>Remote JSON unserialized</b>";
document.getElementById("body").innerHTML += "<br/>Car color: " + Auto.Car.color;
document.getElementById("body").innerHTML += "<br/>Wheel color: " + Auto.Car.Wheel.color;
}
}
</script>
這是相當精彩的一環:一旦取得 responseText,就能用 JSON 解析器的 parseJSON 方法從序列化數據中重建 Auto 物件,進而調用其子物件。這個特性讓我們能在服務器與客戶端之間來回傳送物件,而無需大量解析工作——相比標準 XML 響應,這無疑是一大躍進。如此一來,我們便能打造能基於 AJAX 保留自身狀態的客戶端 JavaScript 物件。