RxSwift笔记 - 操作符

原文链接:[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
    flatMapLatestflatMap 的唯一区别是:flatMapLatest只会接收最新的value事件。

  • concatMap
    concatMapflatMap的唯一区别是:当前一个Observable 元素发送完毕后,后一个Observable才可以开始发出元素。或者说等待前一个 Observable产生完成事件后,才对后一个Observable 进行订阅。

  • scan
    scan就是先给一个初始化的数,然后不断的拿前一个结果和最新的值进行处理操作。

  • groupBy
    groupBy 操作符将源 Observable分解为多个子Observable,然后将这些子Observable发送出来。
    也就是说该操作符会将元素通过某个键进行分组,然后将分组后的元素序列以 Observable的形态发送出来。


2.过滤操作符(Filtering Observables)

  • filter
    该操作符就是用来过滤掉某些不符合要求的事件。

  • distinctUntilChanged
    该操作符用于过滤掉连续重复的事件。

  • single
    限制只发送一次事件,或者满足条件的第一个事件。
    如果存在有多个事件或者没有事件都会发出一个 error 事件。
    如果只有一个事件,则不会发出 error事件。

  • elementAt
    该方法实现只处理在指定位置的事件。

  • ignoreElements
    该操作符可以忽略掉所有的元素,只发出 errorcompleted 事件。
    如果我们并不关心 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
    当传入多个 Observablesamb操作符时,它将取第一个发出元素或产生事件的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之后才会开始。
    replaypublish不同在于:新的订阅者还能接收到订阅之前的事件消息(数量由设置的 bufferSize决定)。

  • multicast
    multicast方法同样是将一个正常的序列转换成一个可连接的序列。
    同时 multicast方法还可以传入一个Subject,每当序列发送事件时都会触发这个Subject的发送。

  • refCount
    refCount操作符可以将可被连接的Observable转换为普通 Observable
    即该操作符可以自动连接和断开可连接的 Observable。当第一个观察者对可连接的Observable 订阅时,那么底层的Observable将被自动连接。当最后一个观察者离开时,那么底层的Observable将被自动断开连接。

  • share(relay:)
    该操作符将使得观察者共享源 Observable,并且缓存最新的n个元素,将这些元素直接发送给新的观察者。
    简单来说 shareReplay 就是replayrefCount 的组合。


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终止了,那么这个资源就会被清除掉了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,313评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,369评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,916评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,333评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,425评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,481评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,491评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,268评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,719评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,004评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,179评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,832评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,510评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,153评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,402评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,045评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,071评论 2 352