您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

JSONModel 源碼解析:它如何把字典自動變成模型

編輯:iOS 開發基礎

為什麼要讀源碼

很多時候,我們寫的代碼還不夠好,所以需要閱讀優秀源碼。一個在 GitHub 上獲得大量關注的開源庫,通常經歷過很多真實項目驗證,也處理過大量邊界問題。閱讀這類源碼,能讓我們理解更穩健的設計思路。

先看文件結構

打開 JSONModel 項目,可以看到幾個主要 group:

JSONModel 是庫的主體;JSONModelCategories 放的是分類;JSONModelNetworking 可能包含網絡相關封裝;JSONModelTransformations 則負責類型轉換相關能力。

初看之下,這個庫似乎把很多常見需求都考慮到了,包括網絡、分類與轉換。但如果只是做 JSON 解析,最關鍵的仍然要回到核心模型部分。

從 Demo 入手

項目裡有一個 GitHubDemo。這類非 UI 庫的 Demo 通常很直接,重點在於展示核心 API 如何使用。

打開 GitHubUserModel.h,可以看到一些屬性,例如 login、html_url、company、name、blog 等。

值得注意的是,其中有些屬性并不是字符串,而是 NSURL 類型。奇怪的是,.m 文件里幾乎沒有額外代碼,也沒有傳統意義上的 mapping。那它如何把服務器返回的字符串轉成 NSURL?這正是 JSONModel 值得研究的地方。

initWithDictionary 做了什麼

在 Demo 中,網絡請求完成後,會把 JSON 數據轉成字典,然後調用 initWithDictionary:error:。這個初始化方法大致包含幾個步驟:

  • 檢查傳入的字典是否為空
  • 檢查對象是否為 NSDictionary 類型
  • 創建自身實例
  • 驗證字典結構是否匹配模型
  • 把字典中的值導入模型屬性
  • 執行自定義驗證
  • 返回初始化完成的對象

從注釋和代碼結構看,這個過程并不神秘。真正的關鍵在於它如何獲取模型屬性,以及如何完成賦值。

Runtime 與關聯對象

Objective-C 的 runtime 提供了強大的自省能力。JSONModel 需要知道一個模型類有哪些屬性,才能把字典裡的鍵值對應到對象上。這裡用到了關聯對象等 runtime 特性。

關聯對象常用來擴展已有類的能力。Objective-C 可以通過 category 擴展方法,但 category 不能直接添加存儲屬性。關聯對象提供了一種在運行時把值綁定到對象上的方式,因此非常適合這類需要緩存類信息的場景。

真正核心:屬性檢查

JSONModel 的核心之一,是遍歷模型類及其父類的屬性,分析每個屬性的名稱、類型、是否只讀、是否可選、是否忽略等信息。這個過程通常會在第一次使用時完成,然後緩存起來,避免重複計算。

在屬性檢查過程中,會讀取屬性名稱和屬性字符串。屬性字符串包含了類型編碼、內存管理特性、是否只讀等信息。JSONModel 會解析這些編碼,判斷屬性是對象、結構體、基本類型還是 block,並據此決定如何處理。

例如,如果屬性是只讀的,就沒有必要導入;如果屬性類型是 Block,也可能被忽略;如果屬性帶有特定 protocol 標記,則可以表示可選、索引或忽略等行為。

總結

JSONModel 的設計思路可以概括為:利用 runtime 獲取模型屬性,解析屬性類型,建立字典鍵與模型屬性的映射,再通過 KVC 或類似機制完成賦值。它把繁瑣的解析過程封裝成一個簡潔的初始化接口,讓開發者只需聲明模型屬性即可。

閱讀這類源碼,不只是為了學會一個庫,更是為了理解 Objective-C runtime 的能力邊界,以及優秀開源庫如何用簡潔 API 包裹複雜實現。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved