如何優雅地使用 KVO

KVO 作為 iOS 中一種強大并且有效的機制,為 iOS 開發者們提供了很多的便利;我們可以使用 KVO 來檢測對象屬性的變化、快速做出響應,這能夠為我們在開發強交互、響應式應用以及實現視圖和模型的雙向綁定時提供大量的幫助。

但是在大多數情況下,除非遇到不用 KVO 無法解決的問題,筆者都會盡量避免它的使用,這并不是因為 KVO 有性能問題或者使用場景不多,總重要的原因是 KVO 的使用是在是太 ** 麻煩了。

trouble

使用 KVO 時,既需要進行注冊成為某個對象屬性的觀察者,還要在合適的時間點將自己移除,再加上需要覆寫一個又臭又長的方法,并在方法里判斷這次是不是自己要觀測的屬性發生了變化,每次想用 KVO 解決一些問題的時候,作者的第一反應就是頭疼,這篇文章會為各位為 KVO 所苦的開發者提供一種更優雅的解決方案。

使用 KVO

不過在介紹如何優雅地使用 KVO 之前,我們先來回憶一下,在通常情況下,我們是如何使用 KVO 進行鍵值觀測的。

首先,我們有一個 Fizz 類,其中包含一個 number 屬性,它在初始化時會自動被賦值為 @0

// Fizz.h
@interface Fizz : NSObject

@property (nonatomic, strong) NSNumber *number;

@end

// Fizz.m
@implementation Fizz

- (instancetype)init {
    if (self = [super init]) {
        _number = @0;
    }
    return self;
}

@end

我們想在 Fizz 對象中的 number 對象發生改變時獲得通知得到的和的值,這時我們就要祭出 -addObserver:forKeyPath:options:context 方法來監控 number 屬性的變化:

Fizz *fizz = [[Fizz alloc] init];
[fizz addObserver:self
       forKeyPath:@"number"
          options:NSKeyValueObservingOptionNew | NSKeyValueObservingOptionOld
          context:nil];
fizz.number = @2;

在將當前對象 self注冊成為 fizz 的觀察者之后,我們需要在當前對象中覆寫 -observeValueForKeyPath:ofObject:change:context: 方法:

- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary<NSKeyValueChangeKey,id> *)change context:(void *)context {
    if ([keyPath isEqualToString:@"number"]) {
        NSLog(@"%@", change);
    }
}

在大多數情況下我們只需要對比 keyPath 的值,就可以知道我們到底監控的是哪個對象,但是在更復雜的業務場景下,使用 context 上下文以及其它輔助手段才能夠幫助我們更加精準地確定被觀測的對象。

但是當上述代碼運行時,雖然可以成功打印出 change 字典,但是卻會發生崩潰,你會在控制臺中看到下面的內容:

2017-02-26 23:44:19.666 KVOTest[15888:513229] {
    kind = 1;
    new = 2;
    old = 0;
}
2017-02-26 23:44:19.720 KVOTest[15888:513229] *** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'An instance 0x60800001dd20 of class Fizz was deallocated while key value observers were still registered with it. Current observation info: <NSKeyValueObservationInfo 0x60800003d320> (
<NSKeyValueObservance 0x608000057310: Observer: 0x7fa098f07590, Key path: number, Options: <New: YES, Old: YES, Prior: NO> Context: 0x0, Property: 0x608000057400>
)'

這是因為 fizz 對象沒有被其它對象引用,在脫離 viewDidLoad 作用于之后就被回收了,然而在 -dealloc 時,并沒有移除觀察者,所以會造成崩潰。

我們可以使用下面的代碼來驗證上面的結論是否正確:

// Fizz.h
@interface Fizz : NSObject

@property (nonatomic, strong) NSNumber *number;
@property (nonatomic, weak) NSObject *observer;

@end

// Fizz.m
@implementation Fizz

- (instancetype)init {
    if (self = [super init]) {
        _number = @0;
    }
    return self;
}

- (void)dealloc {
    [self removeObserver:self.observer forKeyPath:@"number"];
}

@end

Fizz 類的接口中添加一個 observer 弱引用來持有對象的觀察者,并在對象 -dealloc 時將它移除,重新運行這段代碼,就不會發生崩潰了。

not-crash-with-remove-observer-when-deallo

由于沒有移除觀察者導致崩潰使用 KVO 時經常會遇到的問題之一,解決辦法其實有很多,我們在這里簡單介紹一個,使用當前對象持有被觀測的對象,并在當前對象 -dealloc 時,移除觀察者:

- (void)viewDidLoad {
    [super viewDidLoad];
    self.fizz = [[Fizz alloc] init];
    [self.fizz addObserver:self
                forKeyPath:@"number"
                   options:NSKeyValueObservingOptionNew | NSKeyValueObservingOptionOld
                   context:nil];
    self.fizz.number = @2;
}

- (void)dealloc {
    [self.fizz removeObserver:self forKeyPath:@"number"];
}

這也是我們經常使用來避免崩潰的辦法,但是在筆者看來也是非常的不優雅,除了上述的崩潰問題,使用 KVO 的過程也非常的別扭和痛苦:

  1. 需要手動移除觀察者,且移除觀察者的時機必須合適
  2. 注冊觀察者的代碼和事件發生處的代碼上下文不同,傳遞上下文是通過 void * 指針;
  3. 需要覆寫 -observeValueForKeyPath:ofObject:change:context: 方法,比較麻煩;
  4. 在復雜的業務邏輯中,準確判斷被觀察者相對比較麻煩,有多個被觀測的對象和屬性時,需要在方法中寫大量的 if 進行判斷;

雖然上述幾個問題并不影響 KVO 的使用,不過這也足夠成為筆者盡量不使用 KVO 的理由了。

優雅地使用 KVO

如何優雅地解決上一節提出的幾個問題呢?我們在這里只需要使用 Facebook 開源的 KVOController 框架就可以優雅地解決這些問題了。

如果想要實現同樣的業務需求,當使用 KVOController 解決上述問題時,只需要以下代碼就可以達到與上一節中完全相同的效果:

[self.KVOController observe:self.fizz
                    keyPath:@"number"
                    options:NSKeyValueObservingOptionNew | NSKeyValueObservingOptionOld
                      block:^(id  _Nullable observer, id  _Nonnull object, NSDictionary<NSString    *,id> * _Nonnull change) {
                          NSLog(@"%@", change);
                      }];

我們可以在任意對象上獲得 KVOController 對象,然后調用它的實例方法 -observer:keyPath:options:block: 就可以檢測某個對象對應的屬性了,該方法傳入的參數還是非常容易理解的,在 block 中也可以獲得所有與 KVO 有關的參數。

使用 KVOController 進行鍵值觀測可以說完美地解決了在使用原生 KVO 時遇到的各種問題。

  1. 不需要手動移除觀察者;
  2. 實現 KVO 與事件發生處的代碼上下文相同,不需要跨方法傳參數;
  3. 使用 block 來替代方法能夠減少使用的復雜度,提升使用 KVO 的體驗;
  4. 每一個 keyPath 會對應一個屬性,不需要在 block 中使用 if 判斷 keyPath

KVOController 的實現

KVOController 其實是對 Cocoa 中 KVO 的封裝,它的實現其實也很簡單,整個框架中只有兩個實現文件,先來簡要看一下 KVOController 如何為所有的 NSObject 對象都提供 -KVOController 屬性的吧。

分類和 KVOController 的初始化

KVOController 不止為 Cocoa Touch 中所有的對象提供了 -KVOController 屬性還提供了另一個 KVOControllerNonRetaining 屬性,實現方法就是分類和 ObjC Runtime。

@interface NSObject (FBKVOController)

@property (nonatomic, strong) FBKVOController *KVOController;
@property (nonatomic, strong) FBKVOController *KVOControllerNonRetaining;

@end

從名字可以看出 KVOControllerNonRetaining 在使用時并不會持有被觀察的對象,與它相比 KVOController 就會持有該對象了。

對于 KVOControllerKVOControllerNonRetaining 屬性來說,其實現都非常簡單,對運行時非常熟悉的讀者都應該知道使用關聯對象就可以輕松實現這一需求。

- (FBKVOController *)KVOController {
  id controller = objc_getAssociatedObject(self, NSObjectKVOControllerKey);
  if (nil == controller) {
    controller = [FBKVOController controllerWithObserver:self];
    self.KVOController = controller;
  }
  return controller;
}

- (void)setKVOController:(FBKVOController *)KVOController {
  objc_setAssociatedObject(self, NSObjectKVOControllerKey, KVOController, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}

- (FBKVOController *)KVOControllerNonRetaining {
  id controller = objc_getAssociatedObject(self, NSObjectKVOControllerNonRetainingKey);
  if (nil == controller) {
    controller = [[FBKVOController alloc] initWithObserver:self retainObserved:NO];
    self.KVOControllerNonRetaining = controller;
  }
  return controller;
}

- (void)setKVOControllerNonRetaining:(FBKVOController *)KVOControllerNonRetaining {
  objc_setAssociatedObject(self, NSObjectKVOControllerNonRetainingKey, KVOControllerNonRetaining, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}

兩者的 setter 方法都只是使用 objc_setAssociatedObject 按照鍵值簡單地存一下,而 getter 中不同的其實也就是對于 FBKVOController 的初始化了。

easy

到這里這個整個 FBKVOController 框架中的兩個實現文件中的一個就介紹完了,接下來要看一下其中的另一個文件中的類 KVOController

KVOController 的初始化

KVOController 是整個框架中提供 KVO 接口的類,作為 KVO 的管理者,其必須持有當前對象所有與 KVO 有關的信息,而在 KVOController 中,用于存儲這個信息的數據結構就是 NSMapTable

KVOControlle

為了使 KVOController 達到線程安全,它還必須持有一把 pthread_mutex_t 鎖,用于在操作 _objectInfosMap 時使用。

再回到上一節提到的初始化問題,NSObject 的屬性 FBKVOControllerKVOControllerNonRetaining 的區別在于前者會持有觀察者,使其引用計數加一。

- (instancetype)initWithObserver:(nullable id)observer retainObserved:(BOOL)retainObserved {
  self = [super init];
  if (nil != self) {
    _observer = observer;
    NSPointerFunctionsOptions keyOptions = retainObserved ? NSPointerFunctionsStrongMemory|NSPointerFunctionsObjectPointerPersonality : NSPointerFunctionsWeakMemory|NSPointerFunctionsObjectPointerPersonality;
    _objectInfosMap = [[NSMapTable alloc] initWithKeyOptions:keyOptions valueOptions:NSPointerFunctionsStrongMemory|NSPointerFunctionsObjectPersonality capacity:0];
    pthread_mutex_init(&_lock, NULL);
  }
  return self;
}

在初始化方法中使用各自的方法對 KVOController 對象持有的所有實例變量進行初始化,KVOControllerKVOControllerNonRetaining 的區別就體現在生成的 NSMapTable 實例時傳入的是 NSPointerFunctionsStrongMemory 還是 NSPointerFunctionsWeakMemory 選項。

KVO 的過程

使用 KVOController 實現鍵值觀測時,大都會調用實例方法 -observe:keyPath:options:block 來注冊成為某個對象的觀察者,監控屬性的變化:

- (void)observe:(nullable id)object keyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options block:(FBKVONotificationBlock)block {
  _FBKVOInfo *info = [[_FBKVOInfo alloc] initWithController:self keyPath:keyPath options:options block:block];

  [self _observe:object info:info];
}

數據結構 _FBKVOInfo

這個方法中就涉及到另外一個私有的數據結構 _FBKVOInfo,這個類中包含著所有與 KVO 有關的信息:

_FBKVOInfo

_FBKVOInfoKVOController 中充當的作用僅僅是一個數據結構,我們主要用它來存儲整個 KVO 過程中所需要的全部信息,其內部沒有任何值得一看的代碼,需要注意的是,_FBKVOInfo 覆寫了 -isEqual: 方法用于對象之間的判等以及方便 NSMapTable 的存儲。

如果再有點別的什么特別作用的就是,其中的 state 表示當前的 KVO 狀態,不過在本文中不會具體介紹。

typedef NS_ENUM(uint8_t, _FBKVOInfoState) {
  _FBKVOInfoStateInitial = 0,
  _FBKVOInfoStateObserving,
  _FBKVOInfoStateNotObserving,
};

observe 的過程

在使用 -observer:keyPath:options:block: 監聽某一個對象屬性的變化時,該過程的核心調用棧其實還是比較簡單:

KVOController-Observe-Stack

我們從棧底開始簡單分析一下整個封裝 KVO 的過程,其中棧底的方法,也就是我們上面提到的 -observer:keyPath:options:block: 初始化了一個名為 _FBKVOInfo 的對象:

- (void)observe:(nullable id)object keyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options block:(FBKVONotificationBlock)block {
  _FBKVOInfo *info = [[_FBKVOInfo alloc] initWithController:self keyPath:keyPath options:options block:block];
  [self _observe:object info:info];
}

在創建了 _FBKVOInfo 之后執行了另一個私有方法 -_observe:info:

- (void)_observe:(id)object info:(_FBKVOInfo *)info {
  pthread_mutex_lock(&_lock);
  NSMutableSet *infos = [_objectInfosMap objectForKey:object];

  _FBKVOInfo *existingInfo = [infos member:info];
  if (nil != existingInfo) {
    pthread_mutex_unlock(&_lock);
    return;
  }

  if (nil == infos) {
    infos = [NSMutableSet set];
    [_objectInfosMap setObject:infos forKey:object];
  }
  [infos addObject:info];
  pthread_mutex_unlock(&_lock);

  [[_FBKVOSharedController sharedController] observe:object info:info];
}

這個私有方法通過自身持有的 _objectInfosMap 來判斷當前對象、屬性以及各種上下文是否已經注冊在表中存在了,在這個 _objectInfosMap 中保存著對象以及與對象有關的 _FBKVOInfo 集合:

objectInfosMap

在操作了當前 KVOController 持有的 _objectInfosMap 之后,才會執行私有的 _FBKVOSharedController 類的實例方法 -observe:info:

- (void)observe:(id)object info:(nullable _FBKVOInfo *)info {
  pthread_mutex_lock(&_mutex);
  [_infos addObject:info];
  pthread_mutex_unlock(&_mutex);

  [object addObserver:self forKeyPath:info->_keyPath options:info->_options context:(void *)info];

  if (info->_state == _FBKVOInfoStateInitial) {
    info->_state = _FBKVOInfoStateObserving;
  } else if (info->_state == _FBKVOInfoStateNotObserving) {
    [object removeObserver:self forKeyPath:info->_keyPath context:(void *)info];
  }
}

_FBKVOSharedController 才是最終調用 Cocoa 中的 -observe:forKeyPath:options:context: 方法開始對屬性的監聽的地方;同時,在整個應用運行時,只會存在一個 _FBKVOSharedController 實例:

+ (instancetype)sharedController {
  static _FBKVOSharedController *_controller = nil;
  static dispatch_once_t onceToken;
  dispatch_once(&onceToken, ^{
    _controller = [[_FBKVOSharedController alloc] init];
  });
  return _controller;
}

這個唯一的 _FBKVOSharedController 實例會在 KVO 的回調方法中將事件分發給 KVO 的觀察者。

- (void)observeValueForKeyPath:(nullable NSString *)keyPath
                      ofObject:(nullable id)object
                        change:(nullable NSDictionary<NSString *, id> *)change
                       context:(nullable void *)context {
    _FBKVOInfo *info;
    pthread_mutex_lock(&_mutex);
    info = [_infos member:(__bridge id)context];
    pthread_mutex_unlock(&_mutex);

    FBKVOController *controller = info->_controller;
    id observer = controller.observer;

    if (info->_block) {
        NSDictionary<NSString *, id> *changeWithKeyPath = change;
        if (keyPath) {
            NSMutableDictionary<NSString *, id> *mChange = [NSMutableDictionary dictionaryWithObject:keyPath forKey:FBKVONotificationKeyPathKey];
            [mChange addEntriesFromDictionary:change];
            changeWithKeyPath = [mChange copy];
        }
        info->_block(observer, object, changeWithKeyPath);
    } else if (info->_action) {
        [observer performSelector:info->_action withObject:change withObject:object];
    } else {
        [observer observeValueForKeyPath:keyPath ofObject:object change:change context:info->_context];
    }
}

在這個 -observeValueForKeyPath:ofObject:change:context: 回調方法中,_FBKVOSharedController 會根據 KVO 的信息 _KVOInfo 選擇不同的方式分發事件,如果觀察者沒有傳入 block 或者選擇子,就會調用觀察者 KVO 回調方法。

KVOSharedControlle

上圖就是在使用 KVOController 時,如果一個 KVO 事件觸發之后,整個框架是如何對這個事件進行處理以及回調的。

如何 removeObserver

在使用 KVOController 時,我們并不需要手動去處理 KVO 觀察者的移除,因為所有的 KVO 事件都由私有的 _KVOSharedController 來處理;

KVOController-Unobserve-Stack

當每一個 KVOController 對象被釋放時,都會將它自己持有的所有 KVO 的觀察者交由 _KVOSharedController-unobserve:infos: 方法處理:

- (void)unobserve:(id)object infos:(nullable NSSet<_FBKVOInfo *> *)infos {
  pthread_mutex_lock(&_mutex);
  for (_FBKVOInfo *info in infos) {
    [_infos removeObject:info];
  }
  pthread_mutex_unlock(&_mutex);

  for (_FBKVOInfo *info in infos) {
    if (info->_state == _FBKVOInfoStateObserving) {
      [object removeObserver:self forKeyPath:info->_keyPath context:(void *)info];
    }
    info->_state = _FBKVOInfoStateNotObserving;
  }
}

該方法會遍歷所有傳入的 _FBKVOInfo,從其中取出 keyPath 并將 _KVOSharedController 移除觀察者。

除了在 KVOController 析構時會自動移除觀察者,我們也可以通過它的實例方法 -unobserve:keyPath: 操作達到相同的效果;不過在調用這個方法時,我們能夠得到一個不同的調用棧:

KVOController-Unobserve-Object-Stack

功能的實現過程其實都是類似的,都是通過 -removeObserver:forKeyPath:context: 方法移除觀察者:

- (void)unobserve:(id)object info:(nullable _FBKVOInfo *)info {
  pthread_mutex_lock(&_mutex);
  [_infos removeObject:info];
  pthread_mutex_unlock(&_mutex);

  if (info->_state == _FBKVOInfoStateObserving) {
    [object removeObserver:self forKeyPath:info->_keyPath context:(void *)info];
  }
  info->_state = _FBKVOInfoStateNotObserving;
}

不過由于這個方法的參數并不是一個數組,所以并不需要使用 for 循環,而是只需要將該 _FBKVOInfo 對應的 KVO 事件移除就可以了。

總結

KVOController 對于 Cocoa 中 KVO 的封裝非常的簡潔和優秀,我們只需要調用一個方法就可以完成一個對象的鍵值觀測,同時不需要處理移除觀察者等問題,能夠降低我們出錯的可能性。

在筆者看來 KVOController 中唯一不是很優雅的地方就是,需要寫出 object.KVOController 才可以執行 KVO,如果能將 KVOController 換成更短的形式可能看起來更舒服一些:

[self.kvo observer:keyPath:options:block:];

不過這并不是一個比較大的問題,同時也只是筆者自己的看法,況且不影響 KVOController 的使用,所以各位讀者也無須太過介意。

Github Repo:iOS-Source-Code-Analyze

Follow: Draveness · GitHub

Source: http://draveness.me/kvocontroller

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,646評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,595評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,560評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,035評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,814評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,224評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,301評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,444評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,988評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,804評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,998評論 1 370
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,544評論 5 360
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,237評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,665評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,927評論 1 287
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,706評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,993評論 2 374

推薦閱讀更多精彩內容