公司專案早期的 model 層,是我用 JSON 工具直接產生 Objective-C 程式碼,當時覺得相當省事,畢竟我經歷過沒有 model 層、只用 NSDictionary 的「黑暗時期」。但隨著專案推進,問題逐漸浮現。
後來在 ObjC.io 看到 Mantle,花時間研究後決定在分支上全面改用。使用一段時間後,性能沒有瓶頸,穩定性也可接受,之後更整合了 Mantle、MK 與 RAC 於網路請求。但我也逐漸發現 Mantle 雖好,卻不是萬能的。
一、工具生成 model。優點:簡單易用、有一定容錯、程式碼工整、生成快速。缺點:類名與屬性名常需手動修改且繁瑣、程式碼冗長、欄位變動時修改麻煩、繼承關係仍需自行處理。
二、基於執行時的 model(如 Mantle)。優點:減少大量樣板程式碼、修改欄位映射簡便、易擴展、可處理複雜映射與數值轉換、已實作 NSCopying 與 NSCoding 便於序列化。缺點:基於執行時映射對性能有一定影響、部分容錯需自行處理、框架程式碼不少。
三、NSDictionary 型 model。優點:無需基礎、容錯性較高、適應任何資料結構。缺點:維護成本高、編譯器無法檢查拼寫、除錯麻煩。它仍有其用途,但多數情況還是需要合理的 model 來保證專案的健壯性與開發效率。
當 controller 日益臃腫、model 越來越輕時,把 model 這層做好,就能減輕 controller 的複雜度。一個只有 NSDictionary、沒有真正 model 的商業應用,非常不利於維護。
1. null 值:若屬性為基本數值類型,而 JSON 回傳 null,Mantle 產生 model 時會崩潰。解法是在 model 中實作 setNilValueForKey:,建議透過基底類別繼承一次解決所有 model 的問題。
2. 鍵值的合理映射:對於巢狀的 JSON,不必為每層都建立新 model,可用點語法映射:
+ (NSDictionary *)JSONKeyPathsByPropertyKey
{
return @{@"accessToken": @"result.access_token",
@"userId": @"result.user_id"};
}
屬性名與 JSON 鍵名一致時可省略不寫映射。
3. 值的類型問題:這是最棘手的。JSON 數值類型與文件不符乃家常便飯。常見異常包含:屬性為 BOOL 但回傳 string、屬性為 NSString 但回傳 number(Mantle 只會轉出 NSNumber,呼叫 length 等 NSString 專用方法時就會出問題)、使用巢狀映射但回傳值非 object、屬性為 NSArray 但回傳 object 等。所幸 Mantle 已幫忙處理了部分情況,僅在除錯模式拋出異常,Release 時不會崩潰。
由於 JSON 實質上只有 string、number、object、array 四種(對應 NSString、NSNumber、NSDictionary、NSArray),因此規避類型問題也從這幾個類著手。number 與 string 的錯誤最常見也最隱蔽,為此可撰寫一個 category(如 AvoidMTLModelCrash)來解決 NSString 與 NSNumber 的崩潰問題。
若某些介面回傳陣列,但只需第一個元素,可用 MTLValueTransformer 直接映射出來:
+ (NSValueTransformer *)pointListJSONTransformer
{
return [MTLValueTransformer transformerWithBlock:^id(NSArray *array) {
return [array firstObject];
}];
}
此外,MTLJSONSerializing 協定還提供 classForParsingJSONDictionary,可改變解析後產生的類別。例如 B、C 皆繼承 A,就能透過此方法依資料選擇不同的子類產生物件,而對外仍暴露 A 的介面,概念類似 NSArray。