看了許多講解RxJava的文章,有些文章講解的內容是基於第一個版本的,有些文章的講解是通過比較常用的一些API和基礎的概念進行講解的。但是每次看到RxJava的類中的幾十個方法的時候,總是感覺心裡沒底。所以,我打算自己去專門寫篇文章來從API的角度系統地梳理一下RxJava的各種方法和用法。
1、RxJava 基本
1.1 RxJava 簡介
RxJava是一個在Java VM上使用可觀測的序列來組成非同步的、基於事件的程式的庫。
雖然,在Android中,我們可以使用AsyncTask來完成非同步任務操作,但是當任務的梳理比較多的時候,我們要為每個任務定義一個AsyncTask就變得非常繁瑣。RxJava能幫助我們在實現非同步執行的前提下保持程式碼的清晰。它的原理就是建立一個Observable
來完成非同步任務,組合使用各種不同的鏈式操作,來實現各種複雜的操作,最終將任務的執行結果發射給Observer
進行處理。當然,RxJava不僅適用於Android,也適用於服務端等各種場景。
我們總結以下RxJava的用途:
- 簡化非同步程式的流程;
- 使用近似於Java8的流的操作進行程式設計:因為想要在Android中使用Java8的流程式設計有諸多的限制,所以我們可以使用RxJava來實現這個目的。
在使用RxJava之前,我們需要先在自己的專案中新增如下的依賴:
compile 'io.reactivex.rxjava2:rxjava:2.2.0'compile 'io.reactivex.rxjava2:rxandroid:2.0.2'複製程式碼
這裡我們使用的是RxJava2,它與RxJava的第一個版本有些許不同。在本文中,我們所有的關於RxJava的示例都將基於RxJava2.
注:如果想了解關於Java8的流程式設計的內容的內容,可以參考我之前寫過的文章五分鐘學習Java8的流程式設計。
1.2 概要
下面是RxJava的一個基本的用例,這裡我們定義了一個Observable
,然後在它內部使用emitter
發射了一些資料和資訊(其實就相當於呼叫了被觀察物件內部的方法,通知所有的觀察者)。然後,我們用Consumer
介面的例項作為subscribe()
方法的引數來觀察發射的結果。(這裡的介面的方法都已經被使用Lambda簡化過,應該學著適應它。)
Observable<
Integer>
observable = Observable.create(emitter ->
{
emitter.onNext(1);
emitter.onNext(2);
emitter.onNext(3);
});
observable.subscribe(System.out::println);
複製程式碼
這樣,我們就完成了一個基本的RxJava的示例。從上面的例子中,你或許沒法看出Observable
中隱藏的流的概念,看下面的例子:
Observable.range(0, 10).map(String::valueOf).forEach(System.out::println);
複製程式碼
這裡我們先用Observable.range()
方法產生一個序列,然後用map
方法將該整數序列對映成一個字元序列,最後將得到的序列輸出來。從上面看出,這種操作和Java8裡面的Stream程式設計很像。但是兩者之間是有區別的:
- 所謂的“推”和“拉”的區別:Stream中是通過從流中讀取資料來實現鏈式操作,而RxJava除了Stream中的功能之外,還可以通過“發射”資料,來實現通知的功能,即RxJava在Stream之上又多了一個觀察者的功能。
- Java8中的Stream可以通過
parall()
來實現並行,即基於分治演算法將任務分解並計算得到結果之後將結果合併起來;而RxJava只能通過subscribeOn()
方法將所有的操作切換到某個執行緒中去。 - Stream只能被消費一次,但是
Observable
可以被多次進行訂閱;
RxJava除了為我們提供了Observable
之外,在新的RxJava中還提供了適用於其他場景的基礎類,它們之間的功能和主要區別如下:
Flowable
: 多個流,響應式流和背壓Observable
: 多個流,無背壓Single
: 只有一個元素或者錯誤的流Completable
: 沒有任何元素,只有一個完成和錯誤訊號的流Maybe
: 沒有任何元素或者只有一個元素或者只有一個錯誤的流
除了上面的幾個基礎類之外,還有一個Disposable
。當我們監聽某個流的時候,就能獲取到一個Disposable
物件。它提供了兩個方法,一個是isDisposed
,可以被用來判斷是否停止了觀察指定的流;另一個是dispose
方法,用來放棄觀察指定的流,我們可以使用它在任意的時刻停止觀察操作。
1.3 總結
上面我們介紹了了關於RxJava的基本的概念和使用方式,在下面的文章中我們會按照以上定義的順序從API的角度來講解以下RxJava各個模組的使用方法。
2、RxJava 的使用
2.1 Observable
從上面的文章中我們可以得知,Observable
和後面3種操作功能近似,區別在於Flowable
加入了背壓的概念,Observable
的大部分方法也適用於其他3個操作和Flowable
。因此,我們這裡先從Observable
開始梳理,然後我們再專門對Flowable
和背壓的進行介紹。
Observable
為我們提供了一些靜態的構造方法來建立一個Observable
物件,還有許多鏈式的方法來完成各種複雜的功能。這裡我們按照功能將它的這些方法分成各個類別並依次進行相關的說明。
2.1.1 建立操作
1.interval &
intervalRange
下面的操作可以每個3秒的時間傳送一個整數,整數從0開始:
Observable.interval(3, TimeUnit.SECONDS).subscribe(System.out::println);
複製程式碼
如果想要設定從指定的數字開始也是可以的,實際上interval
提供了許多過載方法供我們是使用。下面我們連同與之功能相近的intervalRange
方法也一同給出:
public static Observable<
Long>
interval(long initialDelay, long period, TimeUnit unit, Scheduler scheduler)public static Observable<
Long>
interval(long period, TimeUnit unit, Scheduler scheduler)public static Observable<
Long>
intervalRange(long start, long count, long initialDelay, long period, TimeUnit unit, Scheduler scheduler)
這裡的initialDelay
引數用來指示開始發射第一個整數的之前要停頓的時間,時間的單位與peroid
一樣,都是通過unit
引數來指定的;period
引數用來表示每個發射之間停頓多少時間;unit
表示時間的單位,是TimeUnit
型別的;scheduler
引數指定資料發射和等待時所在的執行緒。
intervalRange
方法可以用來將發射的整數序列限制在一個範圍之內,這裡的start
用來表示發射的資料的起始值,count
表示總共要發射幾個數字,其他引數與上面的interval
方法一致。
2.range &
rangeLong
下面的操作可以產生一個從5開始的連續10個整數構成的序列:
Observable.range(5, 10).subscribe(i ->
System.out.println("1: " + i));
複製程式碼
該方法需要傳入兩個引數,與之有相同功能的方法還有rangeLong
:
public static Observable<
Integer>
range(final int start, final int count)public static Observable<
Long>
rangeLong(long start, long count)
這裡的兩個引數start
用來指定用於生成的序列的開始值,count
用來指示要生成的序列總共包含多少個數字,上面的兩個方法的主要區別在於一個是用來生成int型整數的,一個是用來生成long型整數的。
3.create
create
方法用於從頭開始建立一個Observable
,像下面顯示的那樣,你需要使用create
方法並傳一個發射器作為引數,在該發射器內部呼叫onNext
、onComplete
和onError
方法就可以將資料傳送給監聽者。
Observable.create((ObservableOnSubscribe<
Integer>
) observableEmitter ->
{
observableEmitter.onNext(1);
observableEmitter.onNext(2);
observableEmitter.onComplete();
}).subscribe(System.out::println);
複製程式碼
4.defer
defer
直到有觀察者訂閱時才建立Observable,並且為每個觀察者建立一個新的Observable。defer
操作符會一直等待直到有觀察者訂閱它,然後它使用Observable工廠方法生成一個Observable。比如下面的程式碼兩個訂閱輸出的結果是不一致的:
Observable<
Long>
observable = Observable.defer((Callable<
ObservableSource<
Long>
>
) () ->
Observable.just(System.currentTimeMillis()));
observable.subscribe(System.out::print);
System.out.println();
observable.subscribe(System.out::print);
複製程式碼
下面是該方法的定義,它接受一個Callable物件,可以在該物件中返回一個Observable的例項:
public static <
T>
Observable<
T>
defer(Callable<
? extends ObservableSource<
? extends T>
>
supplier)
5.empty &
never &
error
public static <
:建立一個不發射任何資料但是正常終止的Observable;
T>
Observable<
T>
empty()public static <
:建立一個不發射資料也不終止的Observable;
T>
Observable<
T>
never()public static <
:建立一個不發射資料以一個錯誤終止的Observable,它有幾個過載版本,這裡給出其中的一個。
T>
Observable<
T>
error(Throwable exception)
測試程式碼:
Observable.empty().subscribe(i->
System.out.print("next"),i->
System.out.print("error"),()->
System.out.print("complete"));
Observable.never().subscribe(i->
System.out.print("next"),i->
System.out.print("error"),()->
System.out.print("complete"));
Observable.error(new Exception()).subscribe(i->
System.out.print("next"),i->
System.out.print("error"),()->
System.out.print("complete"));
複製程式碼
輸出結果:completeerror
6.from 系列
from
系列的方法用來從指定的資料來源中獲取一個Observable:
public static <
:從陣列中獲取;
T>
Observable<
T>
fromArray(T... items)public static <
:從Callable中獲取;
T>
Observable<
T>
fromCallable(Callable<
? extends T>
supplier)public static <
:從Future中獲取,有多個過載版本,可以用來指定執行緒和超時等資訊;
T>
Observable<
T>
fromFuture(Future<
? extends T>
future)public static <
:從Iterable中獲取;
T>
Observable<
T>
fromIterable(Iterable<
? extends T>
source)public static <
:從Publisher中獲取。
T>
Observable<
T>
fromPublisher(Publisher<
? extends T>
publisher)
7.just 系列
just系列的方法的一個引數的版本為下面的形式:public static <
,它還有許多個過載的版本,區別在於接受的引數的個數不同,最少1個,最多10個。
T>
Observable<
T>
just(T item)
8.repeat
該方法用來表示指定的序列要發射多少次,下面的方法會將該序列無限次進行傳送:
Observable.range(5, 10).repeat().subscribe(i ->
System.out.println(i));
複製程式碼
repeat
方法有以下幾個相似方法:
public final Observable<
T>
repeat()public final Observable<
T>
repeat(long times)public final Observable<
T>
repeatUntil(BooleanSupplier stop)public final Observable<
T>
repeatWhen(Function<
? super Observable<
Object>
, ? extends ObservableSource<
?>
>
handler)
第1個無參的方法會無限次地傳送指定的序列(實際上內部呼叫了第2個方法並傳入了Long.MAX_VALUE),第2個方法會將指定的序列重複發射指定的次數;第3個方法會在滿足指定的要求的時候停止重複傳送,否則會一直髮送。
9.timer
timer操作符建立一個在給定的時間段之後返回一個特殊值的Observable,它在延遲一段給定的時間後發射一個簡單的數字0。比如下面的程式會在500毫秒之後輸出一個數字0
。
Observable.timer(500, TimeUnit.MILLISECONDS).subscribe(System.out::print);
複製程式碼
下面是該方法及其過載方法的定義,過載方法還可以指定一個排程器:
public static Observable<
Long>
timer(long delay, TimeUnit unit)public static Observable<
Long>
timer(long delay, TimeUnit unit, Scheduler scheduler)
2.1.2 變換操作
1.map &
cast
map
操作符對原始Observable發射的每一項資料應用一個你選擇的函式,然後返回一個發射這些結果的Observable。預設不在任何特定的排程器上執行。cast
操作符將原始Observable發射的每一項資料都強制轉換為一個指定的型別(多型),然後再發射資料,它是map的一個特殊版本:
下面的第一段程式碼用於將生成的整數序列轉換成一個字串序列之後並輸出;第二段程式碼用於將Date型別轉換成Object型別並進行輸出,這裡如果前面的Class無法轉換成第二個Class就會出現異常:
Observable.range(1, 5).map(String::valueOf).subscribe(System.out::println);
Observable.just(new Date()).cast(Object.class).subscribe(System.out::print);
複製程式碼
這兩個方法的定義如下:
public final <
R>
Observable<
R>
map(Function<
? super T, ? extends R>
mapper)public final <
U>
Observable<
U>
cast(Class<
U>
clazz)
這裡的mapper
函式接受兩個泛型,一個表示原始的資料型別,一個表示要轉換之後的資料型別,轉換的邏輯寫在該介面實現的方法中即可。
2.flatMap &
contactMap
flatMap
將一個傳送事件的上游Observable變換為多個傳送事件的Observables,然後將它們發射的事件合併後放進一個單獨的Observable裡。需要注意的是, flatMap並不保證事件的順序,也就是說轉換之後的Observables的順序不必與轉換之前的序列的順序一致。比如下面的程式碼用於將一個序列構成的整數轉換成多個單個的Observable
,然後組成一個OBservable
,並被訂閱。下面輸出的結果仍將是一個字串數字序列,只是順序不一定是增序的。
Observable.range(1, 5) .flatMap((Function<
Integer, ObservableSource<
String>
>
) i ->
Observable.just(String.valueOf(i))) .subscribe(System.out::println);
複製程式碼
與flatMap
對應的方法是contactMap
,後者能夠保證最終輸出的順序與上游傳送的順序一致。下面是這兩個方法的定義:
public final <
R>
Observable<
R>
flatMap(Function<
? super T, ? extends ObservableSource<
? extends R>
>
mapper)public final <
R>
Observable<
R>
concatMap(Function<
? super T, ? extends ObservableSource<
? extends R>
>
mapper)
flatMap
的過載方法數量過多,它們在資料來源方面略有不同,有的支援錯誤等可選引數,具體可以參考原始碼。
3.flatMapIterable
flatMapIterable
可以用來將上流的任意一個元素轉換成一個Iterable
物件,然後我們可以對其進行消費。在下面的程式碼中,我們先生成一個整數的序列,然後將每個整數對映成一個Iterable<
型別,最後,我們對其進行訂閱和消費:
string>
Observable.range(1, 5) .flatMapIterable((Function<
Integer, Iterable<
String>
>
) integer ->
Collections.singletonList(String.valueOf(integer))) .subscribe(s ->
System.out.println("flatMapIterable : " + s));
複製程式碼
下面是該方法及其過載方法的定義:
public final <
U>
Observable<
U>
flatMapIterable(Function<
? super T, ? extends Iterable<
? extends U>
>
mapper)public final <
U, V>
Observable<
V>
flatMapIterable(Function<
? super T, ? extends Iterable<
? extends U>
>
mapper, BiFunction<
? super T, ? super U, ? extends V>
resultSelector)
4.buffer
該方法用於將整個流進行分組。以下面的程式為例,我們會先生成一個7個整數構成的流,然後使用buffer
之後,這些整數會被3個作為一組進行輸出,所以當我們訂閱了buffer
轉換之後的Observable
之後得到的是一個列表構成的OBservable
:
Observable.range(1, 7).buffer(3) .subscribe(integers ->
System.out.println(Arrays.toString(integers.toArray())));
複製程式碼
下面是這個方法及其過載方法的定義,它的過載方法太多,這裡我們只給出其中的兩個,其他的可以參考RxJava的原始碼。這裡的buffer應該理解為一個緩衝區,當緩衝區滿了或者剩餘的資料不夠一個緩衝區的時候就將資料發射出去。
public final Observable<
List<
T>
>
buffer(int count)public final Observable<
List<
T>
>
buffer(int count, int skip)- …
5.groupBy
groupBy
用於分組元素,它可以被用來根據指定的條件將元素分成若干組。它將得到一個Observable<
型別的
GroupedObservable<
T, M>
>Observable
。如下面的程式所示,這裡我們使用concat
方法先將兩個Observable
拼接成一個Observable
,然後對其元素進行分組。這裡我們的分組依據是整數的值,這樣我們將得到一個Observable<
型別的
GroupedObservable<
Integer, Integer>
>Observable
。然後,我們再將得到的序列拼接成一個並進行訂閱輸出:
Observable<
GroupedObservable<
Integer, Integer>
>
observable = Observable.concat( Observable.range(1,4), Observable.range(1,6)).groupBy(integer ->
integer);
Observable.concat(observable).subscribe(integer ->
System.out.println("groupBy : " + integer));
複製程式碼
該方法有多個過載版本,這裡我們用到的一個的定義是:
public final <
K>
Observable<
GroupedObservable<
K, T>
>
groupBy(Function<
? super T, ? extends K>
keySelector)
6.scan
scan
操作符對原始Observable發射的第一項資料應用一個函式,然後將那個函式的結果作為自己的第一項資料發射。它將函式的結果同第二項資料一起填充給這個函式來產生它自己的第二項資料。它持續進行這個過程來產生剩餘的資料序列。這個操作符在某些情況下被叫做accumulator。
以下面的程式為例,該程式的輸結果是2 6 24 120 720
,可以看出這裡的計算規則是,我們把傳入到scan
中的函式記為f
,序列記為x
,生成的序列記為y
,那麼這裡的計算公式是y(0)=x(0);
:
y(i)=f(y(i-1), x(i)), i>
0
Observable.range(2, 5).scan((i1, i2) ->
i1 * i2).subscribe(i ->
System.out.print(i + " "));
複製程式碼
除了上面的這種形式,scan
方法還有一個過載的版本,我們可以使用這個版本的方法來在生成序列的時候指定一個初始值。以下面的程式為例,它的輸出結果是3 6 18 72 360 2160
,可以看出它的輸出比上面的形式多了1個,這是因為當指定了初始值之後,生成的第一個數字就是那個初始值,剩下的按照我們上面的規則進行的。所以,用同樣的函式語言來描述的話,那麼它就應該是下面的這種形式:y(0)=initialValue;
。
y(i)=f(y(i-1), x(i)), i>
0
Observable.range(2, 5).scan(3, (i1, i2) ->
i1 * i2).subscribe(i ->
System.out.print(i + " "));
複製程式碼
以上方法的定義是:
public final Observable<
T>
scan(BiFunction<
T, T, T>
accumulator)public final <
R>
Observable<
R>
scan(R initialValue, BiFunction<
R, ? super T, R>
accumulator)
7.window
window
Window和Buffer類似,但不是發射來自原始Observable的資料包,它發射的是Observable,這些Observables中的每一個都發射原始Observable資料的一個子集,最後發射一個onCompleted通知。
以下面的程式為例,這裡我們首先生成了一個由10個數字組成的整數序列,然後使用window
函式將它們每3個作為一組,每組會返回一個對應的Observable物件。這裡我們對該返回的結果進行訂閱並進行消費,因為10個數字,所以會被分成4個組,每個對應一個Observable:
Observable.range(1, 10).window(3).subscribe( observable ->
observable.subscribe(integer ->
System.out.println(observable.hashCode() + " : " + integer)));
複製程式碼
除了對資料包進行分組,我們還可以根據時間來對發射的資料進行分組。該方法有多個過載的版本,這裡我們給出其中的比較具有代表性的幾個:
public final Observable<
Observable<
T>
>
window(long count)public final Observable<
Observable<
T>
>
window(long timespan, long timeskip, TimeUnit unit)public final <
B>
Observable<
Observable<
T>
>
window(ObservableSource<
B>
boundary)public final <
B>
Observable<
Observable<
T>
>
window(Callable<
? extends ObservableSource<
B>
>
boundary)
2.1.3 過濾操作
1.filter
filter
用來根據指定的規則對源進行過濾,比如下面的程式用來過濾整數1到10中所有大於5的數字:
Observable.range(1,10).filter(i ->
i >
5).subscribe(System.out::println);
複製程式碼
下面是該方法的定義:
public final Observable<
T>
filter(Predicate<
? super T>
predicate)
2.elementAt &
firstElement &
lastElement
elementAt
用來獲取源中指定位置的資料,它有幾個過載方法,這裡我們介紹一下最簡單的一個方法的用法。下面是elementAt
的一個示例,它將獲取源資料中索引為1的元素並交給觀察者訂閱。下面的程式將輸出1
Observable.range(1, 10).elementAt(0).subscribe(System.out::print);
複製程式碼
這裡我們給出elementAt
及其相關的方法的定義,它們的使用相似。注意一下這裡的返回型別:
public final Maybe<
T>
elementAt(long index)public final Single<
T>
elementAt(long index, T defaultItem)public final Single<
T>
elementAtOrError(long index)
除了獲取指定索引的元素的方法之外,RxJava中還有可以用來直接獲取第一個和最後一個元素的方法,這裡我們直接給出方法的定義:
public final Maybe<
T>
firstElement()public final Single<
T>
first(T defaultItem)public final Single<
T>
firstOrError()public final Maybe<
T>
lastElement()public final Single<
T>
last(T defaultItem)public final Single<
T>
lastOrError()
3.distinct &
distinctUntilChanged
distinct
用來對源中的資料進行過濾,以下面的程式為例,這裡會把重複的數字7過濾掉:
Observable.just(1,2,3,4,5,6,7,7).distinct().subscribe(System.out::print);
複製程式碼
與之類似的還有distinctUntilChanged
方法,與distinct
不同的是,它只當相鄰的兩個元素相同的時候才會將它們過濾掉。比如下面的程式會過濾掉其中的2和5,所以最終的輸出結果是12345676
:
Observable.just(1,2,2,3,4,5,5,6,7,6).distinctUntilChanged().subscribe(System.out::print);
複製程式碼
該方法也有幾個功能相似的方法,這裡給出它們的定義如下:
public final Observable<
T>
distinct()public final <
K>
Observable<
T>
distinct(Function<
? super T, K>
keySelector)public final <
K>
Observable<
T>
distinct(Function<
? super T, K>
keySelector, Callable<
? extends Collection<
? super K>
>
collectionSupplier)public final Observable<
T>
distinctUntilChanged()public final <
K>
Observable<
T>
distinctUntilChanged(Function<
? super T, K>
keySelector)public final Observable<
T>
distinctUntilChanged(BiPredicate<
? super T, ? super T>
comparer)
4.skip &
skipLast &
skipUntil &
skipWhile
skip
方法用於過濾掉資料的前n項,比如下面的程式將會過濾掉前2項,因此輸出結果是345
:
Observable.range(1, 5).skip(2).subscribe(System.out::print);
複製程式碼
與skip
方法對應的是take
方法,它用來表示只選擇資料來源的前n項,該方法的示例就不給出了。這裡,我們說一下與之類功能類似的過載方法。skip
還有一個過載方法接受兩個引數,用來表示跳過指定的時間,也就是在指定的時間之後才開始進行訂閱和消費。下面的程式會在3秒之後才開始不斷地輸出數字:
Observable.range(1,5).repeat().skip(3, TimeUnit.SECONDS).subscribe(System.out::print);
複製程式碼
與skip
功能相反的方法的還有skipLast
,它用來表示過濾掉後面的幾項,以及最後的一段時間不進行發射等。比如下面的方法,我們會在程式開始之前進行計時,然後會不斷重複輸出數字,直到5秒之後結束。然後,我們用skipLast
方法表示最後的2秒不再進行發射。所以下面的程式會先不斷輸出數字3秒,3秒結束後停止輸出,並在2秒之後結束程式:
long current = System.currentTimeMillis();
Observable.range(1,5) .repeatUntil(() ->
System.currentTimeMillis() - current >
TimeUnit.SECONDS.toMillis(5)) .skipLast(2, TimeUnit.SECONDS).subscribe(System.out::print);
複製程式碼
與上面的這些方法類似的還有一些,這裡我們不再一一列舉。因為這些方法的過載方法比較多,下面我們給出其中的具有代表性的一部分:
public final Observable<
T>
skip(long count)public final Observable<
T>
skip(long time, TimeUnit unit, Scheduler scheduler)public final Observable<
T>
skipLast(int count)public final Observable<
T>
skipLast(long time, TimeUnit unit, Scheduler scheduler, boolean delayError, int bufferSize)public final <
U>
Observable<
T>
skipUntil(ObservableSource<
U>
other)public final Observable<
T>
skipWhile(Predicate<
? super T>
predicate)
5.take &
takeLast &
takeUntil &
takeWhile
與skip
方法對應的是take
方法,它表示按照某種規則進行選擇操作。我們以下面的程式為例,這裡第一段程式表示只發射序列中的前2個資料:
Observable.range(1, 5).take(2).subscribe(System.out::print);
複製程式碼
下面的程式表示只選擇最後2秒中輸出的資料:
long current = System.currentTimeMillis();
Observable.range(1,5) .repeatUntil(() ->
System.currentTimeMillis() - current >
TimeUnit.SECONDS.toMillis(5)) .takeLast(2, TimeUnit.SECONDS).subscribe(System.out::print);
複製程式碼
下面是以上相關的方法的定義,同樣的,我們只選擇其中比較有代表性的幾個:
public final Observable<
T>
take(long count)public final Observable<
T>
takeLast(long count, long time, TimeUnit unit, Scheduler scheduler, boolean delayError, int bufferSize)public final <
U>
Observable<
T>
takeUntil(ObservableSource<
U>
other)public final Observable<
T>
takeUntil(Predicate<
? super T>
stopPredicate)public final Observable<
T>
takeWhile(Predicate<
? super T>
predicate)
6.ignoreElements
該方法用來過濾所有源Observable產生的結果,只會把Observable的onComplete和onError事件通知給訂閱者。下面是該方法的定義:
public final Completable ignoreElements()
7.throttleFirst &
throttleLast &
throttleLatest &
throttleWithTimeout
這些方法用來對輸出的資料進行限制,它們是通過時間的”視窗“來進行限制的,你可以理解成按照指定的引數對時間進行分片,然後根據各個方法的要求選擇第一個、最後一個、最近的等進行發射。下面是throttleLast
方法的用法示例,它會輸出每個500毫秒之間的數字中最後一個數字:
Observable.interval(80, TimeUnit.MILLISECONDS) .throttleLast(500, TimeUnit.MILLISECONDS) .subscribe(i ->
System.out.print(i + " "));
複製程式碼
其他的幾個方法的功能大致列舉如下:
throttleFirst
只會發射指定的Observable在指定的事件範圍內發射出來的第一個資料;throttleLast
只會發射指定的Observable在指定的事件範圍內發射出來的最後一個資料;throttleLatest
用來發射距離指定的時間分片最近的那個資料;throttleWithTimeout
僅在過了一段指定的時間還沒發射資料時才發射一個資料,如果在一個時間片達到之前,發射的資料之後又緊跟著發射了一個資料,那麼這個時間片之內之前發射的資料會被丟掉,該方法底層是使用debounce
方法實現的。如果資料發射的頻率總是快過這裡的timeout
引數指定的時間,那麼將不會再發射出資料來。
下面是這些方法及其過載方法的定義(選擇其中一部分):
public final Observable<
T>
throttleFirst(long skipDuration, TimeUnit unit, Scheduler scheduler)public final Observable<
T>
throttleLast(long intervalDuration, TimeUnit unit, Scheduler scheduler)public final Observable<
T>
throttleLatest(long timeout, TimeUnit unit, Scheduler scheduler, boolean emitLast)public final Observable<
T>
throttleWithTimeout(long timeout, TimeUnit unit, Scheduler scheduler)
8.debounce
debounce
也是用來限制發射頻率過快的,它僅在過了一段指定的時間還沒發射資料時才發射一個資料。我們通過下面的圖來說明這個問題:
這裡紅、綠、藍三個球發射出來的原因都是因為當反射了這個球之後的一定的時間內沒有其他的球發射出來,這個時間是我們可以通過引數來指定的。
該方法的用法與throttle
之類的方法類似,上面也說過throttle
那些方法底層用了debounce
實現,所以,這裡我們不再為該方法專門編寫相關的測試程式碼。
9.sample
實際上throttleLast
的實現中內部呼叫的就是sample
。
2.1.4 組合操作
1.startWith &
startWithArray
startWith
方法可以用來在指定的資料來源的之前插入幾個資料,它的功能類似的方法有startWithArray
,另外還有幾個過載方法。這裡我們給出一個基本的用法示例,下面的程式會在原始的數字流1-5的前面加上0,所以最終的輸出結果是012345
:
Observable.range(1,5).startWith(0).subscribe(System.out::print);
複製程式碼
下面是startWith
及其幾個功能相關的方法的定義:
public final Observable<
T>
startWith(Iterable<
? extends T>
items)public final Observable<
T>
startWith(ObservableSource<
? extends T>
other)public final Observable<
T>
startWith(T item)public final Observable<
T>
startWithArray(T... items)
2.merge &
mergeArray
merge
可以讓多個資料來源的資料合併起來進行發射,當然它可能會讓merge
之後的資料交錯發射。下面是一個示例,這個例子中,我們使用merge
方法將兩個Observable
合併到了一起進行監聽:
Observable.merge(Observable.range(1,5), Observable.range(6,5)).subscribe(System.out::print);
複製程式碼
鑑於merge
方法及其功能類似的方法太多,我們這裡挑選幾個比較有代表性的方法,具體的可以檢視RxJava的原始碼:
public static <
T>
Observable<
T>
merge(Iterable<
? extends ObservableSource<
? extends T>
>
sources)public static <
T>
Observable<
T>
mergeArray(ObservableSource<
? extends T>
... sources)public static <
T>
Observable<
T>
mergeDelayError(Iterable<
? extends ObservableSource<
? extends T>
>
sources)public static <
T>
Observable<
T>
mergeArrayDelayError(ObservableSource<
? extends T>
... sources)
這裡的mergeError
方法與merge
方法的表現一致,只是在處理由onError
觸發的錯誤的時候有所不同。mergeError
方法會等待所有的資料發射完畢之後才把錯誤發射出來,即使多個錯誤被觸發,該方法也只會發射出一個錯誤資訊。而如果使用merger
方法,那麼當有錯誤被觸發的時候,該錯誤會直接被丟擲來,並結束髮射操作。下面是該方法的一個使用的示例,這裡我們主執行緒停頓4秒,然後所有merge
的Observable中的一個會線上程開始的第2秒的時候觸發一個錯誤,該錯誤最終會在所有的資料發射完畢之後被髮射出來:
Observable.mergeDelayError(Observable.range(1,5), Observable.range(1,5).repeat(2), Observable.create((ObservableOnSubscribe<
String>
) observableEmitter ->
{
Thread.sleep(2000);
observableEmitter.onError(new Exception("error"));
})).subscribe(System.out::print, System.out::print);
Thread.sleep(4000);
複製程式碼
3.concat &
concatArray &
concatEager
該方法也是用來將多個Observable拼接起來,但是它會嚴格按照傳入的Observable的順序進行發射,一個Observable沒有發射完畢之前不會發射另一個Observable裡面的資料。下面是一個程式示例,這裡傳入了兩個Observable,會按照順序輸出12345678910
:
Observable.concat(Observable.range(1, 5), Observable.range(6, 5)).subscribe(System.out::print);
複製程式碼
下面是該方法的定義,鑑於該方法及其過載方法太多,這裡我們選擇幾個比較有代表性的說明:
public static <
T>
Observable<
T>
concat(Iterable<
? extends ObservableSource<
? extends T>
>
sources)public static <
T>
Observable<
T>
concatDelayError(Iterable<
? extends ObservableSource<
? extends T>
>
sources)public static <
T>
Observable<
T>
concatArray(ObservableSource<
? extends T>
... sources)public static <
T>
Observable<
T>
concatArrayDelayError(ObservableSource<
? extends T>
... sources)public static <
T>
Observable<
T>
concatEager(ObservableSource<
? extends ObservableSource<
? extends T>
>
sources)public static <
T>
Observable<
T>
concatArrayEager(ObservableSource<
? extends T>
... sources)
對於concat
方法,我們之前已經介紹過它的用法;這裡的conactArray
的功能與之類似;對於concatEager
方法,當一個觀察者訂閱了它的結果,那麼就相當於訂閱了它拼接的所有ObservableSource
,並且會先快取這些ObservableSource發射的資料,然後再按照順序將它們發射出來。而對於這裡的concatDelayError
方法的作用和前面的mergeDelayError
類似,只有當所有的資料都發射完畢才會處理異常。
4.zip &
zipArray &
zipIterable
zip
操作用來將多個資料項進行合併,可以通過一個函式指定這些資料項的合併規則。比如下面的程式的輸出結果是6 14 24 36 50
,顯然這裡的合併的規則是相同索引的兩個資料的乘積。不過仔細看下這裡的輸出結果,可以看出,如果一個資料項指定的位置沒有對應的值的時候,它是不會參與這個變換過程的:
Observable.zip(Observable.range(1, 6), Observable.range(6, 5), (integer, integer2) ->
integer * integer2) .subscribe(i ->
System.out.print(i + " "));
複製程式碼
zip
方法有多個過載的版本,同時也有功能近似的方法,這裡我們挑選有代表性的幾個進行說明:
public static <
T, R>
Observable<
R>
zip(Iterable<
? extends ObservableSource<
? extends T>
>
sources, Function<
? super Object[], ? extends R>
zipper)ublic static <
T, R>
Observable<
R>
zipArray(Function<
? super Object[], ? extends R>
zipper, boolean delayError, int bufferSize, ObservableSource... sources)public static <
T, R>
Observable<
R>
zipIterable(Iterable<
? extends ObservableSource<
? extends T>
>
sources, Function<
? super Object[], ? extends R>
zipper, boolean delayError, int bufferSize)
實際上上面幾個方法的用法和功能基本類似,區別在於傳入的ObservableSource
的引數的形式。
5.combineLastest
與zip
操作類似,但是這個操作的輸出結果與zip
截然不同,以下面的程式為例,它的輸出結果是36 42 48 54 60
:
Observable.combineLatest(Observable.range(1, 6), Observable.range(6, 5), (integer, integer2) ->
integer * integer2) .subscribe(i ->
System.out.print(i + " "));
複製程式碼
利用下面的這張圖可以比較容易來說明這個問題:
上圖中的上面的兩條橫線代表用於拼接的兩個資料項,下面的一條橫線是拼接之後的結果。combineLatest
的作用是拼接最新發射的兩個資料。下面我們用上圖的過程來說明該方法是如何執行的:開始第一條只有1的時候無法拼接,;當第二條出現A的時候,此時最新的資料是1和A,故組合成一個1A;第二個資料項發射了B,此時最新的資料是1和B,故組合成1B;第一條橫線發射了2,此時最新的資料是2和B,因此得到了2B,依次類推。然後再回到我們上面的問題,第一個資料項連續發射了5個資料的時候,第二個資料項一個都沒有發射出來,因此沒有任何輸出;然後第二個資料項開始發射資料,當第二個資料項發射了6的時候,此時最新的資料組合是6和6,故得36;然後,第二個資料項發射了7,此時最新的資料組合是6和7,故得42,依次類推。
該方法也有對應的combineLatestDelayError
方法,用途也是隻有當所有的資料都發射完畢的時候才去處理錯誤邏輯。
2.1.5 輔助操作
1.delay
delay
方法用於在發射資料之前停頓指定的時間,比如下面的程式會在真正地發射資料之前停頓1秒:
Observable.range(1, 5).delay(1000, TimeUnit.MILLISECONDS).subscribe(System.out::print);
Thread.sleep(1500);
複製程式碼
同樣delay
方法也有幾個過載的方法,可以供我們用來指定觸發的執行緒等資訊,這裡給出其中的兩個,其他的可以參考原始碼和文件:
public final Observable<
T>
delay(long delay, TimeUnit unit)public final Observable<
T>
delay(long delay, TimeUnit unit, Scheduler scheduler)
2.do系列
RxJava中還有一系列的方法可以供我們使用,它們共同的特點是都是以do
開頭,下面我們列舉一下這些方法並簡要說明一下它們各自的用途:
public final Observable<
,會在
T>
doAfterNext(Consumer<
? super T>
onAfterNext)onNext
方法之後觸發;public final Observable<
,會在Observable終止之後觸發;
T>
doAfterTerminate(Action onFinally)public final Observable<
,當
T>
doFinally(Action onFinally)onComplete
或者onError
的時候觸發;public final Observable<
,當被dispose的時候觸發;
T>
doOnDispose(Action onDispose)public final Observable<
,當complete的時候觸發;
T>
doOnComplete(Action onComplete)public final Observable<
,當每個
T>
doOnEach(final Observer<
? super T>
observer)onNext
呼叫的時候觸發;public final Observable<
,當呼叫
T>
doOnError(Consumer<
? super Throwable>
onError)onError
的時候觸發;public final Observable<
T>
doOnLifecycle(final Consumer<
? super Disposable>
onSubscribe, final Action onDispose)public final Observable<
,,會在
T>
doOnNext(Consumer<
? super T>
onNext)onNext
的時候觸發;public final Observable<
,會在訂閱的時候觸發;
T>
doOnSubscribe(Consumer<
? super Disposable>
onSubscribe)public final Observable<
,當終止之前觸發。
T>
doOnTerminate(final Action onTerminate)
這些方法可以看作是對操作執行過程的一個監聽,當指定的操作被觸發的時候會同時觸發這些監聽方法:
Observable.range(1, 5) .doOnEach(integerNotification ->
System.out.println("Each : " + integerNotification.getValue())) .doOnComplete(() ->
System.out.println("complete")) .doFinally(() ->
System.out.println("finally")) .doAfterNext(i ->
System.out.println("after next : " + i)) .doOnSubscribe(disposable ->
System.out.println("subscribe")) .doOnTerminate(() ->
System.out.println("terminal")) .subscribe(i ->
System.out.println("subscribe : " + i));
複製程式碼
3.subscribeOn &
observeOn
subscribeOn
用於指定Observable自身執行的執行緒,observeOn
用於指定發射資料所處的執行緒,比如Android中的非同步任務需要用subscribeOn
指定發射資料所在的執行緒是非主執行緒,然後執行完畢之後將結果傳送給主執行緒,就需要用observeOn
來指定。比如下面的程式,我們用這兩個方法來指定所在的執行緒:
Observable.create(new ObservableOnSubscribe<
T>
() {
@Override public void subscribe(ObservableEmitter<
T>
emitter) throws Exception {
// do nothing
}
}).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread());
複製程式碼
4.timeout
用來設定一個超時時間,如果指定的時間之內沒有任何資料被髮射出來,那麼就會執行我們指定的資料項。如下面的程式所示,我們先為設定了一個間隔200毫秒的數字產生器,開始發射資料之前要停頓1秒鐘,因為我們設定的超時時間是500毫秒,因而在第500毫秒的時候會執行我們傳入的資料項:
Observable.interval(1000, 200, TimeUnit.MILLISECONDS) .timeout(500, TimeUnit.MILLISECONDS, Observable.rangeLong(1, 5)) .subscribe(System.out::print);
Thread.sleep(2000);
複製程式碼
timeout
方法有多個過載方法,可以為其指定執行緒等引數,可以參考原始碼或者文件瞭解詳情。
2.1.6 錯誤處理操作符
錯誤處理操作符主要用來提供給Observable,用來對錯誤資訊做統一的處理,常用的兩個是catch
和retry
。
1.catch
catch操作會攔截原始的Observable的onError
通知,將它替換為其他資料項或者資料序列,讓產生的Observable能夠正常終止或者根本不終止。在RxJava中該操作有3終型別:
onErrorReturn
:這種操作會在onError觸發的時候返回一個特殊的項替換錯誤,並呼叫觀察者的onCompleted方法,而不會將錯誤傳遞給觀察者;onErrorResumeNext
:會在onError觸發的時候發射備用的資料項給觀察者;onExceptionResumeNext
:如果onError觸發的時候onError收到的Throwable不是Exception,它會將錯誤傳遞給觀察者的onError方法,不會使用備用的Observable。
下面是onErrorReturn
和onErrorResumeNext
的程式示例,這裡第一段程式碼會在出現錯誤的時候輸出666
,而第二段會在出現錯誤的時候發射數字12345
:
Observable.create((ObservableOnSubscribe<
Integer>
) observableEmitter ->
{
observableEmitter.onError(null);
observableEmitter.onNext(0);
}).onErrorReturn(throwable ->
666).subscribe(System.out::print);
Observable.create((ObservableOnSubscribe<
Integer>
) observableEmitter ->
{
observableEmitter.onError(null);
observableEmitter.onNext(0);
}).onErrorResumeNext(Observable.range(1,5)).subscribe(System.out::print);
複製程式碼
2.retry
retry
使用了一種錯誤重試機制,它可以在出現錯誤的時候進行重試,我們可以通過引數指定重試機制的條件。以下面的程式為例,這裡我們設定了當出現錯誤的時候會進行2次重試,因此,第一次的時候出現錯誤會呼叫onNext
,重試2次又會呼叫2次onNext
,第二次重試的時候因為重試又出現了錯誤,因此此時會觸發onError
方法。也就是說,下面這段程式碼會觸發onNext
3次,觸發onError()
1次:
Observable.create(((ObservableOnSubscribe<
Integer>
) emitter ->
{
emitter.onNext(0);
emitter.onError(new Throwable("Error1"));
emitter.onError(new Throwable("Error2"));
})).retry(2).subscribe(i ->
System.out.println("onNext : " + i), error ->
System.out.print("onError : " + error));
複製程式碼
retry
有幾個過載的方法和功能相近的方法,下面是這些方法的定義(選取部分):
public final Observable<
:會進行無限次地重試;
T>
retry()public final Observable<
T>
retry(BiPredicate<
? super Integer, ? super Throwable>
predicate)public final Observable<
:指定重試次數;
T>
retry(long times)public final Observable<
T>
retry(long times, Predicate<
? super Throwable>
predicate)public final Observable<
T>
retryUntil(final BooleanSupplier stop)public final Observable<
T>
retryWhen(Function<
? super Observable<
Throwable>
, ? extends ObservableSource<
?>
>
handler)
2.1.7 條件操作符和布林操作符
1.all &
any
all
用來判斷指定的資料項是否全部滿足指定的要求,這裡的“要求”可以使用一個函式來指定;any
用來判斷指定的Observable是否存在滿足指定要求的資料項。
在下面的程式中,我們用該函式來判斷指定的資料項是否全部滿足大於5的要求,顯然是不滿足的,因此下面的程式將會輸出false
:
Observable.range(5, 5).all(i ->
i>
5).subscribe(System.out::println);
// falseObservable.range(5, 5).any(i ->
i>
5).subscribe(System.out::println);
// true複製程式碼
以下是該方法的定義:
public final Single<
Boolean>
all(Predicate<
? super T>
predicate)public final Single<
Boolean>
any(Predicate<
? super T>
predicate)
2.contains &
isEmpty
這兩個方法分別用來判斷資料項中是否包含我們指定的資料項,已經判斷資料項是否為空:
Observable.range(5, 5).contains(4).subscribe(System.out::println);
// falseObservable.range(5, 5).isEmpty().subscribe(System.out::println);
// false複製程式碼
以下是這兩個方法的定義:
public final Single<
Boolean>
isEmpty()public final Single<
Boolean>
contains(final Object element)
3.sequenceEqual
sequenceEqual
用來判斷兩個Observable發射出的序列是否是相等的。比如下面的方法用來判斷兩個序列是否相等:
Observable.sequenceEqual(Observable.range(1,5), Observable.range(1, 5)).subscribe(System.out::println);
複製程式碼
4.amb
amb
作用的兩個或多個Observable,但是隻會發射最先發射資料的那個Observable的全部資料:
Observable.amb(Arrays.asList(Observable.range(1, 5), Observable.range(6, 5))).subscribe(System.out::print)複製程式碼
該方法及其功能近似的方法的定義,這裡前兩個是靜態的方法,第二個屬於例項方法:
public static <
T>
Observable<
T>
amb(Iterable<
? extends ObservableSource<
? extends T>
>
sources)public static <
T>
Observable<
T>
ambArray(ObservableSource<
? extends T>
... sources)public final Observable<
T>
ambWith(ObservableSource<
? extends T>
other)
5.defaultIfEmpty
defaultIfEmpty
用來當指定的序列為空的時候指定一個用於發射的值。下面的程式中,我們直接呼叫發射器的onComplete
方法,因此序列是空的,結果輸出一個整數6
:
Observable.create((ObservableOnSubscribe<
Integer>
) Emitter::onComplete).defaultIfEmpty(6).subscribe(System.out::print);
複製程式碼
下面是該方法的定義:
public final Observable<
T>
defaultIfEmpty(T defaultItem)
2.1.8 轉換操作符
1.toList &
toSortedList
toList
和toSortedList
用於將序列轉換成列表,後者相對於前者增加了排序的功能:
Observable.range(1, 5).toList().subscribe(System.out::println);
Observable.range(1, 5).toSortedList(Comparator.comparingInt(o ->
-o)).subscribe(System.out::println);
複製程式碼
下面是它們的定義,它們有多個過載版本,這裡選擇其中的兩個進行說明:
public final Single<
List<
T>
>
toList()public final Single<
List<
T>
>
toSortedList(final Comparator<
? super T>
comparator)
注意一下,這裡的返回結果是Single
型別的,不過這並不妨礙我們繼續使用鏈式操作,因為Single
的方法和Observable
基本一致。另外還要注意這裡的Single
中的引數是一個List<
,也就是說,它把整個序列轉換成了一個列表物件。因此,上面的兩個示例程式的輸出是:
T>
[1, 2, 3, 4, 5][5, 4, 3, 2, 1]複製程式碼
2.toMap &
toMultimap
toMap
用於將發射的資料轉換成另一個型別的值,它的轉換過程是針對每一個資料項的。以下面的程式碼為例,它會將原始的序列中的每個數字轉換成對應的十六進位制。但是,toMap
轉換的結果不一定是按照原始的序列的發射的順序來的:
Observable.range(8, 10).toMap(Integer::toHexString).subscribe(System.out::print);
複製程式碼
與toMap
近似的是toMultimap
方法,它可以將原始序列的每個資料項轉換成一個集合型別:
Observable.range(8, 10).toMultimap(Integer::toHexString).subscribe(System.out::print);
複製程式碼
上面的兩段程式的輸出結果是:
{11=17, a=10, b=11, c=12, d=13, e=14, f=15, 8=8, 9=9, 10=16
}{11=[17], a=[10], b=[11], c=[12], d=[13], e=[14], f=[15], 8=[8], 9=[9], 10=[16]
}複製程式碼
上面的兩個方法的定義是(多個過載,選擇部分):
public final <
K>
Single<
Map<
K, T>
>
toMap(final Function<
? super T, ? extends K>
keySelector)public final <
K>
Single<
Map<
K, Collection<
T>
>
>
toMultimap(Function<
? super T, ? extends K>
keySelector)
3.toFlowable
該方法用於將一個Observable轉換成Flowable型別,下面是該方法的定義,顯然這個方法使用了策略模式,這裡面涉及背壓相關的內容,我們後續再詳細介紹。
public final Flowable<
T>
toFlowable(BackpressureStrategy strategy)複製程式碼
相比於上面的方法,to
方法的限制更加得寬泛,你可以將指定的Observable轉換成任意你想要的型別(如果你可以做到的話),下面是一個示例程式碼,用來將指定的整數序列轉換成另一個整數型別的Observable,只不過這裡的每個資料項都是原來的列表中的資料總數的值:
Observable.range(1, 5).to(Observable::count).subscribe(System.out::println);
複製程式碼
下面是該方法的定義:
public final <
R>
R to(Function<
? super Observable<
T>
, R>
converter)
2.2 執行緒控制
之前有提到過RxJava的執行緒控制是通過subscribeOn
和observeOn
兩個方法來完成的。這裡我們梳理一下RxJava提供的幾種執行緒排程器以及RxAndroid為Android提供的排程器的使用場景和區別等。
Schedulers.io()
:代表適用於io操作的排程器,增長或縮減來自適應的執行緒池,通常用於網路、讀寫檔案等io密集型的操作。重點需要注意的是執行緒池是無限制的,大量的I/O排程操作將建立許多個執行緒並佔用記憶體。Schedulers.computation()
:計算工作預設的排程器,代表CPU計算密集型的操作,與I/O操作無關。它也是許多RxJava方法,比如buffer()
,debounce()
,delay()
,interval()
,sample()
,skip()
,的預設排程器。Schedulers.newThread()
:代表一個常規的新執行緒。Schedulers.immediate()
:這個排程器允許你立即在當前執行緒執行你指定的工作。它是timeout()
,timeInterval()
以及timestamp()
方法預設的排程器。Schedulers.trampoline()
:當我們想在當前執行緒執行一個任務時,並不是立即,我們可以用trampoline()
將它入隊。這個排程器將會處理它的佇列並且按序執行佇列中每一個任務。它是repeat()
和retry()
方法預設的排程器。
以及RxAndroid提供的執行緒排程器:
AndroidSchedulers.mainThread()
用來指代Android的主執行緒
2.3 總結
上面的這些操作也基本適用於Flowable
、Single
、Completable
和Maybe
。
我們花費了很多的時間和精力來梳理了這些方法,按照上面的內容,使用RxJava實現一些基本的或者高階的操作都不是什麼問題。
但是,Observable更適用於處理一些資料規模較小的問題,當資料規模比較多的時候可能會出現MissingBackpressureException
異常。因此,我們還需要了解背壓和Flowable
的相關內容才能更好地理解和應用RxJava.
RxJava 系列文章: