前言
第一次接觸學習RxJava應該是一兩個月前的事情了,但其中也是斷斷續續,最近又再次去學習RxJava,和當初剛接觸RxJava完全不是同樣的心情,輕松了很多,也感受到了RxJava的魅力,真是不由衷感嘆太牛了。目前關于RxJava的文章也很多,個人推薦兩篇扔物線的給 Android 開發者的 RxJava 詳解和大頭鬼Bruce的譯文 深入淺出RxJava系列。那么這篇文章通過代碼介紹RxJava中的操作符,以及操作符的使用。當然操作符較多,準備分幾篇文章介紹。如果你想提前學習其他操作符可以去GitHub,歡迎star項目。
RxJava操作符源碼傳送門
基礎介紹
為了力求有沒有RxJava基礎都能看懂此文,簡單介紹一下RxJava以及一些名詞。在RxJava開源的Github上是這樣解釋的a library for composing asynchronous and event-based programs using observable sequences for the Java VM。無論多么復雜的邏輯,都可以保持整潔的代碼格式。
在RxJava中最重要的就是Observable(被觀察者),subscribe(訂閱),Observer(觀察者)或者Subscriber(訂閱者),Observable也就是數據(事件)源,Subscriber負責接收以及處理數據(事件)。當然要想實現兩者通信,需要有一種機制那就是訂閱。Observer 通過 subscribe() 方法實現訂閱關系,從而 Observable 可以在需要的時候發出事件來通知 Observer。
例如張三(觀察者)想看某款新聞軟件的科技信息(被觀察者),由于科技信息是每天推送或者不定時推送,如果張三一直盯著手機屏幕看并且刷新消息是不是又新的信息,顯然不現實。這時候就可以通過張三 subscribe(訂閱)科技信息,而實現當有新的科技信息時自動給張三推送消息,在這期間,張三并不需要一直盯著屏幕刷新聞。在我們平時的認知中實現訂閱應該是張三.subscribe(科技新聞),不過在RxJava代碼中實現訂閱應該寫成科技新聞.subscribe(張三)。
在RxJava中,有三個事件回調方法,分別是onNext(),OnError(),onCompleted(),onNext()是最終輸出及處理數據的回調,在發射數據過程中出現錯誤異常會回調OnError()方法,當不會再有新的 onNext() 發出時,需要觸發 onCompleted() 方法作為標志。,OnError()和onCompleted()是互斥的。下面舉一個最簡單的例子
Observable observable2 = Observable.just("也許當初忙著微笑和哭泣", "忙著追逐天空中的流星", "人理所當然的忘記", "是誰風里雨里一直默默守護在原地");
Subscriber subscriber = new Subscriber<String>() {
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: " )
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: ")
}
@Override
public void onNext(String s) {
Log.e(TAG, "onNext: "+s )
}
};
observable.subscribe(subscriber);
運行后打印信息為
onNext: 也許當初忙著微笑和哭泣
onNext: 忙著追逐天空中的流星
onNext: 人理所當然的忘記
onNext: 是誰風里雨里一直默默守護在原地
onCompleted:
Create
我們可以使用該操作符從零開始創建一個Observable,給這個操作符傳遞一個接受觀察者作為參數的函數,并調用觀察者的onNext,onError和onCompleted方法。如下
//被觀察者
Observable<String> observable = Observable.create(new Observable.OnSubscribe<String>() {
@Override
public void call(Subscriber<? super String> subscriber) {
//可以多次調用subscriber.onNext("大家好")發射數據
subscriber.onNext("大家好");
subscriber.onNext("我開始學習RxJava");
subscriber.onCompleted();
}
});
發送數據需要在毀掉方法call中調用subscriber的onNext(),onNext(T)發送的參數需要和Observable.OnSubscribe<T>()中參數相同,在上面我們傳入的是String類型。創建后Observale后,我們需要創建Subscriber(觀察者)去處理observable發送的數據。如下
Subscriber<String> subscriber = new Subscriber<String>() {
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted");
}
@Override
public void onError(Throwable e) {
Log.e(TAG, e.getMessage());
}
@Override
public void onNext(String s) {
Log.e(TAG, "onNext:"+s);
}
};
數據成功發送后,會回調Subscriber的onNext()的方法,其中的參數就是接收到的數據。當onNext()接收數據完畢后會執行onCompleted(),如果中途有環節出現錯誤異常,會執行onError()。現在觀察者和被觀察者都創建完畢了,他們執行還需要一個前提就是訂閱,如果不訂閱,observable并不會發射數據,subscribe也不會接收數據,訂閱代碼如下
observable.subscribe(subscriber);
執行后輸出信息
onNext:大家好
onNext:我開始學習RxJava
onCompleted
from
該操作符是將其它種類的對象和數據類型轉換為Observable,如果當你發射的的數據是同一種類型,而不是混合使用Observables和其它類型的數據,會非常方便。如下創建Observable
Integer[] integers = {1,2, 3, 4};
Observable<Integer> observable=Observable.from(integers);
Subscriber<String> subscriber = new Subscriber<Integer>() {
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted");
}
@Override
public void onError(Throwable e) {
Log.e(TAG, e.getMessage());
}
@Override
public void onNext(Integer i) {
Log.e(TAG, "onNext:"+i);
}
};
observable.subscribe(subscriber);
輸出信息為
onNext:1
onNext:2
onNext:3
onNext:4
onCompleted
from操作符可以轉換Future、Iterable和數組。對于Iterable和數組,產生的Observable會發射Iterable或數組的每一項數據。對于Future,它會發射Future.get()方法返回的單個數據,并且還可以增加通過: from(Future,timeout, timeUnit)指定超時時間,如果執行的時候Future超時會回調onError()方法。
just
just將單個數據轉換為發射那個數據的Observable,Just類似于From,但是From會將數組或Iterable的數據取出然后逐個發射,而Just只是簡單的原樣發射,將數組或Iterable當做單個數據,如果你傳遞null給Just,它會返回一個發射null值的Observable。不要誤認為它會返回一個空Observable(完全不發射任何數據的Observable)。對于just可以接收1到10個數據,返回一個按參數列表順序發射這些數據的Observable。
Observable.just(1 2, 3, 4)
.subscribe(new Subscriber<Integer>() {
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: ");
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: ");
}
@Override
public void onNext(Integer integer) {
Log.e(TAG, "onNext: " + integer);
}
});
輸出
onNext:1
onNext:2
onNext:3
onNext:4
onCompleted:
對于just參數類型可以是多種,如下,傳入兩個類型數據
Observable.just(0, "one", 6, "two", 8, "three")
.subscribe(new Subscriber<Serializable>() {
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: " );
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: ");
}
@Override
public void onNext(Serializable serializable) {
Log.e(TAG, "onNext: "+serializable.toString());
}
});
則輸出信息
onNext:0
onNext:one
onNext:6
onNext:two
onNext:8
onNext:three
onCompleted:
Empty/Never/Error
Empty:創建一個不發射任何數據但是正常終止的Observable,此時會回調onCompleted()
Never:創建一個不發射數據也不終止的Observable
Error:創建一個不發射數據以一個錯誤終止的Observable
error操作符需要一個Throwable參數,你的Observable會以此終止。這些操作符默認不在任何特定的調度器上執行,但是empty和error有一個可選參數是Scheduler,如果你傳遞了Scheduler參數,它們會在你指定的調度器上發送通知。
Range
該操作符創建特定整數序列的Observable,它接受兩個參數,一個是范圍的起始值,一個是范圍的數據的數目。如果你將第二個參數設為0,將導致Observable不發射任何數據(如果設置為負數,會拋異常)。
Observable.range(1,4)
.subscribe(new Subscriber<Integer>() {
public String TAG="RXJAVA";
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: " );
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: ");
}
@Override
public void onNext(Integer integer) {
Log.e(TAG, "onNext: "+integer);
}
});
輸出信息
onNext: 1
onNext: 2
onNext: 3
onNext: 4
onCompleted:
你可以在代碼實戰中,更改第二個參數為負數,或者0,以及將第一個參數更改為你想測試的任意值,去觀察執行日志幫助理解。
Timer
Timer操作符創建一個在給定的時間段之后返回一個特殊值的Observable。它在延遲一段給定的時間后發射一個簡單的數字0 。
Observable.timer(1, TimeUnit.SECONDS)
.subscribe(new Subscriber<Long>() {
public String TAG="RXJAVA";
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: " );
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: ");
}
@Override
public void onNext(Long integer) {
Log.e(TAG, "onNext:1111111 "+integer);
}
});
對于該操作符默認在computation調度器上執行的,如果你想在onNext()回調方法更新UI,需要通過observeOn(AndroidSchedulers.mainThread())設置,否則會調用onError()方法。當然Time人提供的有一個三個參數的方法timer(long,TimeUnit,Scheduler)可以指定 Scheduler 。
Interval
該操作符按固定的時間間隔發射一個無限遞增的整數序列,它接受一個表示時間間隔的參數和一個表示時間單位的參數,當然該操作符合Timer一樣,是在computation調度器上執行的,若想更新UI需要指定Scheduler 為AndroidSchedulers.mainThread()。
Subscription subscription = Observable.interval(1, TimeUnit.SECONDS)
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Action1<Long>() {
@Override
public void call(Long aLong) {
tv.append(" " + aLong + " ");
}
});
通過上面代碼就會每隔1秒在tv上追加一個數字,并且會永遠執行。如果在某個時刻不想繼續輸出,就需要要解除訂閱。
if (subscription != null && !subscription.isUnsubscribed()) {
subscription.unsubscribe();
}
Repeat
該操作符是重復的發射某個數據序列,并且可以自己設置重復的次數。當接收到onComplete()會觸發重訂閱再次重復發射數據,當重復發射數據次數到達后執行onCompleted()。
String[] strs = {"也許當初忙著微笑和哭泣", "忙著追逐天空中的流星"};
Observable.from(strs).repeat(2)..subscribe(new Subscriber<String>() {
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: " );
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: ");
}
@Override
public void onNext(String s) {
Log.e(TAG, "onNext: "+s );
tv1.append("\n" + s);
}
});
輸出
onNext: 也許當初忙著微笑和哭泣
onNext: 忙著追逐天空中的流星
onNext: 也許當初忙著微笑和哭泣
onNext: 忙著追逐天空中的流星
onCompleted:
Defer
直到有觀察者訂閱時才創建Observable,并且為每個觀察者創建一個新的Observable,該操作符能保證訂閱執行時數據源是最新的數據。如下正常代碼
String test="舊數據";
Observable observable=Observable.just(test);
Subscriber subscriber=new Subscriber() {
public String TAG="RXJAVA";
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: " );
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: " );
}
@Override
public void onNext(Object o) {
Log.e(TAG, "onNext: "+o );
}
};
test="新數據";
observable.subscribe(subscriber);
輸出
onNext: 舊數據
onCompleted:
通過上面代碼和輸出日志發現,雖然在后面講數據test更新為新數據,但是并沒有生效,要想使用最新的數據就需要使用defer操作符。此時更改使用defer
test="舊數據";
Observable<String> observable=Observable.defer(new Func0<Observable<String>>() {
@Override
public Observable<String> call() {
return Observable.just(test);
}
});
Subscriber subscriber=new Subscriber() {
public String TAG="RXJAVA";
@Override
public void onCompleted() {
Log.e(TAG, "onCompleted: " );
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: " );
}
@Override
public void onNext(Object o) {
Log.e(TAG, "onNext: "+o );
}
};
test="新數據";
observable.subscribe(subscriber);
輸出信息
onNext: 新數據
onCompleted:
通過新的打印信息,發現輸出值已經是最新的數據。
到這里,這篇文章暫時就先結束了,若文章有不足或者錯誤的地方,歡迎指正,以防止給其他讀者錯誤引導。更多的操作符,將在接下來的幾篇文章介紹。