在 iOS 開發中,Model 層幾乎是每個專案都會遇到的部分。常見的 JSON 轉 Model 方案包括 JSONModel、Mantle 與 MJExtension。這類庫的核心流程通常相似:先透過 Runtime 取得屬性資訊,再建立物件,最後利用 KVC 或類似機制完成賦值。
Mantle 的特別之處在於,它不仅處理 JSON 與 Model 的轉換,也為繼承自 MTLModel 的物件自動實作 NSCopying、NSCoding、isEqual 與 hash 等方法,讓 Model 物件在複製、比較與序列化上更一致。
Mantle 會利用 Objective-C Runtime 取得類別的屬性列表。class_copyPropertyList 只能取得目前類別的屬性,因此若要取得包含父類別在內的完整屬性,需要沿著 superclass 鏈向上遍歷。
Class cls = Demo.class;
while (cls != NSObject.class) {
// 取得目前類別的屬性列表,並逐一處理
cls = cls.superclass;
}
取得屬性名稱後,Mantle 還會進一步解析屬性的 attributes。property_getAttributes 會回傳編碼後的字串,例如型別、記憶體管理特性與是否唯讀等,這些資訊會被整理成結構體,供後續轉換使用。
以 MTLJSONAdapter 的 modelOfClass:fromJSONDictionary:error: 為例,流程大致可分為兩個階段。第一階段是建立 adapter,並整理 Model 的屬性對應與值轉換器;第二階段則是實際解析 JSON,取得每個屬性對應的值,最後透過 KVC 設定到物件上。
在建立 adapter 時,Mantle 會先檢查 Model 是否遵循 MTLJSONSerializing,再讀取 JSONKeyPathsByPropertyKey,取得屬性名稱與 JSON key 的映射。若映射不合法,會直接觸發斷言,幫助開發者及早發現問題。
接著,Mantle 會收集每個屬性對應的 NSValueTransformer。常見做法是讓 Model 實作「屬性名 + JSONTransformer」形式的方法,例如 nameJSONTransformer,讓 Mantle 能動態找到對應的轉換器。
NSValueTransformer 是 Cocoa 中用來進行值轉換的抽象類別。實作時通常需要提供 transformedValueClass、allowsReverseTransformation,以及 transformedValue 與 reverseTransformedValue 等方法。
Mantle 的 MTLValueTransformer 在此基礎上進一步封裝,讓開發者可以用 block 的方式定義正向與反向轉換,例如將伺服器返回的時間字串轉成 NSDate,或在送出資料時反向轉回字串。
MTLModel 會根據 Runtime 取得的屬性,自動實作 isEqual 與 hash。比較物件時,會逐一比較各屬性的值;計算 hash 時,則會將各屬性的 hash 值合併。NSCopying 則是建立同類別物件,並透過 KVC 複製屬性值。
NSCoding 的支援稍微複雜一些。Mantle 在 encodeWithCoder 與 initWithCoder 中,會判斷屬性是否為 MTLModel。若是,則交由 MTLModel 的編碼方法處理;若不是,則直接以屬性名稱作為 key 進行編解碼。
Mantle 在除錯模式與正式模式下的行為不同。Debug 模式下遇到問題時會拋出例外,方便開發者定位;Release 模式則會避免直接崩潰。這種設計讓框架在開發階段更嚴格,在正式環境中更穩定。
整體而言,Mantle 的價值不只是 JSON 轉 Model,而是把 Runtime、KVC、值轉換與物件協議整合成一套一致且可擴充的 Model 解決方案。