原文链接:[https://www.jianshu.com/p/f61a5a988590], 此文为笔记整理,感谢原作者
1.变换操作(Transforming Observables)
buffer
buffer
方法作用是缓冲组合,第一个参数是缓冲时间,第二个参数是缓冲个数,第三个参数是线程。
该方法简单来说就是缓存Observable
中发出的新元素,当元素达到某个数量,或者经过了特定的时间,它就会将这个元素集合发送出来。window
window
操作符和buffer
十分相似。不过buffer
是周期性的将缓存的元素集合发送出来,而window
周期性的将元素集合以Observable
的形态发送出来。
同时buffer
要等到元素搜集完毕后,才会发出元素序列。而window
可以实时发出元素序列。map
该操作符通过传入一个函数闭包把原来的Observable
序列转变为一个新的Observable
序列。flatMap
map
在做转换的时候容易出现“升维”的情况。即转变之后,从一个序列变成了一个序列的序列。
而flatMap
操作符会对源Observable
的每一个元素应用一个转换方法,将他们转换成Observables
。 然后将这些Observables
的元素合并之后再发送出来。即又将其 "拍扁"(降维)成一个Observable
序列。
这个操作符是非常有用的。比如当Observable
的元素本生拥有其他的Observable
时,我们可以将所有子Observables
的元素发送出来。flatMapLatest
flatMapLatest
与flatMap
的唯一区别是:flatMapLatest
只会接收最新的value
事件。concatMap
concatMap
与flatMap
的唯一区别是:当前一个Observable
元素发送完毕后,后一个Observable
才可以开始发出元素。或者说等待前一个Observable
产生完成事件后,才对后一个Observable
进行订阅。scan
scan
就是先给一个初始化的数,然后不断的拿前一个结果和最新的值进行处理操作。groupBy
groupBy
操作符将源Observable
分解为多个子Observable
,然后将这些子Observable
发送出来。
也就是说该操作符会将元素通过某个键进行分组,然后将分组后的元素序列以Observable
的形态发送出来。
2.过滤操作符(Filtering Observables)
filter
该操作符就是用来过滤掉某些不符合要求的事件。distinctUntilChanged
该操作符用于过滤掉连续重复的事件。single
限制只发送一次事件,或者满足条件的第一个事件。
如果存在有多个事件或者没有事件都会发出一个 error 事件。
如果只有一个事件,则不会发出 error事件。elementAt
该方法实现只处理在指定位置的事件。ignoreElements
该操作符可以忽略掉所有的元素,只发出error
或completed
事件。
如果我们并不关心Observable
的任何元素,只想知道Observable
在什么时候终止,那就可以使用ignoreElements
操作符。take
该方法实现仅发送Observable
序列中的前 n 个事件,在满足数量之后会自动.completed
。takeLast
该方法实现仅发送Observable
序列中的后 n 个事件。skip
该方法用于跳过源Observable
序列发出的前 n 个事件。Sample
Sample
除了订阅源Observable
外,还可以监视另外一个Observable
, 即notifier
。
每当收到notifier
事件,就会从源序列取一个最新的事件并发送。而如果两次notifier
事件之间没有源序列的事件,则不发送值。debounce
debounce
操作符可以用来过滤掉高频产生的元素,它只会发出这种元素:该元素产生后,一段时间内没有新元素产生。
换句话说就是,队列中的元素如果和下一个元素的间隔小于了指定的时间间隔,那么这个元素将被过滤掉。
debounce
常用在用户输入的时候,不需要每个字母敲进去都发送一个事件,而是稍等一下取最后一个事件。
3.条件和布尔操作符(Conditional and Boolean Operators)
amb
当传入多个Observables
到amb
操作符时,它将取第一个发出元素或产生事件的Observable
,然后只发出它的元素。并忽略掉其他的Observables
。takeWhile
该方法依次判断Observable
序列的每一个值是否满足给定的条件。 当第一个不满足条件的值出现时,它便自动完成。takeUntil
除了订阅源Observable
外,通过takeUntil
方法我们还可以监视另外一个Observable
, 即notifier
。
如果notifier
发出值或complete
通知,那么源Observable
便自动完成,停止发送事件skipWhile
该方法用于跳过前面所有满足条件的事件。
一旦遇到不满足条件的事件,之后就不会再跳过了。skipUntil
同上面的takeUntil
一样,skipUntil
除了订阅源Observable
外,通过skipUntil
方法我们还可以监视另外一个Observable
, 即notifier
。
与takeUntil
相反的是。源Observable
序列事件默认会一直跳过,直到notifier
发出值或complete
通知。
4.结合操作(Combining Observables)
startWith
该方法会在Observable
序列开始之前插入一些事件元素。即发出事件消息之前,会先发出这些预先插入的事件消息。merge
该方法可以将多个(两个或两个以上的)Observable
序列合并成一个Observable
序列zip
该方法可以将多个(两个或两个以上的)Observable
序列压缩成一个Observable
序列。
而且它会等到每个Observable
事件一一对应地凑齐之后再合并。combineLatest
该方法同样是将多个(两个或两个以上的)Observable
序列元素进行合并。
但与zip
不同的是,每当任意一个Observable
有新的事件发出时,它会将每个Observable
序列的最新的一个事件元素进行合并。withLatestFrom
该方法将两个Observable
序列合并为一个。每当self
队列发射一个元素时,便从第二个序列中取出最新的一个值。switchLatest
switchLatest
有点像其他语言的switch
方法,可以对事件流进行转换。
比如本来监听的subject1
,我可以通过更改variable
里面的value
更换事件源。变成监听subject2
。
5.算数、以及聚合操作(Mathematical and Aggregate Operators)
toArray
该操作符先把一个序列转成一个数组,并作为一个单一的事件发送,然后结束。reduce
reduce
接受一个初始值,和一个操作符号。
reduce
将给定的初始值,与序列里的每个值进行累计运算。得到一个最终结果,并将其作为单个值发送出去。concat
concat
会把多个Observable
序列合并(串联)为一个Observable
序列。
并且只有当前面一个Observable
序列发出了completed
事件,才会开始发送下一个Observable
序列事件。
6.连接操作(Connectable Observable Operators)
可连接的序列和一般序列不同在于:有订阅时不会立刻开始发送事件消息,只有当调用 connect()
之后才会开始发送值。
可连接的序列可以让所有的订阅者订阅后,才开始发出事件消息,从而保证我们想要的所有订阅者都能接收到事件消息。
publish
publish
方法会将一个正常的序列转换成一个可连接的序列。同时该序列不会立刻发送事件,只有在调用connect
之后才会开始。replay
replay
同上面的publish
方法相同之处在于:会将将一个正常的序列转换成一个可连接的序列。同时该序列不会立刻发送事件,只有在调用connect
之后才会开始。
replay
与publish
不同在于:新的订阅者还能接收到订阅之前的事件消息(数量由设置的bufferSize
决定)。multicast
multicast
方法同样是将一个正常的序列转换成一个可连接的序列。
同时multicast
方法还可以传入一个Subject
,每当序列发送事件时都会触发这个Subject
的发送。refCount
refCount
操作符可以将可被连接的Observable
转换为普通Observable
即该操作符可以自动连接和断开可连接的Observable
。当第一个观察者对可连接的Observable
订阅时,那么底层的Observable
将被自动连接。当最后一个观察者离开时,那么底层的Observable
将被自动断开连接。share(relay:)
该操作符将使得观察者共享源Observable
,并且缓存最新的n
个元素,将这些元素直接发送给新的观察者。
简单来说shareReplay
就是replay
和refCount
的组合。
6.其他实用的操作符(Observable Utility Operators)
delay
该操作符会将Observable
的所有元素都先拖延一段设定好的时间,然后才将它们发送出来。delaySubscription
使用该操作符可以进行延时订阅。即经过所设定的时间后,才对Observable
进行订阅操作。materialize
该操作符可以将序列产生的事件,转换成元素。
通常一个有限的Observable
将产生零个或者多个onNext
事件,最后产生一个onCompleted
或者onError
事件。而materialize
操作符会将Observable
产生的这些事件全部转换成元素,然后发送出来。dematerialize
该操作符的作用和materialize
正好相反,它可以将materialize
转换后的元素还原。timeout
使用该操作符可以设置一个超时时间。如果源Observable
在规定时间内没有发任何出元素,就产生一个超时的error
事件。using
使用using
操作符创建Observable
时,同时会创建一个可被清除的资源,一旦Observable
终止了,那么这个资源就会被清除掉了。