RxSwift 文档:Observable
RxSwift 文档:Observable
轩辕十四Observable - 可被监听的序列
所有的事物都是序列
Observable
可以用于描述元素异步产生的序列。这样我们生活中许多事物都可以通过它来表示。
如何创建序列
创建序列最直接的方法就是调用 Observable.create
,然后在构建函数里面描述元素的产生过程。 observer.onNext(0)
就代表产生了一个元素,他的值是 0
。后面又产生了 9
个元素分别是 1, 2, ... 8, 9
。最后,用 observer.onCompleted()
表示元素已经全部产生,没有更多元素了。
你可以用这种方式来封装功能组件,例如,闭包回调:
1 | typealias JSON = Any |
在闭包回调中,如果任务失败,就调用 observer.onError(error!)
。如果获取到目标元素,就调用 observer.onNext(jsonObject)
。由于我们的这个序列只有一个元素,所以在成功获取到元素后,就直接调用 observer.onCompleted()
来表示任务结束。最后 Disposables.create { task.cancel() }
说明如果数据绑定被清除(订阅被取消)的话,就取消网络请求。
这样一来我们就将传统的闭包回调转换成序列了。然后可以用 subscribe
方法来响应这个请求的结果。
Single
Single
是 Observable
的另外一个版本。不像 Observable
可以发出多个元素,它要么只能发出一个元素,要么产生一个 error
事件。
- 发出一个元素,或一个 error 事件
- 不会共享状态变化
一个比较常见的例子就是执行 HTTP
请求,然后返回一个应答或错误。不过你也可以用 Single
来描述任何只有一个元素的序列。
如何创建 Single
创建 Single
和创建 Observable
非常相似:
1 | func getRepo(_ repo: String) -> Single<[String: Any]> { |
订阅提供一个 SingleEvent
的枚举:
1 | public enum SingleEvent<Element> { |
注意 Single
与普通 Observable
序列的事件枚举的不同。
Completable
Completable
是 Observable
的另外一个版本。不像 Observable
可以发出多个元素,它要么只能产生一个 completed
事件,要么产生一个 error
事件。
- 发出零个元素
- 发出一个
completed
事件或者一个error
事件 - 不会共享状态变化
Completable
适用于那种你只关心任务是否完成,而不需要在意任务返回值的情况。它和 Observable<Void>
有点相似。
如何创建 Completable
1 | func cacheLocally() -> Completable { |
订阅提供一个 CompletableEvent
的枚举:
1 | public enum CompletableEvent { |
Maybe
Maybe
是 Observable
的另外一个版本。它介于 Single
和 Completable
之间,它要么只能发出一个元素,要么产生一个 completed
事件,要么产生一个 error
事件。
发出一个元素或者一个 completed
事件或者一个 error
事件
不会共享状态变化
如果你遇到那种可能需要发出一个元素,又可能不需要发出时,就可以使用 Maybe
。
如何创建 Maybe
1 | func generateString() -> Maybe<String> { |
Driver
Driver
是一个精心准备的特征序列。它主要是为了简化 UI
层的代码。不过如果你遇到的序列具有以下特征,你也可以使用它:
- 不会产生
error
事件 - 一定在
MainScheduler
监听(主线程监听) - 共享状态变化
这些都是驱动 UI
的序列所具有的特征。
为什么要使用 Driver ?
我们举个例子来说明一下,为什么要使用 Driver
。
1 | let results = query.rx.text |
这段代码的主要目的是:
- 取出用户输入稳定后的内容
- 向服务器请求一组结果
- 将返回的结果绑定到两个
UI
元素上:tableView
和 显示结果数量的label
那么这里存在什么问题?
- 如果
fetchAutoCompleteItems
的序列产生了一个错误(网络请求失败),这个错误将取消所有绑定,当用户输入一个新的关键字时,是无法发起新的网络请求。 - 如果
fetchAutoCompleteItems
在后台返回序列,那么刷新页面也会在后台进行,这样就会出现异常崩溃。 - 返回的结果被绑定到两个
UI
元素上。那就意味着,每次用户输入一个新的关键字时,就会分别为两个UI
元素发起HTTP
请求,这并不是我们想要的结果。
一个更好的方案是这样的:
1 | let results = query.rx.text |
以下是使用 Driver
优化后的代码:
1 | let results = query.rx.text.asDriver() // 将普通序列转换为 Driver |
任何可被监听的序列都可以被转换为 Driver
,只要他满足 3 个条件:
- 不会产生
error
事件 - 一定在
MainScheduler
监听(主线程监听) - 共享状态变化
那么要如何确定条件都被满足?通过 Rx 操作符来进行转换。asDriver(onErrorJustReturn: [])
相当于以下代码:
1 | let safeSequence = xs |
最后使用 drive
而不是 bindTo
drive
方法只能被 Driver
调用。这意味着,如果你发现代码所存在 drive
,那么这个序列不会产生错误事件并且一定在主线程监听。这样你可以安全的绑定 UI
元素。
ControlEvent
ControlEvent
专门用于描述 UI 控件所产生的事件,它具有以下特征:
- 不会产生
error
事件 - 一定在
MainScheduler
订阅(主线程订阅) - 一定在
MainScheduler
监听(主线程监听) - 共享状态变化