前言:KVC 與 KVO 是幫助我們駕馭 Objective-C 動態特性的利器。KVO 建立在 KVC 基礎之上,本文不再贅述 KVC,而是聚焦 KVO 本身。本文內容包括:KVO 的定義、典型使用場景、手動 KVO,以及幾個需要留意的要點。
KVO 提供了一種 key-value-observing 機制,也就是說可以通過監聽某個 key,獲得其 value 的變化,從而在對象之間同步狀態。使用 KVO 的類需遵循 NSKeyValueObserving 協議,而事實上任何繼承自 NSObject 的類都已遵循該協議——在 Objective-C 中幾乎所有類都源自 NSObject。
使用 KVO 通常分為三步:
通過以下函數注冊通知:
- (void)addObserver:(NSObject *)anObserver forKeyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options context:(void *)context
observer:觀察者,即 KVO 通知的訂閱者,必須實現 observeValueForKeyPath:ofObject:change:context: 方法。keyPath:待觀察的屬性,相對於被觀察者。options:KVO 的屬性配置,共四個選項。context:上下文,會傳遞到回調函數中用於區分消息,因此應當各不相同。
options 的四個選項分別為:
NSKeyValueObservingOptionNew:change 字典包含改變後的值。NSKeyValueObservingOptionOld:change 字典包含改變前的值。NSKeyValueObservingOptionInitial:注冊後立刻觸發一次通知。NSKeyValueObservingOptionPrior:值改變前是否也通知(決定是否前後各通知一次)。
每當監聽的 keyPath 發生變化,就會在此函數中回調:
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context
keyPath:被監聽的 keyPath,用於區分不同監聽。object:被觀察修改後的對象。change:保存變化資訊的字典(含新舊值等)。context:上下文,用於區分不同監聽。
通常使用以下兩個函數:
- (void)removeObserver:(NSObject *)anObserver forKeyPath:(NSString *)keyPath - (void)removeObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath context:(void *)context
由於移除時無法直接判斷是否成功,一般會用 @try/@catch 包裹:
@try { [object removeObserver:self forKeyPath:keyPath]; } @catch (NSException *exception) { NSLog(@%@,exception); }
這裡給出一個完整的 KVO 示例:點擊 random 按鈕隨機改變 User 的 age,界面同步展示新舊數值。
首先定義 User 類作為 Model:
@interface User : NSObject @property (strong,nonatomic) NSString * name; @property (nonatomic) NSUInteger age; @end
定義兩個靜態變量,分別作為 keyPath 與 context:
static NSString * observename = @age; static void * privateContext = 0;
在 viewWillAppear 中注冊 KVO,在 viewWillDisappear 中移除:
-(void)viewWillAppear:(BOOL)animated{ [self.user addObserver:self forKeyPath:observename options:NSKeyValueObservingOptionOld | NSKeyValueObservingOptionNew context:privateContext]; } -(void)viewWillDisappear:(BOOL)animated{ @try { [self.user removeObserver:self forKeyPath:observename]; } @catch (NSException *exception) { NSLog(@%@,exception); } }
點擊 random 時 age 發生改變:
- (IBAction)random:(id)sender { self.user.age = arc4random()%100 +1; }
在回調函數中完成 Model 與 View 的同步:
-(void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context{ if (context == privateContext) { if ([keyPath isEqualToString:observename]) { NSNumber * old = [change objectForKey:NSKeyValueChangeOldKey]; NSNumber * new = [change objectForKey:NSKeyValueChangeNewKey]; self.lastvalue.text = [NSString stringWithFormat:@%@,old]; self.newvalue.text = [NSString stringWithFormat:@%@,new]; } } }
KVO 的默認實現,是在注冊的 keyPath 的 setter 中自動調用以下兩個函數:
- (void)willChangeValueForKey:(NSString *)key - (void)didChangeValueForKey:(NSString *)key
有時我們需要手動觸發 KVO,此時可關閉自動通知並自行調用,好處是能靈活加入自定義判斷條件:
+(BOOL)automaticallyNotifiesObserversOfAge{ return NO; } -(void)setAge:(NSUInteger)age{ if (age < 22) { return; } [self willChangeValueForKey:@age]; _age = age; [self didChangeValueForKey:@age]; }
由於 context 通常用於區分不同 KVO,其唯一性至關重要。常見做法是在當前 .m 文件中用靜態變量定義:
static void * privateContext = 0;
KVO 的響應與被觀察值的變化處於同一線程,因此大多數情況下不要把 KVO 與多線程混用,除非能保證所有觀察者都能線程安全地處理 KVO。
id oldValue = change[NSKeyValueChangeOldKey]; id newValue = change[NSKeyValueChangeNewKey];