操作符
RxJava 常用操作符
本文首先会给出
如果你想实现你自己的操作符,可以参考这里:实现自定义操作符
创建操作
用于创建
Create: 通过调用观察者的方法从头创建一个Observable Defer: 在观察者订阅之前不创建这个Observable ,为每一个观察者创建一个新的Observable Empty/Never/Throw: 创建行为受限的特殊Observable From: 将其它的对象或数据结构转换为Observable Interval: 创建一个定时发射整数序列的Observable Just: 将对象或者对象集合转换为一个会发射这些对象的Observable Range: 创建发射指定范围的整数序列的Observable Repeat: 创建重复发射特定的数据或数据序列的Observable Start: 创建发射一个函数的返回值的Observable Timer: 创建在一个指定的延迟之后发射单个数据的Observable
变换操作
这些操作符可用于对
Buffer: 缓存,可以简单的理解为缓存,它定期从Observable 收集数据到一个集合,然后把这些数据集合打包发射,而不是一次发射一个FlatMap: 扁平映射,将Observable 发射的数据变换为Observables 集合,然后将这些Observable 发射的数据平坦化的放进一个单独的Observable ,可以认为是一个将嵌套的数据结构展开的过程。GroupBy: 分组,将原来的Observable 分拆为Observable 集合,将原始Observable 发射的数据按Key 分组,每一个Observable 发射一组不同的数据Map: 映射,通过对序列的每一项都应用一个函数变换Observable 发射的数据,实质是对序列中的每一项执行一个函数,函数的参数就是这个数据项Scan: 扫描,对Observable 发射的每一项数据应用一个函数,然后按顺序依次发射这些值Window: 窗口,定期将来自Observable 的数据分拆成一些Observable 窗口,然后发射这些窗口,而不是每次发射一项。类似于Buffer ,但Buffer 发射的是数据,Window 发射的是Observable ,每一个Observable 发射原始Observable 的数据的一个子集
过滤操作
这些操作符用于从
Debounce: 只有在空闲了一段时间后才发射数据,通俗的说,就是如果一段时间没有操作,就执行一次操作Distinct: 去重,过滤掉重复数据项ElementAt: 取值,取特定位置的数据项Filter: 过滤,过滤掉没有通过谓词测试的数据项,只发射通过测试的First: 首项,只发射满足条件的第一条数据IgnoreElements: 忽略所有的数据,只保留终止通知(onError 或onCompleted) Last: 末项,只发射最后一条数据Sample: 取样,定期发射最新的数据,等于是数据抽样,有的实现里叫ThrottleFirst Skip: 跳过前面的若干项数据SkipLast: 跳过后面的若干项数据Take: 只保留前面的若干项数据TakeLast: 只保留后面的若干项数据
组合操作
组合操作符用于将多个
And/Then/When: 通过模式(And 条件) 和计划(Then 次序) 组合两个或多个Observable 发射的数据集CombineLatest: 当两个Observables 中的任何一个发射了一个数据时,通过一个指定的函数组合每个Observable 发射的最新数据(一共两个数据) ,然后发射这个函数的结果Join: 无论何时,如果一个Observable 发射了一个数据项,只要在另一个Observable 发射的数据项定义的时间窗口内,就将两个Observable 发射的数据合并发射Merge: 将两个Observable 发射的数据组合并成一个StartWith: 在发射原来的Observable 的数据序列之前,先发射一个指定的数据序列或数据项Switch: 将一个发射Observable 序列的Observable 转换为这样一个Observable :它逐个发射那些Observable 最近发射的数据Zip: 打包,使用一个指定的函数将多个Observable 发射的数据组合在一起,然后将这个函数的结果作为单项数据发射
错误处理
这些操作符用于从错误通知中恢复
Catch: 捕获,继续序列操作,将错误替换为正常的数据,从onError 通知中恢复Retry: 重试,如果Observable 发射了一个错误通知,重新订阅它,期待它正常终止
辅助操作
一组用于处理
Delay: 延迟一段时间发射结果数据Do: 注册一个动作占用一些Observable 的生命周期事件,相当于Mock 某个操作Materialize/Dematerialize: 将发射的数据和通知都当做数据发射,或者反过来ObserveOn: 指定观察者观察Observable 的调度程序(工作线程)Serialize: 强制Observable 按次序发射数据并且功能是有效的Subscribe: 收到Observable 发射的数据和通知后执行的操作SubscribeOn: 指定Observable 应该在哪个调度程序上执行TimeInterval: 将一个Observable 转换为发射两个数据之间所耗费时间的Observable Timeout: 添加超时机制,如果过了指定的一段时间没有发射数据,就发射一个错误通知Timestamp: 给Observable 发射的每个数据项添加一个时间戳Using: 创建一个只在Observable 的生命周期内存在的一次性资源
条件和布尔操作
这些操作符可用于单个或多个数据项,也可用于
All: 判断Observable 发射的所有的数据项是否都满足某个条件Amb: 给定多个Observable ,只让第一个发射数据的Observable 发射全部数据Contains: 判断Observable 是否会发射一个指定的数据项DefaultIfEmpty: 发射来自原始Observable 的数据,如果原始Observable 没有发射数据,就发射一个默认数据SequenceEqual: 判断两个Observable 是否按相同的数据序列SkipUntil: 丢弃原始Observable 发射的数据,直到第二个Observable 发射了一个数据,然后发射原始Observable 的剩余数据SkipWhile: 丢弃原始Observable 发射的数据,直到一个特定的条件为假,然后发射原始Observable 剩余的数据TakeUntil: 发射来自原始Observable 的数据,直到第二个Observable 发射了一个数据或一个通知TakeWhile: 发射原始Observable 的数据,直到一个特定的条件为真,然后跳过剩余的数据
算术和聚合操作
这些操作符可用于整个数据序列
Average: 计算Observable 发射的数据序列的平均值,然后发射这个结果Concat: 不交错的连接多个Observable 的数据Count: 计算Observable 发射的数据个数,然后发射这个结果Max: 计算并发射数据序列的最大值Min: 计算并发射数据序列的最小值Reduce: 按顺序对数据序列的每一个应用某个函数,然后返回这个值Sum: 计算并发射数据序列的和
连接操作
一些有精确可控的订阅行为的特殊
Connect: 指示一个可连接的Observable 开始发射数据给订阅者Publish: 将一个普通的Observable 转换为可连接的RefCount: 使一个可连接的Observable 表现得像一个普通的Observable Replay: 确保所有的观察者收到同样的数据序列,即使他们在Observable 开始发射数据之后才订阅
转换操作
To: 将Observable 转换为其它的对象或数据结构Blocking: 阻塞Observable 的操作符
操作符决策树
几种主要的需求
- 直接创建一个
Observable (创建操作) - 组合多个
Observable (组合操作) - 对
Observable 发射的数据执行变换操作(变换操作) - 从
Observable 发射的数据中取特定的值(过滤操作) - 转发
Observable 的部分值(条件/ 布尔/ 过滤操作) - 对
Observable 发射的数据序列求值(算术/ 聚合操作)