KVC(Key-Value Coding,鍵值編碼)是 Cocoa 相當核心的一項機制:它讓你能用字串間接存取物件的屬性,而不必呼叫 getter/setter,也不必直接碰實例變數。Objective-C 的許多語法糖——包括 KeyPath、綁定、KVO、以及 NSSortDescriptor 的排序——都建立在它之上。
KVC 的本質是「間接改變物件狀態」:以字串作為標識來定位屬性,再透過該標識讀寫。這種間接性帶來的彈性是——呼叫端不需要知道屬性的實際型別,甚至不需要在編譯期知道屬性存在。
KVC 不只支援物件,也支援 int、CGFloat、BOOL 等純量與 CGRect 等結構體;非物件型別會被自動裝箱/拆箱成 NSNumber 或 NSValue。
Key 是標識單一屬性的字串。規範上必須是 ASCII、以小寫字母開頭、不含空格,通常對應存取方法或實例變數名稱。
Key Path 則是以「點」分隔的多段 key,用來描述一條連續的屬性路徑:第一段的屬性相對於接收者,之後每一段都相對於前一段的結果。例如 person.address.city.name。
Key Path 的深度沒有硬限制,實際上取決於物件關係有多複雜。但要留意:路徑中任何一段回傳 nil,整個表達式的結果就是 nil,不會繼續往下走。
// 讀取:以 key 為標識取得對應屬性值 - (id)valueForKey:(NSString *)key; // 設定:以 key 為標識設定屬性值 - (void)setValue:(id)value forKey:(NSString *)key; // 多段路徑版本 - (id)valueForKeyPath:(NSString *)keyPath; - (void)setValue:(id)value forKeyPath:(NSString *)keyPath; // 邊界情況的處理 - (id)valueForUndefinedKey:(NSString *)key; // key 不存在時的 fallback - (void)setNilValueForKey:(NSString *)key; // 傳入 nil 時的 fallback
valueForKey: 的查找順序:
getKey、key、isKey、_key 的方法(有 getter 就用它)。_key、_isKey、key、isKey 並直接取值。valueForUndefinedKey:(預設會丟例外)。setValue:forKey: 的順序類似:先找 setKey: 或 _setKey:,再找實例變數,最後落到 setNilValueForKey:。
理解這個順序很重要:它解釋了為什麼 KVC 能存取宣告在 @interface 裡但沒有公開屬性的值,也解釋了為什麼 ARC 下的 strong 屬性被 KVC 設為 nil 時不會崩潰(因為有 setNilValueForKey: 兜底)。
KVC 對 NSArray 有一組特殊的集合運算子,能讓你在不寫迴圈的情況下做聚合計算:
// 平均 NSNumber *transactionAverage = [transactions valueForKeyPath:@"@avg.amount"]; // 計數 NSNumber *numberOfTransactions = [transactions valueForKeyPath:@"@count"]; // 最大值 NSDate *latestDate = [transactions valueForKeyPath:@"@max.date"]; // 最小值 NSDate *earliestDate = [transactions valueForKeyPath:@"@min.date"]; // 總和 NSNumber *amountSum = [transactions valueForKeyPath:@"@sum.amount"];
// QYPerson.h #import <Foundation/Foundation.h> @class QYCourse; @interface QYPerson : NSObject @property (nonatomic, strong) NSString *name; @property (nonatomic, strong) QYCourse *course; @property (nonatomic, assign) NSInteger point; @property (nonatomic, strong) NSArray *persons; @end
// main.m
int main(int argc, const char * argv[]) {
@autoreleasepool {
QYPerson *person = [[QYPerson alloc] init];
QYPerson *p1 = [[QYPerson alloc] init];
QYPerson *p2 = [[QYPerson alloc] init];
QYPerson *p3 = [[QYPerson alloc] init];
[p1 setValue:@78 forKey:@"point"];
[p2 setValue:@87 forKey:@"point"];
[p3 setValue:@98 forKey:@"point"];
NSArray *array = @[p1, p2, p3];
[person setValue:array forKey:@"persons"];
NSLog(@"other persons' achievement info:%@",
[person valueForKeyPath:@"persons.point"]);
NSLog(@"all persons' number is %@",
[person valueForKeyPath:@"persons.@count"]);
NSLog(@"the max achievement :%@",
[person valueForKeyPath:@"persons.@max.point"]);
NSLog(@"the min achievement :%@",
[person valueForKeyPath:@"persons.@min.point"]);
NSLog(@"the avg achievement :%@",
[person valueForKeyPath:@"persons.@avg.point"]);
}
return 0;
}
other persons' achievement info:(
78,
87,
98
)
all persons' number is 3
the max achievement :98
the min achievement :78
the avg achievement :87.66666666666667
注意 @max 與 @min 需要屬性實作 NSComparisonMethods 的比較協定(對 NSNumber、NSDate、NSString 這些系統類別是內建的),自訂類別若要支援得自己實作。
NSSortDescriptor 排序、KVO 觀察、與 Cocoa Bindings 整合。KeyPath(\QYPerson.point)取代字串 key,型別安全且可被編譯器檢查。混用 Objective-C 與 Swift 時,Objective-C 類別若要被 Swift 的 KVC 存取,記得加上 @objcMembers。