正式用 JSON 之前,先回顧一下 XML。XML 是「可擴充標記語言」的簡稱,提供了一套定義 Web 資料傳輸協定的方式,純文字、跨平台,曾被譽為「充分釋放 Internet 與 Web 潛力的理想途徑」。
但實務上,如果伺服器回傳的資料格式在傳輸過程中出了差錯,除錯往往很痛苦;改用 XML 又顯得笨重。所以很多時候,JSON 反而是更好的選擇。
舉例來說,我們需要用 AJAX 取得一組使用者資訊,包含 username、age、sex、address 等欄位。前端用 jQuery 可以寫成這樣:
function getUserInfo(id) {
if (isNaN(id)) { return; }
$.ajax({
type: "get",
url: "AjaxCommonClass.aspx?m=getUserInfoById&id=" + id,
dataType: "json",
success: function (data) {
$("#username").html(data.username);
$("#age").html(data.age);
$("#sex").html(data.sex);
$("#address").html(data.address);
}
});
}
這裡最關鍵的設定是 dataType: "json"。加上它之後,jQuery 會自動把回應字串解析成 JavaScript 物件,因此 success 回呼中的 data 已經是物件,可以直接用 data.username 取值,不必自己寫解析邏輯。
最原始的方式是手動拼字串,用 StringBuilder 的 Append() 逐段組裝。這麼做直覺但易錯,尤其處理引號轉義時特別容易出問題。
比較穩妥的做法是用 .NET Framework 3.0 以後內建的序列化機制,把物件直接轉成 JSON 字串:
public static string Serialize(object obj)
{
if (obj == null) return null;
System.Runtime.Serialization.Json.DataContractJsonSerializer s =
new System.Runtime.Serialization.Json.DataContractJsonSerializer(obj.GetType());
using (System.IO.MemoryStream ms = new System.IO.MemoryStream())
{
s.WriteObject(ms, obj);
return System.Text.Encoding.UTF8.GetString(ms.ToArray());
}
}
有了這個方法,後端只需 Response.Write(Serialize(obj)) 就能輸出 JSON;客戶端收到字串後會自動解析成 JavaScript 物件。
這裡有兩個實務提醒:一是輸出前務必設定 Response.ContentEncoding 與 ContentType(例如 application/json),否則前端可能無法正確辨識;二是若你的資料型別沒有標上 DataContract/DataMember 特性,序列化結果可能不如預期,這在換用不同序列化器時尤其常見。