學 JSON 學了一段時間,累積了一些心得,這篇就把其中最容易卡住人的環節整理出來:當你試著把物件序列化成 JSON 字串時,會遇到的編譯警告與解法。
情境是這樣的:程式寫完、編譯通過,卻冒出兩個警告。對在意程式碼品質的人來說,這種警告非查清楚不可。警告內容是:
'System.Web.Script.Serialization.JavaScriptSerializer.JavaScriptSerializer()' 已過時: "The recommended alternative is System.Runtime.Serialization.DataContractJsonSerializer."
翻譯一下:微軟建議改用 DataContractJsonSerializer。
這個警告的由來不難理解。早期 ASP.NET AJAX 提供了 System.Web.Script.Serialization 命名空間下的 JavaScriptSerializer,它使用方便,但屬於 AJAX 框架的附屬產物。隨著 WCF 的 DataContractJsonSerializer 成為框架內建的序列化機制,前者就被標記為過時。
過去的經驗告訴我這類問題通常換個 API 就好——當初學 ASP.NET 用 AppSettings 時也遇過類似警告,改用 ConfigurationManager 便解決了。但這次沒那麼順利:MSDN 查不出頭緒,論壇也沒答案,直接換成 DataContractJsonSerializer 之後,補上 System.Runtime.Serialization 的引用,編譯還是不通過。
最後找到一份可用的範例,才明白問題出在引用不完整。完整步驟如下。
第一步,加入兩個組件引用:
System.Runtime.Serialization.dllSystem.ServiceModel.Web.dll第二步,在程式碼頁加入 using 宣告。注意這裡用到的是 System.Runtime.Serialization.Json(而非 System.Web.Script.Serialization):
using System; using System.IO; using System.Runtime.Serialization.Json;
為什麼需要 System.IO?因為 DataContractJsonSerializer 的 WriteObject/ReadObject 都是對 Stream 操作,實作時會用到 MemoryStream 之類的型別,所以這個命名空間不能省。
換言之,這類「已過時」警告往往不是單純的 API 改名,背後牽涉到整組依賴的替換。遇到時別急著猜,把替代類別所在的完整命名空間與對應組件一次查清楚,反而更快。