做 iOS 開發,幾乎每個專案都會用到 JSON 與 Model 的互轉。本文從效能、容錯性、功能與侵入性四個維度,對常見的幾個開源方案做一次橫向比較。
所有庫代碼更新至 2015-09-18,以 Release 配置編譯,運行於 iPhone 6。
用例一:GithubUser。取自 GitHub API 的一條使用者資料,去掉 NSDate 屬性後共 30 行,多數是字串、少量數字,用來測最基礎的屬性映射。每輪執行 10000 次。
用例二:WeiboStatus。從官方微博客戶端抓取的一條完整微博資料,高達 580 行,包含大量嵌套物件、容器物件、型別轉換與日期解析,用來測複雜場景。每輪執行 1000 次。
結論很清晰:
補充兩點:FastEasyMapping 不支援 NSCoding,因此無法參與 Archive 測試;MJExtension 在把複雜物件轉回 JSON 時存在錯誤。此外也測過 ObjectMapper、JSONHelper、ModelRocket 等 Swift 方案,效能比 Mantle 還差不少,這裡不另做對比。
這一項測的是:在預設配置下,當 JSON 的型別與 Model 屬性不匹配時,框架會給出錯誤結果,還是直接崩潰。
| 場景 | YYModel | FastEasyMapping | JSONModel | Mantle | MJExtension |
|---|---|---|---|---|---|
| JSON 為 number,Model 為 NSString | ✅ NSString | 🚫 NSString | ✅ NSNumber | ✅ NSString | ⚠️ 屬性為 nil |
| JSON 為 "100",Model 為 int | ✅ 100 | 🚫 Crash | 🚫 Crash | ⚠️ 屬性為 nil | ✅ 100 |
| JSON 為 "2009-04-02T03:35:22Z",Model 為 NSDate | ✅ NSDate | 🚫 NSString | ✅ NSDate | ⚠️ 屬性為 nil | 🚫 NSString |
| JSON 為字串,Model 為 NSValue | ✅ 為 nil | 🚫 NSString | 🚫 Crash | ⚠️ 屬性為 nil | 🚫 NSString |
YYModel 與 Mantle 都會做型別檢查,避免把錯誤型別的物件塞進屬性。差別在策略:YYModel 會嘗試自動轉換,失敗就留空;Mantle 遇到不匹配直接把錯誤向上拋,中止整個轉換流程——這樣調試起來反而更直觀。
MJExtension 只對部分型別(如 NSString 與 NSNumber 之間)做自動轉換,轉不了就把原始 JSON 物件硬塞給型別不符的屬性,後續使用時埋下崩潰隱患。
JSONModel 完全沒有型別檢測,也沒有保護機制,一旦異常就是整個 App 崩潰,風險最高。FastEasyMapping 的表現 similarly 不理想:沒有自動轉換機制,型別不匹配時會造成錯誤賦值甚至直接 Crash。
| 功能 | YYModel | FastEasyMapping | JSONModel | Mantle | MJExtension |
|---|---|---|---|---|---|
| 同名屬性自動映射 | ✅ | 🚫 | ✅ | ✅ | ✅ |
| 自訂屬性轉換方式 | 🚫 | ✅ | 🚫 | ✅ | 🚫 |
| NSCoding | ✅ | 🚫 | ✅ | ✅ | ✅ |
| hash/equal | ✅ | 🚫 | ✅ | ✅ | 🚫 |
| CoreData | 🚫 | ✅ | 🚫 | ✅ | ✅ |
Mantle 可定製性最高、功能最完整;YYModel、JSONModel、MJExtension 上手簡單,但功能相對弱一些;FastEasyMapping 功能最少,用起来也不算順手。
Mantle 與 JSONModel 要求 Model 繼承指定基底類,靈活性受限,但換來更豐富的能力。YYModel 與 MJExtension 走 Category 路線,無侵入、更靈活;不過要注意 MJExtension 為 NSObject/NSString 添加了大量沒有前綴且命名通用的方法,在真實專案裡極易與其他類撞名。FastEasyMapping 用工具類實現轉換,最為靈活,但使用體驗最不方便。
要穩定且功能完整的方案,選 Mantle,唯一短板是效能。功能要求不高但很在意效能,可以試試 YYModel。
JSONModel 缺少型別檢測,潛在風險大,不推薦;MJExtension 同樣缺少部分必要的型別檢查,還會帶來大量 Category 命名污染,也不推薦。幾個 Swift 生態的庫效能普遍偏差,非 Swift 專案不必考慮。