Android RxJava:這是一份RxJava使用入門學習指南

Carson_Ho發表於2018-06-09

前言

  • Rxjava由於其基於事件流的鏈式呼叫、邏輯簡潔 & 使用簡單的特點,深受各大 Android開發者的歡迎。

Github截圖

如果還不瞭解RxJava,請看文章:Android:這是一篇 清晰 & 易懂的Rxjava 入門教程

  • 今天,我將為初學者帶來 RxJava的基本使用,希望大家會喜歡。
  1. 本系列文章主要基於 Rxjava 2.0
  2. 接下來的時間,我將持續推出 AndroidRxjava 2.0 的一系列文章,包括原理、操作符、應用場景、背壓等等 ,有興趣可以繼續關注Carson_Ho的安卓開發筆記!!

示意圖


目錄

示意圖


1. RxJava簡介

此處簡單介紹RxJava

示意圖

若還不瞭解RxJava,請看文章:Android:這是一篇 清晰 & 易懂的Rxjava 入門教程


2. 基本使用

  • 本文只關注 RxJava的基本使用,更深入的RxJava使用請繼續關注Carson_Ho的RxJava系列
  • Rxjava的使用方式有兩種:
    1. 分步驟實現:該方法主要為了深入說明Rxjava的原理 & 使用,主要用於演示說明
    2. 基於事件流的鏈式呼叫:主要用於實際使用

2.1 方式1:分步驟實現

2.1.1 使用步驟

示意圖

2.1.2 步驟詳解
步驟1:建立被觀察者 (Observable )& 生產事件
  • 即 顧客入飯店 - 坐下餐桌 - 點菜
  • 具體實現
        // 1. 建立被觀察者 Observable 物件
        Observable<Integer> observable = Observable.create(new ObservableOnSubscribe<Integer>() {
          // create() 是 RxJava 最基本的創造事件序列的方法
          // 此處傳入了一個 OnSubscribe 物件引數
          // 當 Observable 被訂閱時,OnSubscribe 的 call() 方法會自動被呼叫,即事件序列就會依照設定依次被觸發
          // 即觀察者會依次呼叫對應事件的複寫方法從而響應事件
          // 從而實現被觀察者呼叫了觀察者的回撥方法 & 由被觀察者向觀察者的事件傳遞,即觀察者模式

        // 2. 在複寫的subscribe()裡定義需要傳送的事件
            @Override
            public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
                // 通過 ObservableEmitter類物件產生事件並通知觀察者
                // ObservableEmitter類介紹
                    // a. 定義:事件發射器
                    // b. 作用:定義需要傳送的事件 & 向觀察者傳送事件
                emitter.onNext(1);
                emitter.onNext(2);
                emitter.onNext(3);
                emitter.onComplete();
            }
        });

<--擴充套件:RxJava 提供了其他方法用於 建立被觀察者物件Observable -->
// 方法1:just(T...):直接將傳入的引數依次傳送出來
  Observable observable = Observable.just("A", "B", "C");
  // 將會依次呼叫:
  // onNext("A");
  // onNext("B");
  // onNext("C");
  // onCompleted();

// 方法2:from(T[]) / from(Iterable<? extends T>) : 將傳入的陣列 / Iterable 拆分成具體物件後,依次傳送出來
  String[] words = {"A", "B", "C"};
  Observable observable = Observable.from(words);
  // 將會依次呼叫:
  // onNext("A");
  // onNext("B");
  // onNext("C");
  // onCompleted();

複製程式碼
步驟2:建立觀察者 (Observer )並 定義響應事件的行為
  • 即 開廚房 - 確定對應菜式
  • 發生的事件型別包括:Next事件、Complete事件 & Error事件。具體如下:

示意圖

  • 具體實現

<--方式1:採用Observer 介面 -->
        // 1. 建立觀察者 (Observer )物件
        Observer<Integer> observer = new Observer<Integer>() {
        // 2. 建立物件時通過對應複寫對應事件方法 從而 響應對應事件

            // 觀察者接收事件前,預設最先呼叫複寫 onSubscribe()
            @Override
            public void onSubscribe(Disposable d) {
                Log.d(TAG, "開始採用subscribe連線");
            }
            
            // 當被觀察者生產Next事件 & 觀察者接收到時,會呼叫該複寫方法 進行響應
            @Override
            public void onNext(Integer value) {
                Log.d(TAG, "對Next事件作出響應" + value);
            }

            // 當被觀察者生產Error事件& 觀察者接收到時,會呼叫該複寫方法 進行響應
            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "對Error事件作出響應");
            }
          
            // 當被觀察者生產Complete事件& 觀察者接收到時,會呼叫該複寫方法 進行響應
            @Override
            public void onComplete() {
                Log.d(TAG, "對Complete事件作出響應");
            }
        };

<--方式2:採用Subscriber 抽象類 -->
// 說明:Subscriber類 = RxJava 內建的一個實現了 Observer 的抽象類,對 Observer 介面進行了擴充套件

// 1. 建立觀察者 (Observer )物件
Subscriber<String> subscriber = new Subscriber<Integer>() {

// 2. 建立物件時通過對應複寫對應事件方法 從而 響應對應事件
            // 觀察者接收事件前,預設最先呼叫複寫 onSubscribe()
            @Override
            public void onSubscribe(Subscription s) {
                Log.d(TAG, "開始採用subscribe連線");
            }

            // 當被觀察者生產Next事件 & 觀察者接收到時,會呼叫該複寫方法 進行響應
            @Override
            public void onNext(Integer value) {
                Log.d(TAG, "對Next事件作出響應" + value);
            }

            // 當被觀察者生產Error事件& 觀察者接收到時,會呼叫該複寫方法 進行響應
            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "對Error事件作出響應");
            }

            // 當被觀察者生產Complete事件& 觀察者接收到時,會呼叫該複寫方法 進行響應
            @Override
            public void onComplete() {
                Log.d(TAG, "對Complete事件作出響應");
            }
        };


<--特別注意:2種方法的區別,即Subscriber 抽象類與Observer 介面的區別 -->
// 相同點:二者基本使用方式完全一致(實質上,在RxJava的 subscribe 過程中,Observer總是會先被轉換成Subscriber再使用)
// 不同點:Subscriber抽象類對 Observer 介面進行了擴充套件,新增了兩個方法:
    // 1. onStart():在還未響應事件前呼叫,用於做一些初始化工作
    // 2. unsubscribe():用於取消訂閱。在該方法被呼叫後,觀察者將不再接收 & 響應事件
    // 呼叫該方法前,先使用 isUnsubscribed() 判斷狀態,確定被觀察者Observable是否還持有觀察者Subscriber的引用,如果引用不能及時釋放,就會出現記憶體洩露
複製程式碼
步驟3:通過訂閱(Subscribe)連線觀察者和被觀察者
  • 即 顧客找到服務員 - 點菜 - 服務員下單到廚房 - 廚房烹調
  • 具體實現
observable.subscribe(observer);
 // 或者 observable.subscribe(subscriber);
複製程式碼
  • 擴充套件說明
<-- Observable.subscribe(Subscriber) 的內部實現 -->

public Subscription subscribe(Subscriber subscriber) {
    subscriber.onStart();
    // 步驟1中 觀察者  subscriber抽象類複寫的方法,用於初始化工作
    onSubscribe.call(subscriber);
    // 通過該呼叫,從而回撥觀察者中的對應方法從而響應被觀察者生產的事件
    // 從而實現被觀察者呼叫了觀察者的回撥方法 & 由被觀察者向觀察者的事件傳遞,即觀察者模式
    // 同時也看出:Observable只是生產事件,真正的傳送事件是在它被訂閱的時候,即當 subscribe() 方法執行時
}
複製程式碼

2.2 方式2:優雅的實現方法 - 基於事件流的鏈式呼叫

  • 上述的實現方式是為了說明Rxjava的原理 & 使用
  • 在實際應用中,會將上述步驟&程式碼連在一起,從而更加簡潔、更加優雅,即所謂的 RxJava基於事件流的鏈式呼叫
// RxJava的鏈式操作
        Observable.create(new ObservableOnSubscribe<Integer>() {
        // 1. 建立被觀察者 & 生產事件
            @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. 建立觀察者 & 定義響應事件的行為
            @Override
            public void onSubscribe(Disposable d) {
                Log.d(TAG, "開始採用subscribe連線");
            }
            // 預設最先呼叫複寫的 onSubscribe()

            @Override
            public void onNext(Integer value) {
                Log.d(TAG, "對Next事件"+ value +"作出響應"  );
            }

            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "對Error事件作出響應");
            }

            @Override
            public void onComplete() {
                Log.d(TAG, "對Complete事件作出響應");
            }

        });
    }
}

注:整體方法呼叫順序:觀察者.onSubscribe()> 被觀察者.subscribe()> 觀察者.onNext()>觀察者.onComplete() 
複製程式碼

這種 基於事件流的鏈式呼叫,使得RxJava

  • 邏輯簡潔
  • 實現優雅
  • 使用簡單

更重要的是,隨著程式邏輯的複雜性提高,它依然能夠保持簡潔 & 優雅。所以,一般建議使用這種基於事件流的鏈式呼叫方式實現RxJava

特別注意

RxJava 2.x 提供了多個函式式介面 ,用於實現簡便式的觀察者模式。具體如下:

示意圖

Consumer為例:實現簡便式的觀察者模式

Observable.just("hello").subscribe(new Consumer<String>() {
            // 每次接收到Observable的事件都會呼叫Consumer.accept()
            @Override
            public void accept(String s) throws Exception {
                System.out.println(s);
            }
        });
複製程式碼

3. 例項講解

我將用一個實際工程例項來演示 Rxjava的使用

3.1 方式1:分步驟實現

步驟1:加入依賴

    compile 'io.reactivex.rxjava2:rxjava:2.0.1'
    compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
複製程式碼

步驟2:直接在MainActivity.java中實現下述步驟

  1. 建立被觀察者 (Observable )& 生產事件
  2. 建立觀察者 (Observer )並 定義響應事件的行為
  3. 通過訂閱(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:建立被觀察者 Observable & 生產事件
// 即 顧客入飯店 - 坐下餐桌 - 點菜
        
        //  1. 建立被觀察者 Observable 物件
        Observable<Integer> observable = Observable.create(new ObservableOnSubscribe<Integer>() {
            // 2. 在複寫的subscribe()裡定義需要傳送的事件
            @Override
            public void subscribe(ObservableEmitter<Integer> emitter) throws Exception {
                // 通過 ObservableEmitter類物件產生事件並通知觀察者
                // ObservableEmitter類介紹
                    // a. 定義:事件發射器
                    // b. 作用:定義需要傳送的事件 & 向觀察者傳送事件
                emitter.onNext(1);
                emitter.onNext(2);
                emitter.onNext(3);
                emitter.onComplete();
            }
        });

// 步驟2:建立觀察者 Observer 並 定義響應事件行為
// 即 開廚房 - 確定對應菜式
        
        Observer<Integer> observer = new Observer<Integer>() {
            // 通過複寫對應方法來 響應 被觀察者
            @Override
            public void onSubscribe(Disposable d) {
                Log.d(TAG, "開始採用subscribe連線");
            }
            // 預設最先呼叫複寫的 onSubscribe()

            @Override
            public void onNext(Integer value) {
                Log.d(TAG, "對Next事件"+ value +"作出響應"  );
            }

            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "對Error事件作出響應");
            }

            @Override
            public void onComplete() {
                Log.d(TAG, "對Complete事件作出響應");
            }
        };

        
        // 步驟3:通過訂閱(subscribe)連線觀察者和被觀察者
        // 即 顧客找到服務員 - 點菜 - 服務員下單到廚房 - 廚房烹調
        observable.subscribe(observer);
複製程式碼
  • 測試結果

示意圖

3.2 方式2:基於事件流的鏈式呼叫方式

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. 建立被觀察者 & 生產事件
            @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. 建立觀察者 & 定義響應事件的行為
            @Override
            public void onSubscribe(Disposable d) {
                Log.d(TAG, "開始採用subscribe連線");
            }
            // 預設最先呼叫複寫的 onSubscribe()

            @Override
            public void onNext(Integer value) {
                Log.d(TAG, "對Next事件"+ value +"作出響應"  );
            }

            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "對Error事件作出響應");
            }

            @Override
            public void onComplete() {
                Log.d(TAG, "對Complete事件作出響應");
            }

        });
    }
}
複製程式碼

喜歡的麻煩點個star


4. 額外說明

4.1 觀察者 Observer的subscribe()具備多個過載的方法

    public final Disposable subscribe() {}
    // 表示觀察者不對被觀察者傳送的事件作出任何響應(但被觀察者還是可以繼續傳送事件)

    public final Disposable subscribe(Consumer<? super T> onNext) {}
    // 表示觀察者只對被觀察者傳送的Next事件作出響應
    public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError) {} 
    // 表示觀察者只對被觀察者傳送的Next事件 & Error事件作出響應

    public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError, Action onComplete) {}
    // 表示觀察者只對被觀察者傳送的Next事件、Error事件 & Complete事件作出響應

    public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError, Action onComplete, Consumer<? super Disposable> onSubscribe) {}
    // 表示觀察者只對被觀察者傳送的Next事件、Error事件 、Complete事件 & onSubscribe事件作出響應

    public final void subscribe(Observer<? super T> observer) {}
    // 表示觀察者對被觀察者傳送的任何事件都作出響應
複製程式碼

4.2 可採用 Disposable.dispose() 切斷觀察者 與 被觀察者 之間的連線

  • 即觀察者 無法繼續 接收 被觀察者的事件,但被觀察者還是可以繼續傳送事件
  • 具體使用

// 主要在觀察者 Observer中 實現
        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 +"作出響應"  );
                if (value == 2) {
                    // 設定在接收到第二個事件後切斷觀察者和被觀察者的連線
                    mDisposable.dispose();
                    Log.d(TAG, "已經切斷了連線:" + mDisposable.isDisposed());
                }
            }

            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "對Error事件作出響應");
            }

            @Override
            public void onComplete() {
                Log.d(TAG, "對Complete事件作出響應");
            }
        };
複製程式碼
  • 效果圖

示意圖

至此,關於RxJava的基礎使用講解完畢。


5. 總結

示意圖


請幫頂 / 評論點贊!因為你的鼓勵是我寫作的最大動力!

相關文章