您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 鍵值觀察 KVO 實例詳解:從基本流程到進階用法

編輯:iOS 開發綜合

簡介

KVO 是 Key-Value Observing 的縮寫,中文稱作「鍵值觀察」。它是 iOS 提供的一種通知機制,用來解決一個常見問題:當某個 model 的資料改變時,界面要同步更新,但我們並不知道資料何時會變,总不能開個迴圈一直輪詢。

傳統做法是發通知(Notification),而 KVO 是另一種更輕巧的方式。它的實作機制是:為可能改變的資料掛上一個觀察者(通常就是 controller),一旦資料發生變化,觀察者就會收到信號,進而取得變化內容並執行自己的邏輯。

實例效果

界面上有兩個 label,分別顯示姓名與分數;還有一個按鈕用來修改分數。點擊按鈕後分數變化,label 內容跟著更新。

直接在按鈕的響應方法裡改 label 文字当然也行,但這裡我們改用 KVO 來完成,以便完整走一遍流程。

實作方式

整理一下需要完成的工作:

  1. 設計界面樣式。
  2. 建立學生模型。
  3. 對學生的分數屬性添加觀察。
  4. 修改學生的分數屬性。
  5. 在觀察到變化的回呼方法中更新界面。
  6. 不再需要觀察時移除觀察。

建立模型

新建一個 NSObject 子類作為學生模型,含姓名與分數兩個屬性:

// StudentModel.h
@interface StudentModel : NSObject
@property (nonatomic, copy) NSString *name;
@property float score;
@end

// ViewController.m
// 在 controller 中實例化學生模型
self.studentModel = [[StudentModel alloc] init];
[self.studentModel setValue:@"Cloudox" forKey:@"name"];
[self.studentModel setValue:@"89.0" forKey:@"score"];

這裡刻意用 setValue:forKey: 的方式賦值,因為 KVO 觀察的是「key」,而屬性名稱正好對應 key、屬性值對應 value——兩者是一套東西。

添加觀察

真正開始使用 KVO 至少要實作兩個方法:

addObserver:forKeyPath:options:context:
observeValueForKeyPath:ofObject:change:context:

第一個用來註冊觀察者,四個參數分別是:

  • observer:觀察者,這裡是被觀察者為學生模型、觀察者為 controller(self)。
  • keyPath:要觀察的鍵。
  • options:列舉值,決定回呼時能拿到哪些資訊,後面詳述。
  • context:可傳遞任意內容,後面詳述。
[self.studentModel addObserver:self
                     forKeyPath:@"score"
                        options:NSKeyValueObservingOptionNew
                        context:nil];

修改數據

在按鈕的響應方法中,同樣以 setValue:forKey: 更新分數。

接收通知

// KVO 回呼
- (void)observeValueForKeyPath:(NSString *)keyPath
                      ofObject:(id)object
                        change:(NSDictionary<NSKeyValueChangeKey, id> *)change
                       context:(void *)context {
    if ([keyPath isEqualToString:@"score"]) {
        self.scoreLabel.text = [NSString stringWithFormat:@"Score:%@",
                                [self.studentModel valueForKey:@"score"]];
    }
}

回呼方法的四個參數正好對應註冊時的四個參數。透過 keyPath 判斷是不是自己想接收的變化,就能對不同被觀察者做不同處理。這裡確認是分數變化後,就用新的分數更新 label。

移除觀察

[self.studentModel removeObserver:self forKeyPath:@"score"];

通常在 dealloc 或 viewController 銷毀時移除。未移除就釋放被觀察者,是 KVO 最常見的崩潰來源。

進階用法

用 context 傳遞物件

註冊時可以透過 context 塞入任意內容,回呼時再取出:

// 註冊時傳遞內容
[self.studentModel addObserver:self
                     forKeyPath:@"score"
                        options:NSKeyValueObservingOptionNew
                        context:"heyMe"];

// 回呼時取得
- (void)observeValueForKeyPath:(NSString *)keyPath
                      ofObject:(id)object
                        change:(NSDictionary<NSKeyValueChangeKey, id> *)change
                       context:(void *)context {
    if ([keyPath isEqualToString:@"score"]) {
        self.scoreLabel.text = [NSString stringWithFormat:@"Score:%@",
                                [self.studentModel valueForKey:@"score"]];
    }
    NSLog(@"%@", context);   // 印出 heyMe
}

options 參數

options 與回呼中的 change 參數是一對,用來決定 change 裡能拿到什麼:

  • NSKeyValueObservingOptionOld:可透過 change 取得變化前的值。
  • NSKeyValueObservingOptionNew:可透過 change 取得變化後的值。
  • NSKeyValueObservingOptionInitial:在 addObserver 回傳前就先發出一次通知。
  • NSKeyValueObservingOptionPrior:值變化前後各發一次通知,因此一次變化會收到兩次回呼。

change 參數的 key

  • NSKeyValueChangeKindKey:對應 NSKeyValueChange 列舉——Setting = 1(setter 被呼叫)、Insertion = 2、Removal = 3、Replacement = 4(後三者發生在觀察集合型資料時)。
  • NSKeyValueChangeNewKey:對應 options 的 New,包含變化後的新值。
  • NSKeyValueChangeOldKey:對應 options 的 Old,包含變化前的舊值。
  • NSKeyValueChangeIndexesKey:當 kind 為 2/3/4 時,此 key 的值是一個 NSIndexSet,代表操作涉及的索引集合。
  • NSKeyValueChangeNotificationIsPriorKey:包含一個布林值;若 options 用了 Prior,第一次(變化前)的通知會帶上這個 key。

這些值都可以印到 console 實際看一下,會比看文件直觀得多。

手動通知

預設是自動通知:只要值改變就會通知觀察者。若你希望「只在特定條件下才通知」,就得改成手動模式。第一步是在被觀察的模型中覆寫類別方法:

// StudentModel.m
+ (BOOL)automaticallyNotifiesObserversForKey:(NSString *)key {
    BOOL automatic = NO;
    if ([key isEqualToString:@"score"]) {
        automatic = NO;
    } else {
        automatic = [super automaticallyNotifiesObserversForKey:key];
    }
    return automatic;
}

這裡把 score 的自動通知關閉,其餘情況仍交由父類判斷,寫法比較保險。

改成手動之後,需要自己在前後包上 will/did change:

// 按鈕響應
- (void)changeScore {
    [self.studentModel willChangeValueForKey:@"score"];
    [self.studentModel setValue:@"99.0" forKey:@"score"];
    [self.studentModel didChangeValueForKey:@"score"];
}

若一次操作會改動多個屬性,通知可以嵌套:

- (void)changeScore {
    [self.studentModel willChangeValueForKey:@"name"];
    [self.studentModel willChangeValueForKey:@"score"];

    [self.studentModel setValue:@"Cloud" forKey:@"name"];
    [self.studentModel setValue:@"99.0" forKey:@"score"];

    [self.studentModel didChangeValueForKey:@"score"];
    [self.studentModel didChangeValueForKey:@"name"];
}

而在集合這類一對多关系中,除了 key,還必須告知「變化的類型」與「索引」:

- (void)removeTransactionsAtIndexes:(NSIndexSet *)indexes {
    [self willChange:NSKeyValueChangeRemoval
      valuesAtIndexes:indexes
               forKey:@"transactions"];

    // 移除指定索引位置的交易物件

    [self didChange:NSKeyValueChangeRemoval
     valuesAtIndexes:indexes
              forKey:@"transactions"];
}

鍵值依賴

還有一個重要議題是 keyPathDependenciesForClass,也就是鍵值依賴:當某個屬性的值取決於物件中的其他屬性時,可以宣告這層依賴關係,讓那些屬性改變時自動通知依賴它的屬性。這部分的細節值得再深入研究與實作驗證。


示例工程:https://github.com/Cloudox/KVODemo

最後提醒:KVO 屬性觀察在現代 Swift 開發中多已改用 Observable、Combine 或 @Observable 等宣告式方案;但在 Objective-C 與 Cocoa 框架(例如 AVPlayer、NSOperation 狀態)中,KVO 仍然是無法迴避的基礎知識。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved