KVC 與 KVO 是 Objective-C 裡相當核心的兩個機制,KVO 更是建立在 KVC 之上。理解它們,後續看 Cocoa 的通知、綁定乃至某些「魔法」般的框架原始碼都會輕鬆許多。
KVC 指的是 NSKeyValueCoding 這組非正式 Protocol,提供一種以「鍵」間接存取物件屬性的機制。所謂鍵就是一個字串,對應的值可以是任意型別的物件。
以最基礎的層次看,KVC 只有兩個動作:設定某個鍵的值,以及取出某個鍵的值。
void changeName(Person *p, NSString *newName) {
// 以 KVC 的 getter 取值
NSString *originalName = [p valueForKey:@"name"];
// 以 KVC 的 setter 設值
[p setValue:newName forKey:@"name"];
NSLog(@"Changed %@'s name to: %@", originalName, newName);
}
如果 Person 還有一個 spouse 屬性,其值同樣是另一個 Person 物件,那麼要取得配偶的名字,就需要用到「鍵路徑」(key path):
void logMarriage(Person *p) {
NSString *personsName = [p valueForKey:@"name"];
// 這裡用的是 key path 而非普通 key
NSString *spousesName = [p valueForKeyPath:@"spouse.name"];
NSLog(@"%@ is happily married to %@", personsName, spousesName);
}
key 與 key path 的區別值得記牢:key 只能從單一物件取值,而 key path 以點號「.」把多個 key 串接起來表達嵌套關係。
[p valueForKeyPath:@"spouse.name"]; // 等價於 [[p valueForKey:@"spouse"] valueForKey:@"name"];
KVO 建立在 KVC 之上,能觀察某個物件的 key path 值是否發生變化,變化時主動發出通知。實作上通常涉及三件事:
addObserver:forKeyPath:options:context: 進行註冊observeValueForKeyPath:ofObject:change:context: 中接收變化dealloc 中移除觀察,否則會崩潰static NSString *const KVO_CONTEXT_ADDRESS_CHANGED = @"KVO_CONTEXT_ADDRESS_CHANGED";
@implementation PersonWatcher
- (void)watchPersonForChangeOfAddress:(Person *)p {
// 開始觀察
[p addObserver:self
forKeyPath:@"address"
options:0
context:KVO_CONTEXT_ADDRESS_CHANGED];
// 記錄所有被觀察的物件,供 dealloc 時逐一移除
[m_observedPeople addObject:p];
}
// key path 值變化時會被呼叫
- (void)observeValueForKeyPath:(NSString *)keyPath
ofObject:(id)object
change:(NSDictionary *)change
context:(void *)context {
// 用 context 判斷是哪一個觀察來源,
// 因為同一個物件可能同時觀察了多個 key path
if (context == KVO_CONTEXT_ADDRESS_CHANGED) {
NSString *name = [object valueForKey:@"name"];
NSString *address = [object valueForKey:@"address"];
NSLog(@"%@ has a new address: %@", name, address);
}
}
- (void)dealloc {
// 物件銷毀前必須停止所有觀察,否則會崩潰
for (Person *p in m_observedPeople) {
[p removeObserver:self forKeyPath:@"address"];
}
[m_observedPeople release];
m_observedPeople = nil;
[super dealloc];
}
- (id)init {
if (self = [super init]) {
m_observedPeople = [NSMutableArray new];
}
return self;
}
@end
這就是 KVO 的全貌:透過 key path 觀察物件的值,值一變就收到通知。而它能運作的前提,正是 KVC 提供的鍵值存取能力——兩者是一體的兩面。