声明
有人说这是所谓的黑魔法, 本人在此声明: 本项目无任何黑魔法, 对原代码无任何侵害, 只是对注册方法的封装.
问题
我们都知道, 使用KVO模式, 对某个属性进行监听时, Observer 需要在必要的时刻进行移除, 否则 App 必然会 Crash. 这个问题有点烦人, 因为偶尔会忘记写移除 Observer 的代码...
我一直想要这样一个效果: 只管监听, 并处理监听方法. 不去分心, 管何时移除 Observer , 让其能够适时自动处理.
所幸, 它能够实现, 先预览一下:
@interface NSObject (SJObserverHelper)
- (void)sj_addObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath;
@end
@interface SJObserverHelper : NSObject
@property (nonatomic, unsafe_unretained) id target;
@property (nonatomic, unsafe_unretained) id observer;
@property (nonatomic, strong) NSString *keyPath;
@property (nonatomic, weak) SJObserverHelper *factor;
@end
@implementation SJObserverHelper
- (void)dealloc {
if ( _factor ) {
[_target removeObserver:_observer forKeyPath:_keyPath];
}
}
@end
@implementation NSObject (ObserverHelper)
- (void)sj_addObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath {
[self addObserver:observer forKeyPath:keyPath options:NSKeyValueObservingOptionNew context:nil];
SJObserverHelper *helper = [SJObserverHelper new];
SJObserverHelper *sub = [SJObserverHelper new];
sub.target = helper.target = self;
sub.observer = helper.observer = observer;
sub.keyPath = helper.keyPath = keyPath;
helper.factor = sub;
sub.factor = helper;
const char *helpeKey = [NSString stringWithFormat:@"%zd", [observer hash]].UTF8String;
objc_setAssociatedObject(self, helpeKey, helper, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
objc_setAssociatedObject(observer, helpeKey, sub, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
@end
复制代码
下面来说说一步一步的实现吧:
初步思路实现
我们都知道, 对象被释放之前, 会调用dealloc
方法, 其持有的实例变量也会被释放.
我就这样想, 在监听注册时, 为self
和Observer
关联个临时对象, 当两者在释放实例变量时, 我借助这个时机, 在临时对象的dealloc
方法中, 移除Observer
就行了.
想法很好, 可总不能每个类里都加一个临时对象的属性吧. 那如何在不改变原有类的情况下, 为其关联一个临时对象呢?
关联属性
不改变原有类, 这时候肯定是要用Category
了, 系统框架里面有很多的分类, 并且有很多的关联属性, 如下图 UIView 头文件第180行:
依照上图, 我们先看一个示例, 为NSObject
的添加一个Category
, 并添加了一个property
, 在.m
中实现了它的setter
和getter
方法.
#import <objc/message.h>
@interface NSObject (Associate)
@property (nonatomic, strong) id tmpObj;
@end
@implementation NSObject (Associate)
static const char *testKey = "TestKey";
- (void)setTmpObj:(id)tmpObj {
// objc_setAssociatedObject(id object, const void *key, id value, objc_AssociationPolicy policy)
objc_setAssociatedObject(self, testKey, tmpObj, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
- (id)tmpObj {
// objc_getAssociatedObject(id object, const void *key)
return objc_getAssociatedObject(self, testKey);
}
@end
复制代码
很明确, objc_setAssociatedObject
便是关联属性的setter
方法, 而objc_getAssociatedObject
便是关联属性的getter
方法. 最需要关注的就是setter
方法, 因为我们要用来添加关联属性对象.
初步思路探索
初步尝试: 既然属性可以随时使用objc_setAssociatedObject
关联了, 那我就尝试先为self
关联一个临时对象
, 在其dealloc
中, 将Observer
移除.
@interface SJObserverHelper : NSObject
@property (nonatomic, weak) id target;
@property (nonatomic, weak) id observer;
@property (nonatomic, strong) NSString *keyPath;
@end
@implementation SJObserverHelper
- (void)dealloc {
[_target removeObserver:_observer forKeyPath:_keyPath];
}
@end
- (void)addObserver {
NSString *keyPath = @"name";
[_xiaoM addObserver:_observer forKeyPath:keyPath options:NSKeyValueObservingOptionNew context:nil];
SJObserverHelper *helper_obj = [SJObserverHelper new];
helper_obj.target = _xiaoM;
helper_obj.observer = _observer;
helper_obj.keyPath = keyPath;
const char *helpeKey = [NSString stringWithFormat:@"%zd", [_observer hash]].UTF8String;
// 关联
objc_setAssociatedObject(_xiaoM, helpeKey, helper_obj, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
复制代码
于是, 美滋滋的运行了一下程序, 当将_xiaoM 置为 nil 时, 砰
App Crash......
reason: 'An instance 0x12cd1c370 of class Person was deallocated while key value observers were still registered with it.
复制代码
分析: 临时对象的dealloc
, 确确实实的跑了. 为什么会还有registered? 于是我尝试在临时对象
的dealloc
中, 打印实例变量target
, 发现其为nil. 好吧, 这就是Crash问题原因!
尝试 unsafe_unretained
通过上面操作, 我们知道self
在被释放之前, 会先释放其持有的关联属性, 在析构期间, 可以确定self
还是存在的, 并未完全释放, 可在临时对象中target
却成了nil
. 那如何保持不为nil呢?
我们看看OC中的两个修饰符weak
与unsafe_unretained
:
- weak: 持有者的实例变量不会对目标进行retain, 当目标销毁时, 持有者的实例变量会被置空
- unsafe_unretained: 持有者的实例变量不会对目标进行retain, 当目标释放后, 持有者的实例变量还会依然指向之前的内存空间(野指针)
由上, unsafe_unretained
很好的解决了我们的问题. 于是我做了如下修改:
@interface SJObserverHelper : NSObject
@property (nonatomic, unsafe_unretained) id target;
@property (nonatomic, unsafe_unretained) id observer;
@property (nonatomic, strong) NSString *keyPath;
@end
复制代码
再次运行程序, 还行, 观察者移除了.
最终实现
还存在的问题
目前, 我们只是实现了, 如何在self
释放的时候, 移除自己身上的Observer
. 但如果Observer
提前释放了呢? 而添加关联属性, 两者还不能同时持有临时对象
, 否则临时对象也不会及时的释放.
好吧, 既然一个不行, 那就各自关联一个:
- (void)addObserver {
.....
SJObserverHelper *helper_obj = [SJObserverHelper new];
SJObserverHelper *sub_obj = [SJObserverHelper new];
sub_obj.target = helper_obj.target = _xiaoM;
sub_obj.observer = helper_obj.observer = _observer;
sub_obj.keyPath = helper_obj.keyPath = keyPath;
const char *helpeKey = [NSString stringWithFormat:@"%zd", [_observer hash]].UTF8String;
// 关联
objc_setAssociatedObject(_xiaoM, helpeKey, helper_obj, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
// 关联
objc_setAssociatedObject(_observer, helpeKey, sub_obj, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
复制代码
如上, 仔细想想, 存在一个很明显的问题, 两个关联属性释放的同时, 进行了两次观察移除的操作. 为避免这个问题, 我又做了如下修改:
@interface SJObserverHelper : NSObject
@property (nonatomic, unsafe_unretained) id target;
@property (nonatomic, unsafe_unretained) id observer;
@property (nonatomic, strong) NSString *keyPath;
@property (nonatomic, weak) SJObserverHelper *factor; // 1. 新增一个 weak 变量
@end
@implementation SJObserverHelper
- (void)dealloc {
if ( _factor ) {
[_target removeObserver:_observer forKeyPath:_keyPath];
}
}
@end
- (void)addObserver {
.....
SJObserverHelper *helper_obj = [SJObserverHelper new];
SJObserverHelper *sub_obj = [SJObserverHelper new];
sub_obj.target = helper_obj.target = _xiaoM;
sub_obj.observer = helper_obj.observer = _observer;
sub_obj.keyPath = helper_obj.keyPath = keyPath;
// 2. 互相 weak 引用
helper_obj.factor = sub_obj;
sub_obj.factor = helper_obj;
const char *helpeKey = [NSString stringWithFormat:@"%zd", [_observer hash]].UTF8String;
// 关联
objc_setAssociatedObject(_xiaoM, helpeKey, helper_obj, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
// 关联
objc_setAssociatedObject(_observer, helpeKey, sub_obj, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
复制代码
在之前的操作中, 我们知道, weak 修饰的变量, 在目标释放时,持有者的实例变量都会自动置为nil, 因此如上dealloc
方法中, 我们只需要判断weak
引用的实例变量factor
是否为空即可.
抽取
以上操作, 我们就可以解决偶尔忘记写移除Observer
的代码了. 现在只需要把实现抽取出来, 做成一个通用的工具方法:
我新建了一个NSObject
的Category
, 并添加了一个方法, 如下:
然后将上述的实现进行了整合放到了.m
中:
到此, 以后只需要调用- (void)sj_addObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath;
这个方法即可, 移除就交给临时变量自己搞定.