NSObject+RACKVOWrapper.m
Last updated
Last updated
代码实现
这段Objective-C代码是ReactiveObjC库的一部分，实现了对NSObject类的扩展，提供了一个名为rac_observeKeyPath:的方法，用于观察对象的键路径变化。主要功能包括：
参数校验：确保传入的块（block）不为nil，并且键路径至少有一个组件。
初始化资源：创建必要的可释放对象（RACCompoundDisposable、RACSerialDisposable等），用于管理观察者的生命周期。
属性检查：检查目标对象的属性类型，决定是否需要在属性值被释放时触发回调。
添加释放观察者：为属性值的释放添加回调，确保在值被释放时调用指定的块。
添加键路径观察者：递归地为键路径的每个组件添加观察者，确保在值变化时调用指定的块。
初始值处理：如果指定了NSKeyValueObservingOptionInitial选项，则在观察开始时立即调用块。
资源管理：确保在观察者或目标对象被释放时，所有资源都被正确释放。
开始：方法开始执行。
参数校验：检查传入的块和键路径是否有效。
初始化资源：创建必要的可释放对象，用于管理观察者的生命周期。
属性检查：检查目标对象的属性类型，决定是否需要在属性值被释放时触发回调。
需要释放观察者?：根据属性类型决定是否需要添加释放观察者。
添加释放观察者：为属性值的释放添加回调。
跳过释放观察者：如果不需要添加释放观察者，则跳过此步骤。
添加键路径观察者：递归地为键路径的每个组件添加观察者。
有初始值?：检查是否需要处理初始值。
处理初始值：如果指定了NSKeyValueObservingOptionInitial选项，则在观察开始时立即调用块。
跳过初始值处理：如果不需要处理初始值，则跳过此步骤。
管理资源：确保在观察者或目标对象被释放时，所有资源都被正确释放。
返回可释放对象：返回一个可释放对象，用于手动停止观察。
相比系统自带的KVO，ReactiveObjC的RACKVOWrapper主要增加了以下几点功能和改进：
资源管理：
自动清理：使用RACDisposable和RACCompoundDisposable来管理观察者的生命周期，确保在对象释放时自动清理资源，避免内存泄漏。
复合Disposable：通过RACCompoundDisposable和RACSerialDisposable来管理多个Disposable对象，方便统一管理和释放。
增强的错误处理：
参数校验：在方法开始时对传入的参数进行校验，确保block和keyPath的有效性，提高代码的健壮性。
灵活的回调机制：
初始值处理：支持在观察开始时立即调用block处理初始值，通过NSKeyValueObservingOptionInitial选项控制。
优先通知：支持在值变化前调用block，通过NSKeyValueObservingOptionPrior选项控制。
属性类型检查：
属性检查：检查目标对象的属性类型，确定是否需要添加dealloc观察者，避免不必要的观察和潜在的错误。
嵌套键路径支持：
多级键路径：支持多级键路径的观察，通过递归调用rac_observeKeyPath方法，处理嵌套的键路径变化。
线程安全：
并发处理：在处理键路径变化时，使用RACSerialDisposable来确保线程安全，避免并发问题。
资源管理：
使用RACCompoundDisposable来管理多个Disposable对象，确保在对象释放时自动清理所有资源。
使用RACSerialDisposable来管理单个Disposable对象，确保在并发情况下正确处理资源。
增强的错误处理：
在方法开始时使用NSCParameterAssert对传入的参数进行校验，确保block和keyPath的有效性。
灵活的回调机制：
支持NSKeyValueObservingOptionInitial选项，可以在观察开始时立即调用block处理初始值。
支持NSKeyValueObservingOptionPrior选项，可以在值变化前调用block。
属性类型检查：
使用class_getProperty和rac_copyPropertyAttributes来获取属性的类型信息，判断是否需要添加dealloc观察者。
嵌套键路径支持：
通过递归调用rac_observeKeyPath方法，处理多级键路径的变化。
线程安全：
使用RACSerialDisposable来确保在并发情况下正确处理资源，避免并发问题。
这些改进使得RACKVOWrapper在使用KVO时更加安全、灵活和高效。
