前言
Rxjava
由于其基于事件流的鏈?zhǔn)秸{(diào)用、邏輯簡潔 & 使用簡單的特點蜓谋,深受各大 Android
開發(fā)者的歡迎娜亿。
如果還不了解RxJava,請看文章:Android:這是一篇 清晰 & 易懂的Rxjava 入門教程
今天廓块,Carson將為初學(xué)者帶來 RxJava
的基本使用厢绝,希望大家會喜歡。
Carson帶你學(xué)RxJava系列文章带猴,包括 原理昔汉、操作符、應(yīng)用場景拴清、背壓等等靶病,請關(guān)注看文章:Android:這是一份全面 & 詳細(xì)的RxJava學(xué)習(xí)指南
目錄
1. RxJava簡介
此處簡單介紹RxJava
若還不了解RxJava,請看文章:Android:這是一篇 清晰 & 易懂的Rxjava 入門教程
2. 基本使用
- 本文只關(guān)注
RxJava
的基本使用贷掖,更深入的RxJava
使用請繼續(xù)關(guān)注Carson_Ho的RxJava系列 -
Rxjava
的使用方式有兩種:- 分步驟實現(xiàn):該方法主要為了深入說明
Rxjava
的原理 & 使用嫡秕,主要用于演示說明 - 基于事件流的鏈?zhǔn)秸{(diào)用:主要用于實際使用
- 分步驟實現(xiàn):該方法主要為了深入說明
2.1 方式1:分步驟實現(xiàn)
2.1.1 使用步驟
2.1.2 步驟詳解
步驟1:創(chuàng)建被觀察者 (Observable
)& 生產(chǎn)事件
- 即 顧客入飯店 - 坐下餐桌 - 點菜
- 具體實現(xiàn)
// 1. 創(chuàng)建被觀察者 Observable 對象
Observable<Integer> observable = Observable.create(new ObservableOnSubscribe<Integer>() {
// create() 是 RxJava 最基本的創(chuàng)造事件序列的方法
// 此處傳入了一個 OnSubscribe 對象參數(shù)
// 當(dāng) Observable 被訂閱時,OnSubscribe 的 call() 方法會自動被調(diào)用苹威,即事件序列就會依照設(shè)定依次被觸發(fā)
// 即觀察者會依次調(diào)用對應(yīng)事件的復(fù)寫方法從而響應(yīng)事件
// 從而實現(xiàn)被觀察者調(diào)用了觀察者的回調(diào)方法 & 由被觀察者向觀察者的事件傳遞昆咽,即觀察者模式
// 2. 在復(fù)寫的subscribe()里定義需要發(fā)送的事件
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
// 通過 ObservableEmitter類對象產(chǎn)生事件并通知觀察者
// ObservableEmitter類介紹
// a. 定義:事件發(fā)射器
// b. 作用:定義需要發(fā)送的事件 & 向觀察者發(fā)送事件
emitter.onNext(1);
emitter.onNext(2);
emitter.onNext(3);
emitter.onComplete();
}
});
<--擴展:RxJava 提供了其他方法用于 創(chuàng)建被觀察者對象Observable -->
// 方法1:just(T...):直接將傳入的參數(shù)依次發(fā)送出來
Observable observable = Observable.just("A", "B", "C");
// 將會依次調(diào)用:
// onNext("A");
// onNext("B");
// onNext("C");
// onCompleted();
// 方法2:from(T[]) / from(Iterable<? extends T>) : 將傳入的數(shù)組 / Iterable 拆分成具體對象后,依次發(fā)送出來
String[] words = {"A", "B", "C"};
Observable observable = Observable.from(words);
// 將會依次調(diào)用:
// onNext("A");
// onNext("B");
// onNext("C");
// onCompleted();
步驟2:創(chuàng)建觀察者 (Observer
)并 定義響應(yīng)事件的行為
- 即 開廚房 - 確定對應(yīng)菜式
- 發(fā)生的事件類型包括:
Next
事件、Complete
事件 &Error
事件掷酗。具體如下:
- 具體實現(xiàn)
<--方式1:采用Observer 接口 -->
// 1. 創(chuàng)建觀察者 (Observer )對象
Observer<Integer> observer = new Observer<Integer>() {
// 2. 創(chuàng)建對象時通過對應(yīng)復(fù)寫對應(yīng)事件方法 從而 響應(yīng)對應(yīng)事件
// 觀察者接收事件前调违,默認(rèn)最先調(diào)用復(fù)寫 onSubscribe()
@Override
public void onSubscribe(Disposable d) {
Log.d(TAG, "開始采用subscribe連接");
}
// 當(dāng)被觀察者生產(chǎn)Next事件 & 觀察者接收到時,會調(diào)用該復(fù)寫方法 進(jìn)行響應(yīng)
@Override
public void onNext(Integer value) {
Log.d(TAG, "對Next事件作出響應(yīng)" + value);
}
// 當(dāng)被觀察者生產(chǎn)Error事件& 觀察者接收到時泻轰,會調(diào)用該復(fù)寫方法 進(jìn)行響應(yīng)
@Override
public void onError(Throwable e) {
Log.d(TAG, "對Error事件作出響應(yīng)");
}
// 當(dāng)被觀察者生產(chǎn)Complete事件& 觀察者接收到時技肩,會調(diào)用該復(fù)寫方法 進(jìn)行響應(yīng)
@Override
public void onComplete() {
Log.d(TAG, "對Complete事件作出響應(yīng)");
}
};
<--方式2:采用Subscriber 抽象類 -->
// 說明:Subscriber類 = RxJava 內(nèi)置的一個實現(xiàn)了 Observer 的抽象類,對 Observer 接口進(jìn)行了擴展
// 1. 創(chuàng)建觀察者 (Observer )對象
Subscriber<String> subscriber = new Subscriber<Integer>() {
// 2. 創(chuàng)建對象時通過對應(yīng)復(fù)寫對應(yīng)事件方法 從而 響應(yīng)對應(yīng)事件
// 觀察者接收事件前浮声,默認(rèn)最先調(diào)用復(fù)寫 onSubscribe()
@Override
public void onSubscribe(Subscription s) {
Log.d(TAG, "開始采用subscribe連接");
}
// 當(dāng)被觀察者生產(chǎn)Next事件 & 觀察者接收到時虚婿,會調(diào)用該復(fù)寫方法 進(jìn)行響應(yīng)
@Override
public void onNext(Integer value) {
Log.d(TAG, "對Next事件作出響應(yīng)" + value);
}
// 當(dāng)被觀察者生產(chǎn)Error事件& 觀察者接收到時,會調(diào)用該復(fù)寫方法 進(jìn)行響應(yīng)
@Override
public void onError(Throwable e) {
Log.d(TAG, "對Error事件作出響應(yīng)");
}
// 當(dāng)被觀察者生產(chǎn)Complete事件& 觀察者接收到時泳挥,會調(diào)用該復(fù)寫方法 進(jìn)行響應(yīng)
@Override
public void onComplete() {
Log.d(TAG, "對Complete事件作出響應(yīng)");
}
};
<--特別注意:2種方法的區(qū)別然痊,即Subscriber 抽象類與Observer 接口的區(qū)別 -->
// 相同點:二者基本使用方式完全一致(實質(zhì)上,在RxJava的 subscribe 過程中屉符,Observer總是會先被轉(zhuǎn)換成Subscriber再使用)
// 不同點:Subscriber抽象類對 Observer 接口進(jìn)行了擴展剧浸,新增了兩個方法:
// 1. onStart():在還未響應(yīng)事件前調(diào)用,用于做一些初始化工作
// 2. unsubscribe():用于取消訂閱矗钟。在該方法被調(diào)用后唆香,觀察者將不再接收 & 響應(yīng)事件
// 調(diào)用該方法前,先使用 isUnsubscribed() 判斷狀態(tài)吨艇,確定被觀察者Observable是否還持有觀察者Subscriber的引用躬它,如果引用不能及時釋放,就會出現(xiàn)內(nèi)存泄露
步驟3:通過訂閱(Subscribe
)連接觀察者和被觀察者
- 即 顧客找到服務(wù)員 - 點菜 - 服務(wù)員下單到廚房 - 廚房烹調(diào)
- 具體實現(xiàn)
observable.subscribe(observer);
// 或者 observable.subscribe(subscriber)东涡;
- 擴展說明
<-- Observable.subscribe(Subscriber) 的內(nèi)部實現(xiàn) -->
public Subscription subscribe(Subscriber subscriber) {
subscriber.onStart();
// 步驟1中 觀察者 subscriber抽象類復(fù)寫的方法虑凛,用于初始化工作
onSubscribe.call(subscriber);
// 通過該調(diào)用,從而回調(diào)觀察者中的對應(yīng)方法從而響應(yīng)被觀察者生產(chǎn)的事件
// 從而實現(xiàn)被觀察者調(diào)用了觀察者的回調(diào)方法 & 由被觀察者向觀察者的事件傳遞软啼,即觀察者模式
// 同時也看出:Observable只是生產(chǎn)事件,真正的發(fā)送事件是在它被訂閱的時候延柠,即當(dāng) subscribe() 方法執(zhí)行時
}
2.2 方式2:優(yōu)雅的實現(xiàn)方法 - 基于事件流的鏈?zhǔn)秸{(diào)用
- 上述的實現(xiàn)方式是為了說明
Rxjava
的原理 & 使用 - 在實際應(yīng)用中祸挪,會將上述步驟&代碼連在一起,從而更加簡潔贞间、更加優(yōu)雅贿条,即所謂的
RxJava
基于事件流的鏈?zhǔn)秸{(diào)用
// RxJava的鏈?zhǔn)讲僮? Observable.create(new ObservableOnSubscribe<Integer>() {
// 1. 創(chuàng)建被觀察者 & 生產(chǎn)事件
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
emitter.onNext(1);
emitter.onNext(2);
emitter.onNext(3);
emitter.onComplete();
}
}).subscribe(new Observer<Integer>() {
// 2. 通過通過訂閱(subscribe)連接觀察者和被觀察者
// 3. 創(chuàng)建觀察者 & 定義響應(yīng)事件的行為
@Override
public void onSubscribe(Disposable d) {
Log.d(TAG, "開始采用subscribe連接");
}
// 默認(rèn)最先調(diào)用復(fù)寫的 onSubscribe()
@Override
public void onNext(Integer value) {
Log.d(TAG, "對Next事件"+ value +"作出響應(yīng)" );
}
@Override
public void onError(Throwable e) {
Log.d(TAG, "對Error事件作出響應(yīng)");
}
@Override
public void onComplete() {
Log.d(TAG, "對Complete事件作出響應(yīng)");
}
});
}
}
注:整體方法調(diào)用順序:觀察者.onSubscribe()> 被觀察者.subscribe()> 觀察者.onNext()>觀察者.onComplete()
這種 基于事件流的鏈?zhǔn)秸{(diào)用,使得RxJava
:
- 邏輯簡潔
- 實現(xiàn)優(yōu)雅
- 使用簡單
更重要的是增热,隨著程序邏輯的復(fù)雜性提高整以,它依然能夠保持簡潔 & 優(yōu)雅。所以峻仇,一般建議使用這種基于事件流的鏈?zhǔn)秸{(diào)用方式實現(xiàn)RxJava
公黑。
特別注意
RxJava 2.x
提供了多個函數(shù)式接口 ,用于實現(xiàn)簡便式的觀察者模式。具體如下:
以 Consumer
為例:實現(xiàn)簡便式的觀察者模式
Observable.just("hello").subscribe(new Consumer<String>() {
// 每次接收到Observable的事件都會調(diào)用Consumer.accept()
@Override
public void accept(String s) throws Exception {
System.out.println(s);
}
});
3. 實例講解
我將用一個實際工程實例來演示 Rxjava
的使用
3.1 方式1:分步驟實現(xiàn)
步驟1:加入依賴
compile 'io.reactivex.rxjava2:rxjava:2.0.1'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
步驟2:直接在MainActivity.java
中實現(xiàn)下述步驟
- 創(chuàng)建被觀察者
(Observable )
& 生產(chǎn)事件 - 創(chuàng)建觀察者
(Observer )
并 定義響應(yīng)事件的行為 - 通過訂閱
(Subscribe)
連接觀察者和被觀察者
public class MainActivity extends AppCompatActivity {
private static final String TAG = "Rxjava";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 步驟1:創(chuàng)建被觀察者 Observable & 生產(chǎn)事件
// 即 顧客入飯店 - 坐下餐桌 - 點菜
// 1. 創(chuàng)建被觀察者 Observable 對象
Observable<Integer> observable = Observable.create(new ObservableOnSubscribe<Integer>() {
// 2. 在復(fù)寫的subscribe()里定義需要發(fā)送的事件
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
// 通過 ObservableEmitter類對象產(chǎn)生事件并通知觀察者
// ObservableEmitter類介紹
// a. 定義:事件發(fā)射器
// b. 作用:定義需要發(fā)送的事件 & 向觀察者發(fā)送事件
emitter.onNext(1);
emitter.onNext(2);
emitter.onNext(3);
emitter.onComplete();
}
});
// 步驟2:創(chuàng)建觀察者 Observer 并 定義響應(yīng)事件行為
// 即 開廚房 - 確定對應(yīng)菜式
Observer<Integer> observer = new Observer<Integer>() {
// 通過復(fù)寫對應(yīng)方法來 響應(yīng) 被觀察者
@Override
public void onSubscribe(Disposable d) {
Log.d(TAG, "開始采用subscribe連接");
}
// 默認(rèn)最先調(diào)用復(fù)寫的 onSubscribe()
@Override
public void onNext(Integer value) {
Log.d(TAG, "對Next事件"+ value +"作出響應(yīng)" );
}
@Override
public void onError(Throwable e) {
Log.d(TAG, "對Error事件作出響應(yīng)");
}
@Override
public void onComplete() {
Log.d(TAG, "對Complete事件作出響應(yīng)");
}
};
// 步驟3:通過訂閱(subscribe)連接觀察者和被觀察者
// 即 顧客找到服務(wù)員 - 點菜 - 服務(wù)員下單到廚房 - 廚房烹調(diào)
observable.subscribe(observer);
- 測試結(jié)果
3.2 方式2:基于事件流的鏈?zhǔn)秸{(diào)用方式
public class MainActivity extends AppCompatActivity {
private static final String TAG = "Rxjava";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// RxJava的流式操作
Observable.create(new ObservableOnSubscribe<Integer>() {
// 1. 創(chuàng)建被觀察者 & 生產(chǎn)事件
@Override
public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
emitter.onNext(1);
emitter.onNext(2);
emitter.onNext(3);
emitter.onComplete();
}
}).subscribe(new Observer<Integer>() {
// 2. 通過通過訂閱(subscribe)連接觀察者和被觀察者
// 3. 創(chuàng)建觀察者 & 定義響應(yīng)事件的行為
@Override
public void onSubscribe(Disposable d) {
Log.d(TAG, "開始采用subscribe連接");
}
// 默認(rèn)最先調(diào)用復(fù)寫的 onSubscribe()
@Override
public void onNext(Integer value) {
Log.d(TAG, "對Next事件"+ value +"作出響應(yīng)" );
}
@Override
public void onError(Throwable e) {
Log.d(TAG, "對Error事件作出響應(yīng)");
}
@Override
public void onComplete() {
Log.d(TAG, "對Complete事件作出響應(yīng)");
}
});
}
}
-
測試效果
實現(xiàn)效果同上
Demo 下載地址
Carson_Ho的Github地址 = RxJava2系列:基礎(chǔ)使用
喜歡的麻煩點個
star
凡蚜!
4. 額外說明
4.1 觀察者 Observer的subscribe()具備多個重載的方法
public final Disposable subscribe() {}
// 表示觀察者不對被觀察者發(fā)送的事件作出任何響應(yīng)(但被觀察者還是可以繼續(xù)發(fā)送事件)
public final Disposable subscribe(Consumer<? super T> onNext) {}
// 表示觀察者只對被觀察者發(fā)送的Next事件作出響應(yīng)
public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError) {}
// 表示觀察者只對被觀察者發(fā)送的Next事件 & Error事件作出響應(yīng)
public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError, Action onComplete) {}
// 表示觀察者只對被觀察者發(fā)送的Next事件人断、Error事件 & Complete事件作出響應(yīng)
public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError, Action onComplete, Consumer<? super Disposable> onSubscribe) {}
// 表示觀察者只對被觀察者發(fā)送的Next事件、Error事件 朝蜘、Complete事件 & onSubscribe事件作出響應(yīng)
public final void subscribe(Observer<? super T> observer) {}
// 表示觀察者對被觀察者發(fā)送的任何事件都作出響應(yīng)
4.2 可采用 Disposable.dispose() 切斷觀察者 與 被觀察者 之間的連接
- 即觀察者 無法繼續(xù) 接收 被觀察者的事件恶迈,但被觀察者還是可以繼續(xù)發(fā)送事件
- 具體使用
// 主要在觀察者 Observer中 實現(xiàn)
Observer<Integer> observer = new Observer<Integer>() {
// 1. 定義Disposable類變量
private Disposable mDisposable;
@Override
public void onSubscribe(Disposable d) {
Log.d(TAG, "開始采用subscribe連接");
// 2. 對Disposable類變量賦值
mDisposable = d;
}
@Override
public void onNext(Integer value) {
Log.d(TAG, "對Next事件"+ value +"作出響應(yīng)" );
if (value == 2) {
// 設(shè)置在接收到第二個事件后切斷觀察者和被觀察者的連接
mDisposable.dispose();
Log.d(TAG, "已經(jīng)切斷了連接:" + mDisposable.isDisposed());
}
}
@Override
public void onError(Throwable e) {
Log.d(TAG, "對Error事件作出響應(yīng)");
}
@Override
public void onComplete() {
Log.d(TAG, "對Complete事件作出響應(yīng)");
}
};
- 效果圖
至此,關(guān)于RxJava
的基礎(chǔ)使用講解完畢谱醇。
5. 總結(jié)
- 本文主要講解
Rxjava
的基礎(chǔ)使用暇仲,更多實例應(yīng)用請看文章:Android RxJava實際應(yīng)用教學(xué):你該什么時候使用RxJava? - Carson帶你學(xué)RxJava系列文章:
入門
Carson帶你學(xué)Android:這是一篇清晰易懂的Rxjava入門教程
Carson帶你學(xué)Android:面向初學(xué)者的RxJava使用指南
Carson帶你學(xué)Android:RxJava2.0到底更新了什么副渴?
原理
Carson帶你學(xué)Android:圖文解析RxJava原理
Carson帶你學(xué)Android:手把手帶你源碼分析RxJava
使用教程:操作符
Carson帶你學(xué)Android:RxJava操作符教程
Carson帶你學(xué)Android:RxJava創(chuàng)建操作符
Carson帶你學(xué)Android:RxJava功能性操作符
Carson帶你學(xué)Android:RxJava過濾操作符
Carson帶你學(xué)Android:RxJava組合/合并操作符
Carson帶你學(xué)Android:RxJava變換操作符
Carson帶你學(xué)Android:RxJava條件/布爾操作符
實戰(zhàn)
Carson帶你學(xué)Android:什么時候應(yīng)該使用Rxjava奈附?(開發(fā)場景匯總)
Carson帶你學(xué)Android:RxJava線程控制(含實例講解)
Carson帶你學(xué)Android:圖文詳解RxJava背壓策略
Carson帶你學(xué)Android:RxJava、Retrofit聯(lián)合使用匯總(含實例教程)
Carson帶你學(xué)Android:優(yōu)雅實現(xiàn)網(wǎng)絡(luò)請求嵌套回調(diào)
Carson帶你學(xué)Android:網(wǎng)絡(luò)請求輪詢(有條件)
Carson帶你學(xué)Android:網(wǎng)絡(luò)請求輪詢(無條件)
Carson帶你學(xué)Android:網(wǎng)絡(luò)請求出錯重連(結(jié)合Retrofit)
Carson帶你學(xué)Android:合并數(shù)據(jù)源
Carson帶你學(xué)Android:聯(lián)想搜索優(yōu)化
Carson帶你學(xué)Android:功能防抖
Carson帶你學(xué)Android:從磁盤/內(nèi)存緩存中獲取緩存數(shù)據(jù)
Carson帶你學(xué)Android:聯(lián)合判斷
歡迎關(guān)注Carson_Ho的簡書
不定期分享關(guān)于安卓開發(fā)的干貨佳晶,追求短桅狠、平、快轿秧,但卻不缺深度中跌。