鍵值編碼(Key-Value Coding)是一套利用字串識別符間接存取物件屬性與關聯的機制。在 Cocoa 開發中,Core Data、Application Scriptability、綁定(Binding)技術,以及宣告式屬性這類語言特性,全都建立在 KVC 之上(其中 Scriptability 與 Binding 是 Mac OS X 特有的能力)。學會 KVC,也能幫你簡化自己的程式碼。
Key(鍵)是標識物件某個屬性的字串。通常情況下,一個鍵會對應接收物件中的某個 getter 方法或實例變量名稱。鍵必須使用 ASCII 編碼、以小寫字母開頭,且不能包含空白字元。常見範例:payee、openingBalance、transactions、amount。
Key Path(鍵路徑)是由多個鍵以點(.)串接而成的字串,透過依序遍歷取得物件屬性。路徑中的第一個鍵相對於目前的接收物件,後續的鍵則只與前一個鍵所對應的屬性有關。
例如鍵路徑 address.street,意思是先從接收物件取得 address 屬性,再透過該 address 物件取得 street 屬性。
valueForKey: 回傳指定鍵對應的值。若傳入的鍵既找不到對應方法也找不到實例變量,接收物件會送出 valueForUndefinedKey: 訊息。該方法的預設實作會拋出 NSUndefinedKeyException 例外,你可以在子類別中改寫它,提供降級行為(例如回傳 nil 或預設值)。
valueForKeyPath: 行為類似,但接受的是鍵路徑。只要路徑中任一個鍵無法對應到相容 KVC 的物件,接收物件同樣會送出 valueForUndefinedKey:。
dictionaryWithValuesForKeys: 對輸入的鍵陣列逐一檢索,回傳一個包含這些鍵對應值的 NSDictionary。
注意:集合物件(NSArray、NSSet、NSDictionary 等)不能放入 nil。實務上的解法是用 NSNull 代替 nil 來標示空值,NSNull 提供了一個簡單的單例來表示屬性的 nil。所幸在 dictionaryWithValuesForKeys: 與 setValuesForKeysWithDictionary: 內部,NSNull 與 nil 之間的轉換會自動完成,你的物件不需要明確去測試 NSNull。
setValue:forKey: 為指定鍵設定值,該值相對於對應的接收物件。
setValuesForKeysWithDictionary: 用一個 NSDictionary 一次為多個鍵設值,其內部會對每組鍵值對呼叫 setValue:forKey:。若要存入空值,同樣以 NSNull 取代 nil。
實務上,KVC 最常見的用途是表單與模型之間的資料對接、把 JSON 字典批量塞進 model 物件,以及 KVO 與綁定的底層支撐。不過也因為它以字串作為鍵,拼錯鍵名稱在編譯期不會報錯,而是執行期拋 NSUndefinedKeyException,使用時建議搭配常數或集中的鍵名稱定義。