鍵值編碼(Key-Value Coding,KVC)是 Cocoa 中用來間接取值與設值的一種通用機制。所謂「通用」,指的是一種能適用於多種情境的實作方式。通用程式碼能減少專案的程式碼總量,也能處理開發者事先無法預期的情況。Cocoa 從一開始就極度重視通用且可重複使用的程式碼。
舉個例子,設定一個物件的 first name 與 last name,直白的寫法是:
[person setFirstName:@"Scott"]; [person setLastName:@"Stevenson"];
這沒問題,但改用 KVC 就能寫出更通用的程式碼:
[person setValue:@"Scott" forKey:@"firstName"]; [person setValue:@"Stevenson" forKey:@"lastName"];
新手可能會質疑其意義——畢竟 KVC 版本看起來還要多打幾個字。那就換一個更能體現價值的場景。
先定義一個類別:
@interface CDCPerson : NSObject
{
NSString * firstName;
NSString * lastName;
NSNumber * phoneNumber;
NSString * emailAddress;
}
- (void) setFirstName:(NSString *)value;
- (void) setLastName:(NSString *)value;
- (void) setPhoneNumber:(NSNumber *)value;
- (void) setEmailAddress:(NSString *)value;
@end
假設我們手上有一個字典,裡頭裝著要套用到 person 上的鍵值:
// 假設 inputValues 包含我們想設定到 person 上的鍵值
NSDictionary *inputValues;
CDCPerson *person = [[CDCPerson alloc] init];
NSEnumerator *e = [inputValues keyEnumerator];
id dictKey, dictValue;
while (dictKey = [e nextObject]) {
dictValue = [inputValues valueForKey:dictKey];
[person setValue:dictValue forKey:dictKey];
}
這段程式碼是通用的:每當 Person 類別新增一個實例變量,你都不必回頭改這段程式。
而它還能再簡化:
NSDictionary *inputValues; CDCPerson *person = [[CDCPerson alloc] init]; [person setValuesForKeysWithDictionary:inputValues];
Apple 對 -setValuesForKeysWithDictionary: 的說明是:以字典中的鍵值對設定接收者的屬性,鍵用於識別各個屬性;預設實作會對每組鍵值對呼叫 setValue:forKey:,若值為 NSNull 則轉為 nil。換句話說,它與第一段程式碼並無本質差異。
那麼 -setValue:forKey: 究竟做了什麼?這就是 KVC 的魔力所在:它會找出 -setFirstName:、-setLastName:、-setPhoneNumber:、-setEmailAddress: 的實作並呼叫;若找不到對應的 setter,KVC 還會嘗試幾種可能的命名規則,最終退回到直接設定實例變量。
KVC 也能用來取值:
// 假設 person 已存在並被賦值
CDCPerson *person;
NSMutableDictionary *outputValues = [NSMutableDictionary dictionary];
NSArray *keys = [NSArray arrayWithObjects:@"firstName", @"lastName", @"phoneNumber", @"emailAddress", nil];
NSEnumerator *e = [keys objectEnumerator];
id key, value;
while (key = [e nextObject]) {
value = [person valueForKey:key];
[outputValues setValue:value forKey:key];
}
同樣可以簡化為:
CDCPerson *person; NSArray *keys = [NSArray arrayWithObjects:@"firstName", @"lastName", @"phoneNumber", @"emailAddress", nil]; NSDictionary *outputValues = [person dictionaryWithValuesForKeys:keys];
與設值時類似,-valueForKey: 會去找與鍵同名的 getter:
// 讓 KVC 去尋找名為 -firstName 的方法 NSString *name = [person valueForKey:@"firstName"];
由於 KVC 是 Cocoa Bindings 與 Core Data 的關鍵基礎,具備這方面的知識相當值得。它還支援鍵值路徑:
// 取值 [obj valueForKeyPath:@"storage.firstName"]; // 設值 [obj setValue:@"Scott" forKeyPath:@"storage.firstName"];
效果等同:
// 取值 [[obj storage] firstName]; // 設值 [[obj storage] setFirstName:@"Scott"];
想更深入的話,可以參考 Apple 開發者論壇上關於鍵值編碼的討論串。