rxjava操作符大全

本文转载自：http://m.2cto.com/kf/201606/516356.html

前言

把现在接触到的操作符全部整理进来，方便查阅，遇到新的也会添加进来。和<a href="https://github.com/baiiu/LearnTechDemo/tree/master/Rx%3Ca%20href=" http:="" www.2cto.com="" kf="" ware="" java="" "="" target="_blank" class="keylink" style="box-sizing: border-box; color: rgb(51, 51, 51); text-decoration: none; outline: none medium; transition: all 0.25s;">JavaLearn">RxJavaLearn 的README.md同步更新。

操作符决策树

直接创建一个Observable（创建操作） 组合多个Observable（组合操作） 对Observable发射的数据执行变换操作（变换操作） 从Observable发射的数据中取特定的值（过滤操作） 转发Observable的部分值（条件/布尔/过滤操作） 对Observable发射的数据序列求值（算术/聚合操作）

创建操作

用于创建Observable的操作符

Create
通过调用观察者的方法从头创建一个Observable

Empty/Never/Throw
创建行为受限的特殊Observable

Defer
在观察者订阅之前不创建这个Observable，为每一个观察者创建一个新的Observable

Just
将对象或者对象集合转换为一个会发射这些对象的Observable

From
将其它的对象或数据结构转换为Observable

Range
创建发射指定范围的整数序列的Observable,range操作符,发射从start开始的count个数

Interval
间隔一定时间发送一个数字,从0开始.本身运行在Schedulers.computation() 线程内

Repeat
Repeat作用在Observable上,会对其重复发射count次

Timer
Timer会在指定时间后发射一个数字0，注意其也是运行在computation Scheduler

变换操作

对Observable发射的数据进行变，能将数据转化为我们想要的格式，

Buffer
缓存，可以简单的理解为缓存，它定期从Observable收集数据到一个集合，然后把这些数据集合打包发射，而不是一次发射一个

FlatMap
扁平映射，将Observable发射的数据变换为Observables集合，然后将这些Observable发射的数据平坦化的放进一个单独的Observable，可以认为是一个将嵌套的数据结构展开的过程。

GroupBy
分组，将原来的Observable分拆为Observable集合，将原始Observable发射的数据按Key分组，每一个Observable发射一组不同的数据

Map
映射，通过对序列的每一项都应用一个函数变换Observable发射的数据，实质是对序列中的每一项执行一个函数，函数的参数就是这个数据项

Scan
扫描， 连续地对数据序列的每一项应用一个函数，然后连续发射结果,每一项结果基于之前的结果.累加器函数.

Window
窗口，定期将来自Observable的数据分拆成一些Observable窗口，然后发射这些窗口，而不是每次发射一项。类似于Buffer，但Buffer发射的是数据，Window发射的是Observable，每一个Observable发射原始Observable的数据的一个子集

toList
Returns an Observable that emits a single item, a list composed of all the items emitted by the source Observable. 将一个Observable转换为一个List.

过滤操作

滤掉数据集合中我们不想要的数据。用于从Observable发射的数据中进行选择。

throttleWithTimeout
源Observable每次发射出来一个数据后就会进行计时,如果在设定好的时间结束前源Observable有新的数据发射出来，这个数据就会被丢弃，同时重新开始计时。

Debounce
只有在空闲了一段时间后才发射数据，通俗的说，就是如果一段时间没有操作，就执行一次操作.还可以根据一个函数来进行限流。这个函数的返回值是一个临时Observable，
如果源Observable在发射一个新的数据的时候，上一个数据根据函数所生成的临时Observable还没有结束,没有调用onComplete，那么上一个数据就会被过滤掉。如果是最后一个,还是会发射.

Distinct
去重，过滤掉所有的重复数据项

DistinctUtilChanged
过滤掉相邻的重复项

ElementAt
取值，取特定位置的数据项

Filter
过滤，过滤掉没有通过谓词测试的数据项，只发射通过测试的

First
取满足条件的第一个,如无满足条件数据抛出异常.可以使用takeFisrt(),仅会调动onComplete.
有null数据时会抛空指针异常,要判空处理.
只取满足条件的第一个数据.可以和BlockingObservable连用。可以Observable.toBlocking或者BlockingObservable.from方法来将一个Observable对象转化为BlockingObservable对象

Last
末项，只发射最后一条数据.

IgnoreElements
忽略所有的数据，只保留终止通知(onError或onCompleted)

Sample
取样，定期发射最新的数据，等于是数据抽样，有的实现里叫ThrottleFirst

throttleFirst
会定期发射这个时间段里源Observable发射的第一个数据

Skip
跳过前面的若干项数据

SkipLast
跳过后面的若干项数据

Take
只保留前面的若干项数据

TakeLast
只保留后面的若干项数据

takeFirst
有null数据时会抛空指针异常,要判空处理
和first一样，但在所有数据不满足条件时不会抛出异常，仅仅调用onComplete.

组合操作

And/Then/When
通过模式(And条件)和计划(Then次序)组合两个或多个Observable发射的数据集

CombineLatest
当两个Observables中的任何一个发射了一个数据时，通过一个指定的函数组合每个Observable发射的最新数据（一共两个数据），然后发射这个函数的结果

必须满足两个条件:
1)所有的Observable都发射过数据。
2)满足条件1的时候任何一个Observable发射一个数据，就将所有Observable最新发射的数据按照提供的函数组装起来发射出去。

在这两个条件下,可能会忽略掉一些发射的数据.

Join
无论何时，如果一个Observable发射了一个数据项，只要在另一个Observable发射的数据项定义的时间窗口内，就将两个Observable发射的数据合并发射

参数说明:
1)源Observable所要组合的目标Observable
2)一个函数，就收从源Observable发射来的数据，并返回一个Observable，这个Observable的生命周期决定了源Observable发射出来数据的有效期
3)一个函数，就收从目标Observable发射来的数据，并返回一个Observable，这个Observable的生命周期决定了目标Observable发射出来数据的有效期
4)一个函数，接收从源Observable和目标Observable发射来的数据，并返回最终组合完的数据。

Merge
将两个Observable发射的数据组合并成一个
Merge可能会让合并的Observables发射的数据交错（可以使用Concat操作符,不会让数据交错，它会按顺序一个接着一个发射多个Observables的发射物）。

StartWith
在发射原来的Observable的数据序列之前，先发射一个指定的数据序列或数据项

在数据序列的开头插入一条指定的项
你也可以传递一个Observable给startWith，
它会将那个Observable的发射物插在原始Observable发射的数据序列之前.这可以看作是Concat的反转。

Switch，在RxJava的实现为SwitchOnNext
将一个发射Observable序列的Observable转换为这样一个Observable：它逐个发射那些Observable最近发射的数据
用来将一个发射多个小Observable的源Observable转化为一个Observable，然后发射这多个小Observable所发射的数据。
需要注意的就是，如果一个小的Observable正在发射数据的时候，源Observable又发射出一个新的小Observable，则前一个Observable发射的数据会被抛弃，直接发射新的小Observable所发射的数据。

Zip

zip zipWith
打包，使用一个指定的函数将多个Observable发射的数据组合在一起，然后将这个函数的结果作为单项数据发射
Zip操作符将多个Observable发射的数据按顺序组合起来，每个数据只能组合一次，而且都是有序的。
最终组合的数据的数量由发射数据最少的Observable来决定。

错误处理

这些操作符用于从错误通知中恢复

Catch
捕获，继续序列操作，将错误替换为正常的数据，从onError通知中恢复

onErrorReturn
当发生错误的时候，让Observable发射一个预先定义好的数据并正常地终止,不会抛出异常 onErrorResumeNext
当发生错误的时候，由另外一个Observable来代替当前的Observable并继续发射数据 onExceptionResumeNext
类似于OnErrorResume,不同之处在于其会对onError抛出的数据类型做判断，
如果是Exception，也会使用另外一个Observable代替原Observable继续发射数据，
否则会将错误分发给Subscriber。

Retry
重试，如果Observable发射了一个错误通知，重新订阅它，期待它正常终止

retry
Retry操作符在发生错误的时候会重新进行订阅,而且可以重复多次，
所以发射的数据可能会产生重复。如果重复指定次数还有错误的话就会将错误返回给观察者,会掉onError retryWhen
当错误发生时，retryWhen会接收onError的throwable作为参数，并根据定义好的函数返回一个Observable，如果这个Observable发射一个数据，就会重新订阅。
需要注意的是使用retryWhen的时候,因为每次重新订阅都会产生错误，所以作为参数的obserbvable会不断地发射数据，使用zipWith操作符可以限制重新订阅的次数，否则会无限制地重新订阅。
会正常结束,调用onCompleted

辅助操作

Delay
延迟一段时间发射结果数据

DelaySubscription
延迟注册到Observer上

Do
Do操作符就是给Observable的生命周期的各个阶段加上一系列的回调监听，当Observable执行到这个阶段的时候，这些回调就会被触发.

doOnEach
Observable每发射一个数据的时候就会触发这个回调，不仅包括onNext还包括onError和onCompleted。

doOnNext
只有onNext的时候才会被触发。

doOnSubscribe,doOnUnSubscribe
会在Subscriber进行订阅和反订阅的时候触发回调。
当一个Observable通过OnError或者OnCompleted结束的时候，会反订阅所有的Subscriber。在Android中和生命周期绑定起来,因为有些Observable执行不完啊.

doOnSubscribeOn
在开始注册前做一些工作。处于当前线程，而不是subscribeOn指定的线程。

DoOnError
在OnError发生的时候触发回调，并将Throwable对象作为参数传进回调函数里。

DoOnComplete
会在OnCompleted发生的时候触发回调。

DoOnTerminate
会在Observable结束前触发回调，无论是正常还是异常终止。

finallyDo,doAfterTerminate
会在Observable结束后触发回调，无论是正常还是异常终止。

Materialize,dematerialize
Meterialize操作符将OnNext/OnError/OnComplete都转化为一个Notification对象并按照原来的顺序发射出来,dematerialize相反
使用integerNotification.getValue() +”, ” + integerNotification.getKind()可以看到打印值和类型.

ObserveOn
指定Subscriber的调度程序（工作线程）

SubscribeOn
指定Observable应该在哪个调度程序上执行

Serialize
强制Observable按次序发射数据并且功能是有效的

Subscribe
收到Observable发射的数据和通知后执行的操作

TimeInterval
将一个Observable转换为发射两个数据之间所耗费时间的Observable
TimeInterval会拦截发射出来的数据，取代为前后两个发射两个数据的间隔时间。对于第一个发射的数据，其时间间隔为订阅后到首次发射的间隔。

Timeout
添加超时机制，如果过了指定的一段时间没有发射数据，就发射一个错误通知
Timeout操作符给Observable加上超时时间，每发射一个数据后就重置计时器，当超过预定的时间还没有发射下一个数据，就抛出一个超时的异常。
Rxjava将Timeout实现为很多不同功能的操作符，比如说超时后用一个备用的Observable继续发射数据等。

Timestamp
给Observable发射的每个数据项添加一个时间戳
TimeStamp会将每个数据项给重新包装一下，加上了一个时间戳来标明每次发射的时间

Using
创建一个只在Observable的生命周期内存在的一次性资源

Using操作符创建一个在Observable生命周期内存活的资源，也可以这样理解：
我们创建一个资源并使用它，用一个Observable来限制这个资源的使用时间，当这个Observable终止的时候，这个资源就会被销毁。
Using需要使用三个参数，分别是：
1)创建这个一次性资源的函数
2)创建Observable的函数
3)释放资源的函数

条件和布尔操作

这些操作符可用于单个或多个数据项，也可用于Observable

All
判断Observable发射的所有的数据项是否都满足某个条件

All操作符根据一个函数对源Observable发射的所有数据进行判断，最终返回的结果就是这个判断结果。
对发射的所有数据应用这个函数,如果全部都满足则返回true，否则就返回false。

Amb
Amb操作符可以将至多9个Observable结合起来，让他们竞争。
哪个Observable首先发射了数据（包括onError和onComplete)就会继续发射这个Observable的数据，其他的Observable所发射的数据都会别丢弃。

Contains
判断Observable是否会发射一个指定的数据项
Contains操作符用来判断源Observable所发射的数据是否包含某一个数据，如果包含会返回true，如果源Observable已经结束了却还没有发射这个数据则返回false。

IsEmpty
IsEmpty操作符用来判断源Observable是否发射过数据，没有发射过数据返回true.
Null也是一个数据

DefaultIfEmpty
发射来自原始Observable的数据，如果原始Observable没有发射数据，就发射一个默认数据
会判断源Observable是否发射数据，如果源Observable发射了数据则正常发射这些数据，如果没有则发射一个默认的数据

SequenceEqual
判断两个Observable是否按相同的数据序列
SequenceEqual操作符用来判断两个Observable发射的数据序列是否相同（发射的数据相同，数据的序列相同，结束的状态相同），如果相同返回true，否则返回false

SkipUntil
SkipUnitl是根据一个标志Observable来判断的，当这个标志Observable没有发射数据的时候，所有源Observable发射的数据都会被跳过；当标志Observable发射了一个数据，则开始正常地发射数据。
一直等到skipUntil发射了数据才能发射源Observable的数据,并忽略了此段时间内的数据

SkipWhile
SkipWhile则是根据一个函数来判断是否跳过数据，当函数返回值为true的时候则一直跳过源Observable发射的数据；当函数返回false的时候则开始正常发射数据。

TakeUntil
和SkipUtil恰好相反,只获取takeUntil里的Observable之前的数据

TakeWhile
和SkipWhile相反,获取满足skipWhile的数据

算术和聚合操作

Concat
将多个Observable结合成一个Observable并发射数据，并且严格按照先后顺序发射数据，前一个Observable的数据没有发射完，不发射后面Observable的数据

Count
Count操作符用来统计源Observable发射了多少个数据，最后将数目给发射出来；
如果源Observable发射错误，则会将错误直接报出来；在源Observable没有终止前，count是不会发射统计数据的。

Reduce
Reduce操作符应用一个函数接收Observable发射的数据和函数的计算结果作为下次计算的参数，输出最后的结果。
跟前面我们了解过的scan操作符很类似，只是scan会输出每次计算的结果，而reduce只会输出最后的结果。

Collect
collect用来将源Observable发射的数据给收集到一个数据结构里面，需要使用两个参数：
一个产生收集数据结构的函数
一个接收第一个函数产生的数据结构和源Observable发射的数据作为参数的函数。

连接操作

一些有精确可控的订阅行为的特殊Observable

什么是Connectable Observable:
就是一种特殊的Observable对象，并不是Subscrib的时候就发射数据，而是只有对其应用connect操作符的时候才开始发射数据，
所以可以用来更灵活的控制数据发射的时机。

使用Publish操作符将Observable转换为Connectable Observable,然后可以通过connect控制何时发射.

Publish
将一个普通的Observable转换为可连接的
Publish操作符就是用来将一个普通的Observable对象转化为一个Connectable Observable。需要注意的是如果发射数据已经开始了再进行订阅只能接收以后发射的数据。

Connect
Connect操作符就是用来触发Connectable Observable发射数据的。
应用Connect操作符后会返回一个Subscription对象，通过这个Subscription对象，我们可以调用其unsubscribe方法来终止数据的发射。
另外，如果还没有订阅者订阅的时候就应用Connect操作符也是可以使其开始发射数据的。

RefCount
RefCount操作符就是将一个Connectable Observable 对象再重新转化为一个普通的Observable对象，这时候订阅者进行订阅时就会触发数据的发射。

Replay
Replay操作符返回一个Connectable Observable 对象并且可以缓存其发射过的数据，这样即使有订阅者在其发射数据之后进行订阅也能收到其之前发射过的数据。
不过使用Replay操作符我们最好还是限定其缓存的大小，否则缓存的数据太多了可会占用很大的一块内存。
对缓存的控制可以从空间和时间两个方面来实现。

直接返回一个connectable observable,不用publish

转换操作

to

自定义操作符

lift compose