RxCocoa(scrollView.rx.didScroll
)
得益于RxCocoa对UIKit做了extension,我们使用UI组件的Rx封装时只需要调用rx
属性,就可以访问到Rx框架的内容。比如需要订阅UIScrollView的滚动事件:
1
2
3
4
5
scrollView
.rx.didScroll
.subscribe(onNext: { () in
print("scroll view did scroll")
})
But, why???
在原生的Cocoa框架中,要监听UIScrollView的滑动事件,需要通过实现UIScrollViewDelegate协议的scrollViewDidScroll
函数。但是RxCocoa为何可以让用户通过简单的调用就得到了回调?UIScrollViewDelegate是如何被隐藏的?
rx
属性是怎么来的?
Reactive&ReactiveCompatible
通过查看,rx
属性是一个Reactive
的类型。在Reactive.swift文件,可以看到它是一个泛型struct 。而rx
是在一个ReactiveCompatible
的protocol里面定义的。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
public struct Reactive<Base> {
/// Base object to extend.
public let base: Base
/// Creates extensions with base object.
///
/// - parameter base: Base object.
public init(_ base: Base) {
self.base = base
}
}
/// A type that has reactive extensions.
public protocol ReactiveCompatible {
/// Extended type
associatedtype CompatibleType
/// Reactive extensions.
static var rx: Reactive<CompatibleType>.Type { get set }
/// Reactive extensions.
var rx: Reactive<CompatibleType> { get set }
}
extension ReactiveCompatible {
/// Reactive extensions.
public static var rx: Reactive<Self>.Type {
get {
return Reactive<Self>.self
}
set {
// this enables using Reactive to "mutate" base type
}
}
/// Reactive extensions.
public var rx: Reactive<Self> {
get {
return Reactive(self)
}
set {
// this enables using Reactive to "mutate" base object
}
}
}
import class Foundation.NSObject
/// Extend NSObject with `rx` proxy.
extension NSObject: ReactiveCompatible { }
可以看到Reactive
的定义非常简单,只有一个base
属性,而这个属性是一个泛型。
在文件的最后一行,NSObject被声明了实现ReactiveCompatible
,因此UIScrollView也实现了该协议。
查看ReactiveCompatible
的定义以及其下方的extension就可以看出,rx
属性的泛型是该类型本身,也就是说UISCrollView的rx
属性就是一个UISCrollView泛型的Reactive
结构体,其base
属性就是这个UIScrollView本身的实例。
顺着往下看,可以在UIScrollView+Rx.swift文件里找到,是通过extension的where语法对UIScrollView泛型的Reactive
添加的一个计算型属性。
1
2
3
4
5
6
7
8
9
10
11
12
13
extension Reactive where Base: UIScrollView {
...
...
...
/// Reactive wrapper for delegate method `scrollViewDidScroll`
public var didScroll: ControlEvent<Void> {
let source = RxScrollViewDelegateProxy.proxy(for: base).contentOffsetPublishSubject
return ControlEvent(events: source)
}
...
...
...
}
从命名可以看出,RxScrollViewDelegateProxy
是一个实现UIScrollViewDelegate
的代理类型。
暂时不探究RxScrollViewDelegateProxy
的proxy(for:)
函数,比较好理解,source
是通过一个对应UISrollView实例获得的RxScrollViewDelegateProxy
的一个UIScrollView的contentOffset事件广播,函数最后再把这个广播封装成一个ControlEvent
类型实例,也就是被订阅的那个事件。
而关键就在于RxScrollViewDelegateProxy
这个类型做了什么事情。
RxScrollViewDelegateProxy
继续查看RxScrollViewDelegateProxy.swift文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
/// For more information take a look at `DelegateProxyType`.
open class RxScrollViewDelegateProxy
: DelegateProxy<UIScrollView, UIScrollViewDelegate>
, DelegateProxyType
, UIScrollViewDelegate {
...
...
...
fileprivate var _contentOffsetPublishSubject: PublishSubject<()>?
...
/// Optimized version used for observing content offset changes.
internal var contentOffsetPublishSubject: PublishSubject<()> {
if let subject = _contentOffsetPublishSubject {
return subject
}
let subject = PublishSubject<()>()
_contentOffsetPublishSubject = subject
return subject
}
...
...
...
}
RxScrollViewDelegateProxy
继承了DelegateProxy
,并实现了两个协议:
- DelegateProxyType
- UIScrollViewDelegate
显然这里就是UIScrollViewDelegate的藏身点,下面继续看在这里它是如何被黑盒化的。
在这个文件里可以找到原始回调的函数:
1
2
3
4
5
6
7
8
9
10
/// For more information take a look at `DelegateProxyType`.
public func scrollViewDidScroll(_ scrollView: UIScrollView) {
if let subject = _contentOffsetBehaviorSubject {
subject.on(.next(scrollView.contentOffset))
}
if let subject = _contentOffsetPublishSubject {
subject.on(.next(()))
}
self._forwardToDelegate?.scrollViewDidScroll?(scrollView)
}
在回调的处理上,做了3件事:
- 发送contentOffset的数值变化广播
- 发送contentOffset变化的事件广播
- 调用了
_forwardToDelegate
属性的另一个scrollViewDidScroll函数
可以看到两个广播事件应该是按需发送的,如果在没有订阅者的情况下,应该不会产生对应的属性。而在上面被订阅的的contentOffsetPublishSubject
就是这个_contentOffsetPublishSubject
。
而_forwardToDelegate
应该是开发者在外部设置的delegate,也就是说:
即使开发者已经为一个UIScrollView设置了delegate(或者没有设置),也不会影响通过RxCocoa框架去订阅这个UIScrollView的事件。 而且可以有多个订阅者通过RxCocoa去订阅UIScrollView的回调事件,因为这里的Observable
是广播类型。
可见在RxCocoa中,每一个有事件订阅者的UIScrollView都有与之对应的RxScrollViewDelegateProxy
实例。所以下一个问题就是:
代码RxScrollViewDelegateProxy.proxy(for: base)
当中,proxy(for:)
函数是如何把一个RxScrollViewDelegateProxy
绑定到一个UIScrollView上的?
DelegateProxyType
可以查看到proxy(for:)
函数被定义在DelegateProxyType
协议里,通过extension实现。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
/// Returns existing proxy for object or installs new instance of delegate proxy.
///
/// - parameter object: Target object on which to install delegate proxy.
/// - returns: Installed instance of delegate proxy.
///
///
/// extension Reactive where Base: UISearchBar {
///
/// public var delegate: DelegateProxy<UISearchBar, UISearchBarDelegate> {
/// return RxSearchBarDelegateProxy.proxy(for: base)
/// }
///
/// public var text: ControlProperty<String> {
/// let source: Observable<String> = self.delegate.observe(#selector(UISearchBarDelegate.searchBar(_:textDidChange:)))
/// ...
/// }
/// }
public static func proxy(for object: ParentObject) -> Self {
MainScheduler.ensureExecutingOnScheduler()
let maybeProxy = self.assignedProxy(for: object)
let proxy: AnyObject
if let existingProxy = maybeProxy {
proxy = existingProxy
}
else {
proxy = castOrFatalError(self.createProxy(for: object))
self.assignProxy(proxy, toObject: object)
assert(self.assignedProxy(for: object) === proxy)
}
let currentDelegate = self._currentDelegate(for: object)
let delegateProxy: Self = castOrFatalError(proxy)
if currentDelegate !== delegateProxy {
delegateProxy._setForwardToDelegate(currentDelegate, retainDelegate: false)
assert(delegateProxy._forwardToDelegate() === currentDelegate)
self._setCurrentDelegate(proxy, to: object)
assert(self._currentDelegate(for: object) === proxy)
assert(delegateProxy._forwardToDelegate() === currentDelegate)
}
return delegateProxy
}
这个函数的参数只有1个ParentObject
类型,其实在协议中定义了,就是一个AnyObject类型。
可以看到,这个操作需要确保在主线程上进行,换句话说,开发者不可以在子线程上订阅UIScrollView的回调事件。然后调用一个assignedProxy
函数获取一个maybeProxy
结果。而这个函数做的事情,就是通过runtime的objc_getAssociatedObject函数在ParentObject
上查询是否有绑定的对象,使用的key是该DelegateProxyType
实例本身的identifier
变量。(此处有一个由Swift编译器引起的bug,Rx团队需要对objc_getAssociatedObject的直接结果做一个处理才可以返回,暂时不探究。)
看到这里已经可以看出:
RxCocoa可以让开发者跳过实现Delegate函数直接获取UIKit组件的回调,其实是通过runtime把一个已经实现了Delegate的Proxy绑定到了这个组件上。
继续看完这个函数,如果maybeProxy
得出的结果是空的,就会通过createProxy
创建一个新的Self
实例并绑定到UIScrollView
的实例上。这里的Self
对应的是那个实现DelegateProxyType
的类型,对应上当前场景的就是RxScrollViewDelegateProxy
。并且在绑定完成后再做了一次判断,确保对应identifier
绑定的实例就是刚刚新创建出来的那个。(猜测:为了避免有别的线程也使用同样的identifier绑定了其他实例?)
然后通过函数_currentDelegate(for:)
获取当前UIScrollView的delegate,这是一个抽象函数,具体返回的”delegate”是根据传入参数实现的协议来定,详情可以在同一个文件下找到,分别有以下几种情况:
-
ParentObject: HasDelegate, Self.Delegate == ParentObject.Delegate
-
ParentObject: HasDataSource, Self.Delegate == ParentObject.DataSource
-
ParentObject: HasPrefetchDataSource, Self.Delegate == ParentObject.PrefetchDataSource
目前场景下属于情况1,所以看这个extension里面的实现,实际上是返回了传入参数的的delegate,而在RxScrollViewDelegateProxy.swift文件里就可以看到有UIScrollView的HasDelegate
实现,这个delegate其实就是UIScrollViewDelegate。
拿到这个delegate后,会和上面的proxy做对比(在对比之前又做了一次对proxy的判断,确认其类型就是当前需要的DelegateProxy),然后做托管处理。也就是说,如果在开发者设置订阅UIScrollView之前,UIScrollView已经有一个delegate,在这里就会把这个delegate托管给proxy,让proxy在收到UIScrollView回调的时候转发给delegate,而实际上UIScrollView此时的delegate指向的是proxy。通过proxy的forwardToDelegate
可以找回这个在外部设置的delegate。
持续更新...