剛接觸 JSON 時上網找資料,發現多數文章寫到「怎麼產生 JSON」就結束了,完全沒說接下來前端要拿它做什麼。這裡記錄一次實戰的完整流程。
JSON(JavaScript Object Notation)是一種輕量級的資料交換格式。最簡單的形式就是名稱/值對:
{ "firstName": "Brett" }
本範例使用 Newtonsoft.Json 類別庫(Json.NET)來處理序列化與反序列化。
public static class JsonHelper<T>
{
/// <summary>序列化</summary>
public static string JsonWriter(T t)
{
return JsonConvert.SerializeObject(t, new IsoDateTimeConverter());
}
/// <summary>反序列化</summary>
public static T JsonReader(string serialize)
{
return JsonConvert.DeserializeObject<T>(serialize);
}
/// <summary>將 DataTable 轉成 JSON 格式</summary>
public static string JsonDataTable(DataTable dt)
{
StringBuilder sb = new StringBuilder();
sb.Append("{\"" + dt.TableName + "\":[");
for (int i = 0; i < dt.Rows.Count; i++)
{
sb.Append("{");
for (int j = 0; j < dt.Columns.Count; j++)
{
sb.Append("\"" + dt.Columns[j].ColumnName + "\":\"");
sb.Append(dt.Rows[i][j].ToString());
sb.Append("\",");
}
sb.Remove(sb.Length - 1, 1); // 移除多餘的逗號
sb.Append("},");
}
sb.Remove(sb.Length - 1, 1);
sb.Append("]}");
return sb.ToString();
}
}
需要留意的是,手寫字串拼接組出 JSON 雖然直觀,卻很脆弱:欄位值中若出現雙引號、換行或反斜線,就會產生無效的 JSON。正式環境請直接交給 JsonConvert.SerializeObject(dt),它會正確處理跳脫字元。
public void ProcessRequest(HttpContext context)
{
string get = context.Request.QueryString["p"];
if (null != get)
{
context.Response.ContentType = "application/json"; // 標明輸出的是 JSON
context.Response.Write(List(int.Parse(get)));
}
}
public bool IsReusable { get { return false; } }
private string List(int id)
{
C_USER us = new C_USERService().GetById(id);
return JsonHelper<C_USER>.JsonWriter(us);
}
<script src="script/jquery-1.4.2.min.js" type="text/javascript"></script>
<script type="text/javascript">
$(document).ready(function () {
$.ajax({
url: "Handler.ashx?p=1",
dataType: "json", // 告訴瀏覽器回傳的是 JSON
type: "GET",
success: function (json) {
alert(json.NAME);
}
});
});
</script>
一、版本不相容。使用 Json.NET 3.5 版時丟出 System.Runtime... 之類的異常,原因是環境中的 .NET Framework 3.5 是 SP1.0,缺少對應方法。解法是改用 Json.NET 2.0 版,或把 Framework 升級到較新的 Service Pack。
二、JSON 明明輸出了,前端卻讀不到。解法是在 ashx 中加上 context.Response.ContentType = "application/json";,或在前端 $.ajax() 中補上 dataType: "json"。兩邊任一处明確宣告格式,瀏覽器才知道該怎麼解析。
補充一點:範例寫的 "json/json" 並非標準 MIME 型別,正確寫法是 application/json。另外若伺服器回傳的 JSON 頂層是物件,前端要透過 dataType 讓 jQuery 自動解析成物件;若沒設,就得自己 JSON.parse()。