導(dǎo)入RxJava的相關(guān)依賴
創(chuàng)建觀察者與被觀察者
鏈?zhǔn)秸{(diào)用
next几迄、error蔚龙、complete
subscribe的重載方法
指定觀察者與被觀察者所在的線程以及線程切換
結(jié)合Retrofit,實(shí)現(xiàn)一個(gè)簡單的網(wǎng)絡(luò)請求
一映胁、引入依賴:
implementation "io.reactivex.rxjava2:rxjava:2.2.3"
implementation 'io.reactivex.rxjava2:rxandroid:2.1.0'
二木羹、觀察者與被觀察者
RxJava中的Observable和Observer通過SubScribe建立連接:
//創(chuàng)建一個(gè)上游 Observable:
Observable<Integer> observable = Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
emitter.onNext(1);
emitter.onNext(2);
emitter.onNext(3);
emitter.onError(new Throwable());
emitter.onComplete();
}
});
//創(chuàng)建一個(gè)下游 Observer
Observer<Integer> observer = new Observer<Integer>() {
@Override
public void onSubscribe(Disposable d) {
Log.d(TAG, "subscribe");
}
@Override
public void onNext(Integer value) {
Log.d(TAG, "" + value);
}
@Override
public void onError(Throwable e) {
Log.d(TAG, "error");
}
@Override
public void onComplete() {
Log.d(TAG, "complete");
}
};
//建立連接
observable.subscribe(observer);
運(yùn)行結(jié)果:
11-21 16:49:58.443 21398-21398/com.example.qidong.testrxjava D/MainActivity: subscribe
11-21 16:49:58.443 21398-21398/com.example.qidong.testrxjava D/MainActivity: 1
11-21 16:49:58.444 21398-21398/com.example.qidong.testrxjava D/MainActivity: 2
11-21 16:49:58.444 21398-21398/com.example.qidong.testrxjava D/MainActivity: 3
11-21 16:49:58.444 21398-21398/com.example.qidong.testrxjava D/MainActivity: error
注意: 只有當(dāng)上游和下游建立連接之后, 上游才會開始發(fā)送事件. 也就是調(diào)用了subscribe() 方法之后才開始發(fā)送事件.
三、RxJava的鏈?zhǔn)秸{(diào)用
使用RxJava的鏈?zhǔn)讲僮魅缦拢?/p>
Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
emitter.onNext(20);
emitter.onNext(30);
emitter.onError(new Throwable());
emitter.onNext(40);
emitter.onComplete();
}
}).subscribe(new Observer<Integer>() {
@Override
public void onSubscribe(Disposable d) {
Log.e(TAG,"OnSubscribe");
}
@Override
public void onNext(Integer integer) {
Log.e(TAG,"onNext:"+integer);
}
@Override
public void onError(Throwable e) {
Log.e(TAG,"onError");
}
@Override
public void onComplete() {
Log.e(TAG,"OnComplete");
}
});
四解孙、next坑填、error抛人、complete事件
從上面的代碼中可以看到ObservableEmitter和Disposable。
ObservableEmitter:意思為發(fā)射器脐瑰,可以通過調(diào)用onNext()函匕、onError(Throwable)、onComplete()來發(fā)射next蚪黑、error盅惜、complete這三種事件。
這其中需要注意的地方有:
上游可以發(fā)送無限個(gè)onNext, 下游也可以接收無限個(gè)onNext.
當(dāng)上游發(fā)送了一個(gè)onComplete后, 上游onComplete之后的事件將會繼續(xù)發(fā)送, 而下游收到onComplete事件之后將不再繼續(xù)接收事件.
當(dāng)上游發(fā)送了一個(gè)onError后, 上游onError之后的事件將繼續(xù)發(fā)送, 而下游收到onError事件之后將不再繼續(xù)接收事件.
上游可以不發(fā)送onComplete或onError.
最為關(guān)鍵的是onComplete和onError必須唯一并且互斥, 即不能發(fā)多個(gè)onComplete, 也不能發(fā)多個(gè)onError, 也不能先發(fā)一個(gè)onComplete, 然后再發(fā)一個(gè)onError, 反之亦然
Disposable, 這個(gè)單詞的字面意思是一次性用品,用完即可丟棄的. 那么在RxJava中怎么去理解它呢, 對應(yīng)于上面的水管的例子, 我們可以把它理解成兩根管道之間的一個(gè)機(jī)關(guān), 當(dāng)調(diào)用它的dispose()方法時(shí), 它就會將兩根管道切斷, 從而導(dǎo)致下游收不到事件.
注意: 調(diào)用dispose()并不會導(dǎo)致上游不再繼續(xù)發(fā)送事件, 上游會繼續(xù)發(fā)送剩余的事件.
來看個(gè)例子, 我們讓上游依次發(fā)送1,2,3,complete,4,在下游收到第二個(gè)事件之后, 切斷水管, 看看運(yùn)行結(jié)果:
Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
Log.e(TAG, "emit 1");
emitter.onNext(1);
Log.e(TAG, "emit 2");
emitter.onNext(2);
Log.e(TAG, "emit 3");
emitter.onNext(3);
Log.e(TAG, "onComplete");
emitter.onComplete();
Log.e(TAG, "emit 4");
emitter.onNext(4);
}
}).subscribe(new Observer<Integer>() {
private Disposable mDispoable;
private int i;
@Override
public void onSubscribe(Disposable d) {
Log.e(TAG, "onSubscribe: ");
this.mDispoable=d;
}
@Override
public void onNext(Integer integer) {
Log.e(TAG, "onNext: "+integer);
i++;
if(i==2)
{
Log.e(TAG, "dispose");
mDispoable.dispose();
Log.e(TAG, "isDisposed:"+mDispoable.isDisposed());
}
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError");
}
@Override
public void onComplete() {
Log.e(TAG, "onComplete");
}
});
運(yùn)行結(jié)果:
11-21 17:11:50.338 23074-23074/com.example.qidong.testrxjava E/MainActivity: onSubscribe:
11-21 17:11:50.338 23074-23074/com.example.qidong.testrxjava E/MainActivity: emit 1
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: onNext: 1
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: emit 2
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: onNext: 2
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: dispose
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: isDisposed:true
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: emit 3
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: onComplete
11-21 17:11:50.339 23074-23074/com.example.qidong.testrxjava E/MainActivity: emit 4
可以看到忌穿,切斷觀察者和被觀察者之間的關(guān)聯(lián)之后,事件3掠剑、complete、4事件依然被發(fā)送了井佑。
五躬翁、subscribe的重載方法
SubScribe有多個(gè)重載的方法:
public final Disposable subscribe() {}
public final Disposable subscribe(Consumer<? super T> onNext) {}
public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError) {}
public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError, Action onComplete) {}
public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError, Action onComplete, Consumer<? super Disposable> onSubscribe) {}
public final void subscribe(Observer<? super T> observer) {}
最后一個(gè)帶有Observer參數(shù)的我們已經(jīng)使用過了,這里對其他幾個(gè)方法進(jìn)行說明.
不帶任何參數(shù)的subscribe() 表示下游不關(guān)心任何事件,你上游盡管發(fā)你的數(shù)據(jù)去吧, 老子可不管你發(fā)什么.
帶有一個(gè)Consumer參數(shù)的方法表示下游只關(guān)心onNext事件, 其他的事件我假裝沒看見, 因此我們?nèi)绻恍枰猳nNext事件可以這么寫:
Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
Log.e(TAG, "onNext:10");
emitter.onNext(10);
Log.e(TAG, "onNext:20");
emitter.onNext(20);
Log.e(TAG, "OnComplete");
emitter.onComplete();
Log.e(TAG, "onNext:30");
emitter.onNext(30);
}
}).subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept:"+integer);
}
});
}
運(yùn)行結(jié)果:
11-21 17:29:00.671 23664-23664/? E/MainActivity: onNext:10
11-21 17:29:00.672 23664-23664/? E/MainActivity: accept:10
11-21 17:29:00.672 23664-23664/? E/MainActivity: onNext:20
11-21 17:29:00.672 23664-23664/? E/MainActivity: accept:20
11-21 17:29:00.672 23664-23664/? E/MainActivity: OnComplete
11-21 17:29:00.672 23664-23664/? E/MainActivity: onNext:30
六、指定觀察者與被觀察者所在的線程以及線程切換
正常情況下狡逢,觀察者和被觀察者是工作在一個(gè)線程中的,也就是被觀察者在哪個(gè)線程發(fā)射事件蛮艰,觀察者就在哪個(gè)線程接受事件:
Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
Log.e(TAG, "onNext:10");
emitter.onNext(10);
Log.e(TAG, "Observable Thread Name:"+Thread.currentThread().getName());
}
}).subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept:"+integer);
Log.e(TAG, "Observer Thread Name:"+Thread.currentThread().getName());
}
});
運(yùn)行結(jié)果:
11-21 17:43:25.366 25090-25090/? E/MainActivity: onNext:10
11-21 17:43:25.366 25090-25090/? E/MainActivity: accept:10
11-21 17:43:25.366 25090-25090/? E/MainActivity: Observer Thread Name:main
11-21 17:43:25.366 25090-25090/? E/MainActivity: Observable Thread Name:main
一般而言壤蚜,我們會將耗時(shí)操作放在子線程中去做仍律,然后在主線程中根據(jù)運(yùn)行的結(jié)果去更新UI。
RxJava中提供了線程調(diào)度器實(shí)現(xiàn)這樣的需求:我們在子線程中發(fā)射事件善涨,在主線程中接受事件:
Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
Log.e(TAG, "onNext:10");
emitter.onNext(10);
Log.e(TAG, "Observable Thread Name:"+Thread.currentThread().getName());
}
}).subscribeOn(Schedulers.newThread())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept:"+integer);
Log.e(TAG, "Observer Thread Name:"+Thread.currentThread().getName());
}
});
此時(shí)再看一下運(yùn)行結(jié)果:
11-21 17:50:37.408 25766-25934/com.example.qidong.testrxjava E/MainActivity: onNext:10
11-21 17:50:37.409 25766-25934/com.example.qidong.testrxjava E/MainActivity: Observable Thread Name:RxNewThreadScheduler-1
11-21 17:50:37.453 25766-25766/com.example.qidong.testrxjava E/MainActivity: accept:10
11-21 17:50:37.453 25766-25766/com.example.qidong.testrxjava E/MainActivity: Observer Thread Name:main
簡單的來說, subscribeOn() 指定的是上游發(fā)送事件的線程, observeOn() 指定的是下游接收事件的線程.
多次指定被觀察者的線程只有第一次指定的有效, 也就是說多次調(diào)用subscribeOn() 只有第一次的有效, 其余的會被忽略.
多次指定觀察者的線程是可以的, 也就是說每調(diào)用一次observeOn() , 下游的線程就會切換一次.
Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
Log.e(TAG, "onNext:10");
emitter.onNext(10);
Log.e(TAG, "Observable Thread Name:"+Thread.currentThread().getName());
}
}).subscribeOn(Schedulers.newThread())
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.observeOn(Schedulers.io())
.subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept:"+integer);
Log.e(TAG, "Observer Thread Name:"+Thread.currentThread().getName());
}
});
再來看下運(yùn)行結(jié)果:
11-21 17:54:36.940 26399-26522/com.example.qidong.testrxjava E/MainActivity: onNext:10
11-21 17:54:36.941 26399-26522/com.example.qidong.testrxjava E/MainActivity: Observable Thread Name:RxNewThreadScheduler-1
11-21 17:54:36.973 26399-26524/com.example.qidong.testrxjava E/MainActivity: accept:10
11-21 17:54:36.974 26399-26524/com.example.qidong.testrxjava E/MainActivity: Observer Thread Name:RxCachedThreadScheduler-2
可以看出觀察者所在的線程被修改成功炕横。
為了看出觀察者所在線程的切換過程葡粒,我們可以添加Log去查看:
Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
Log.e(TAG, "emit 10");
emitter.onNext(10);
Log.e(TAG, "emit 20");
emitter.onNext(20);
}
}).subscribeOn(Schedulers.newThread())
.observeOn(AndroidSchedulers.mainThread())
.doOnNext(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "After Change to MainThread,thread name:"+Thread.currentThread().getName());
}
}).observeOn(Schedulers.io()).doOnNext(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "After Change to IO,thread name:"+Thread.currentThread().getName());
}
}).subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept: "+integer);
}
});
運(yùn)行結(jié)果:
11-21 18:08:37.913 28956-29018/com.example.qidong.testrxjava E/MainActivity: emit 10
11-21 18:08:37.914 28956-29018/com.example.qidong.testrxjava E/MainActivity: emit 20
11-21 18:08:37.945 28956-28956/com.example.qidong.testrxjava E/MainActivity: After Change to MainThread,thread name:main
11-21 18:08:37.946 28956-28956/com.example.qidong.testrxjava E/MainActivity: After Change to MainThread,thread name:main
11-21 18:08:37.946 28956-29020/com.example.qidong.testrxjava E/MainActivity: After Change to IO,thread name:RxCachedThreadScheduler-1
11-21 18:08:37.946 28956-29020/com.example.qidong.testrxjava E/MainActivity: accept: 10
11-21 18:08:37.947 28956-29020/com.example.qidong.testrxjava E/MainActivity: After Change to IO,thread name:RxCachedThreadScheduler-1
11-21 18:08:37.947 28956-29020/com.example.qidong.testrxjava E/MainActivity: accept: 20
在RxJava中, 已經(jīng)內(nèi)置了很多線程選項(xiàng)供我們選擇, 例如有
Schedulers.io() 代表io操作的線程, 通常用于網(wǎng)絡(luò),讀寫文件等io密集型的操作
Schedulers.computation() 代表CPU計(jì)算密集型的操作, 例如需要大量計(jì)算的操作
Schedulers.newThread() 代表一個(gè)常規(guī)的新線程
AndroidSchedulers.mainThread() 代表Android的主線程
這些內(nèi)置的Scheduler已經(jīng)足夠滿足我們開發(fā)的需求, 因此我們應(yīng)該使用內(nèi)置的這些選項(xiàng), 在RxJava內(nèi)部使用的是線程池來維護(hù)這些線程, 所有效率也比較高.