前言
RxJava
是一款基於 Java VM
實現的響應式程式設計擴充套件庫 – 基於觀察者模式的非同步和事件處理框架。RxJava
官方目前同時維護了兩個版本,分別是 1.x
和 2.x
,區別是它們使用不同的 group id
和 namespaces
。
版本 | group id | namespaces |
---|---|---|
v1.x | io.reactivex | io.reactivex |
v2.x | io.reactivex.rxjava2 | rx |
本系列的文章將針對 RxJava 1.x
進行介紹,先給出 Github
的地址:
- RxJava:github.com/ReactiveX/R…
- RxAndroid:github.com/ReactiveX/R…
通過 Gradle 引入相關依賴:
compile `io.reactivex:rxjava:1.0.14`
compile `io.reactivex:rxandroid:1.0.1`
複製程式碼
正文
1. RxJava的定義
一個精準的解釋如下:RxJava
是一個執行於 Java VM
,由可觀測序列組成的,非同步、基於事件的函式庫。
2. RxJava的優點
換句話說,『同樣是做非同步,為什麼人們用它,而不用現成的 AsyncTask
/ Handler
/ XXX
/ … ?』
一個詞:簡潔。
非同步操作很關鍵的一點是程式的簡潔性,因為在排程過程比較複雜的情況下,非同步程式碼經常會既難寫也難被讀懂。 Android
創造的 AsyncTask 和Handler
,其實都是為了讓非同步程式碼更加簡潔。RxJava 的優勢也是簡潔,但它的簡潔的與眾不同之處在於,隨著程式邏輯變得越來越複雜,它依然能夠保持簡潔。
在 Android
開發中,假設有這樣一個需求:介面上有一個自定義的檢視 imageCollectorView
,它的作用是顯示多張圖片,並能使用 addImage(Bitmap) 方法來任意增加顯示的圖片。現在需要程式將一個給出的目錄陣列 File[] folders
中每個目錄下的 png
圖片都載入出來並顯示在 imageCollectorView
中。
注意: 由於讀取圖片的過程較為耗時,需要放在後臺執行,而圖片的顯示則必須在 UI 執行緒執行。
常用的實現方式有多種,這裡給出其中一種:
new Thread() {
@Override
public void run() {
super.run();
for (File folder : folders) {
File[] files = folder.listFiles();
for (File file : files) {
if (file.getName().endsWith(".png")) {
final Bitmap bitmap = getBitmapFromFile(file);
getActivity().runOnUiThread(new Runnable() {
@Override
public void run() {
imageCollectorView.addImage(bitmap);
}
});
}
}
}
}
}.start();
複製程式碼
而如果使用 RxJava
,實現方式是這樣的:
Observable.from(folders)
.flatMap(new Func1<File, Observable<File>>() {
@Override
public Observable<File> call(File file) {
return Observable.from(file.listFiles());
}
})
.filter(new Func1<File, Boolean>() {
@Override
public Boolean call(File file) {
return file.getName().endsWith(".png");
}
})
.map(new Func1<File, Bitmap>() {
@Override
public Bitmap call(File file) {
return getBitmapFromFile(file);
}
})
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Action1<Bitmap>() {
@Override
public void call(Bitmap bitmap) {
imageCollectorView.addImage(bitmap);
}
});
複製程式碼
可以發現,使用 RxJava 方式程式碼量明顯大大增加,所謂簡潔從何而來?
這裡說的簡潔是指的邏輯上的。觀察一下你會發現,RxJava
的這個實現,是一條從上到下的鏈式呼叫,沒有任何巢狀,這在邏輯的簡潔性上是具有優勢的。當需求變得複雜時,這種優勢將更加明顯(試想如果還要求只選取前 10 張圖片,常規方式要怎麼辦?如果有更多這樣那樣的要求呢?再試想,在這一大堆需求實現完兩個月之後需要改功能,當你翻回這裡看到自己當初寫下的那一片迷之縮排,你能保證自己將迅速看懂,而不是對著程式碼重新捋一遍思路?)。
另外,如果你的 IDE
是 Android Studio
,其實每次開啟某個 Java
檔案的時候,你會看到被自動 Lambda
化的預覽,這將讓你更加清晰地看到程式邏輯:
Observable.from(folders)
.flatMap((Func1) (folder) -> { Observable.from(file.listFiles()) })
.filter((Func1) (file) -> { file.getName().endsWith(".png") })
.map((Func1) (file) -> { getBitmapFromFile(file) })
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe((Action1) (bitmap) -> { imageCollectorView.addImage(bitmap) });
複製程式碼
所以,RxJava
有啥優點?就好在簡潔,優點就是把複雜邏輯,通過函數語言程式設計模型穿成一條線。
3. 觀察者模式的擴充套件
RxJava
的非同步實現,是通過一種擴充套件的觀察者模式來實現的。
3.1. 通用的觀察者模式
觀察者模式面向的需求是:A
物件(觀察者)對 B
物件(被觀察者)的某種變化高度敏感,需要在 B
變化的一瞬間做出反應。
舉個例子,新聞裡喜聞樂見的警察抓小偷,警察需要在小偷伸手作案的時候實施抓捕。在這個例子裡,警察是觀察者,小偷是被觀察者,警察需要時刻盯著小偷的一舉一動,才能保證不會漏過任何瞬間。
程式的觀察者模式略有不同,觀察者不需要時刻盯著被觀察者(例如 A
不需要每過 2ms
就檢查一次 B
的狀態),而是採用註冊( Register
)或者稱為訂閱(Subscribe
)的方式,告訴被觀察者:我需要你的某種狀態,你要在它變化的時候通知我。
採取這樣被動的觀察方式,既省去了反覆檢索狀態的資源消耗,也能夠得到最高的反饋速度。
Android
開發中一個典型的例子是點選監聽器 OnClickListener
。對設定 OnClickListener
來說,View
是被觀察者,OnClickListener
是觀察者,二者通過 setOnClickListener()
方法達成訂閱關係。訂閱之後使用者點選按鈕的瞬間,Android Framework
就會將點選事件傳送給已註冊的 OnClickListener 。
OnClickListener
的觀察者模式大致如下圖:
如圖所示,通過 setOnClickListener()
方法,Button
持有 OnClickListener
的引用(這一過程沒有在圖上畫出)。當使用者點選時,Button
自動呼叫 OnClickListener
的 onClick()
方法。
按照觀察者模式抽象出來的各個概念:
- Button: 被觀察者
- OnClickListener: 觀察者
- setOnClickListener(): 訂閱
- onClick(): 事件處理
就由專用的觀察者模式轉變成了通用的觀察者模式,如下圖:
3.2. RxJava的觀察者模式
RxJava
有四個基本概念:
- Observable: 可觀察者,即被觀察者
- Observer: 觀察者
- Subscribe: 訂閱
- Event: 事件處理
Observable
和 Observer
通過 subscribe()
方法實現訂閱關係,使得Observable
可以在需要的時候發出事件來通知 Observer
。
與傳統觀察者模式不同,RxJava
的事件回撥方法除了普通事件 onNext()
(相當於 onClick()
) 之外,還定義了兩個特殊的事件:onCompleted()
和 onError()
。
- onCompleted(): 事件佇列完結
RxJava
不僅把每個事件單獨處理,還會把它們看做一個佇列。RxJava
規定,當不會再有新的 onNext()
發出時,需要觸發 onCompleted()
方法作為事件完成標誌。
- onError(): 事件佇列異常
在事件處理過程中出異常時,onError()
會被觸發,同時佇列自動終止,不允許再有事件發出。
在一個正確執行的事件序列中, onCompleted() 和 onError() 有且只有一個被呼叫,並且是事件序列中的最後一個執行。
RxJava
的觀察者模式大致如下圖:
4. RxJava的基本使用
基於以上的概念,RxJava
的基本使用有 3 個步驟:
4.1. 建立Obsever
Observer
即觀察者,它決定事件觸發的時候將有怎樣的行為。 RxJava
中的 Observer
介面的宣告方式:
Observer<String> observer = new Observer<String>() {
@Override
public void onNext(String s) {
Log.d(tag, "Item: " + s);
}
@Override
public void onCompleted() {
Log.d(tag, "Completed!");
}
@Override
public void onError(Throwable e) {
Log.d(tag, "Error: " + e.getMessage());
}
};
複製程式碼
除了 Observer
介面之外,RxJava
還內建了一個實現了 Observer
的抽象類:Subscriber
。 Subscriber
對 Observer
介面進行了一些擴充套件,但他們的基本使用方式是完全一樣的:
Subscriber<String> subscriber = new Subscriber<String>() {
@Override
public void onNext(String s) {
Log.d(tag, "Item: " + s);
}
@Override
public void onCompleted() {
Log.d(tag, "Completed!");
}
@Override
public void onError(Throwable e) {
Log.d(tag, "Error: " + e.getMessage());
}
};
複製程式碼
實質上,在 RxJava
的 subscribe
過程中,Observer
也總是會先被轉換成一個 Subscriber
再使用。所以如果你只想使用基本功能,選擇 Observer
和 Subscriber
是完全一樣的。它們的區別對於使用者來說主要有兩點:
- onStart()
這是 Subscriber
增加的方法。它會在 subscribe
剛開始,而事件還未傳送之前被呼叫。可以用於做一些準備工作,例如資料的清零或重置。這是一個可選方法,預設情況下它的實現為空。
需要注意的是,如果對準備工作的執行緒有要求(例如: 彈出一個顯示進度的對話方塊,這必須在主執行緒執行),onStart()
就不適用了。因為它總是在 subscribe
所發生的執行緒被呼叫,而不能指定執行緒。要在指定的執行緒來做準備工作,可以使用 doOnSubscribe()
方法,具體可以在後面的章節中看到。
- unsubscribe()
這是 Subscriber
所實現的另一個介面 Subscription
的方法,用於取消訂閱。在這個方法被呼叫後,Subscriber
將不再接收事件。一般在這個方法呼叫前,可以使用 isUnsubscribed()
先判斷一下狀態。
unsubscribe()
這個方法很重要,因為在 subscribe()
之後, Observable
會持有 Subscriber 的引用。這個引用如果不能及時被釋放,將有記憶體洩露的風險。
注意:在不再使用的時候儘快在合適的地方(例如: onPause()
和 onStop()
等方法中)呼叫 unsubscribe()
來解除引用關係,以避免記憶體洩露的發生。
4.2. 建立Obsevable
4.2.1. Obsevable.create()
Observable
即被觀察者,它決定什麼時候觸發事件以及觸發怎樣的事件。 RxJava
使用 create()
方法來建立一個 Observable
,併為它定義事件觸發規則。示例如下:
Observable observable = Observable.create(new Observable.OnSubscribe<String>() {
@Override
public void call(Subscriber<? super String> subscriber) {
subscriber.onNext("Hello");
subscriber.onNext("Hi");
subscriber.onNext("Aloha");
subscriber.onCompleted();
}
});
複製程式碼
可以看到,這裡傳入了一個 OnSubscribe
物件作為引數。OnSubscribe
會被儲存在返回的 Observable
物件中。
它的作用相當於一個計劃表,當 Observable
被訂閱的時候,OnSubscribe
的 call()
方法會自動被呼叫,事件序列就會依照設定依次觸發(對於上面的程式碼,就是觀察者Subscriber
將會被呼叫三次 onNext()
和一次 onCompleted()
)。
這樣,由被觀察者呼叫了觀察者的回撥方法,就實現了由被觀察者向觀察者的事件傳遞,即觀察者模式。
4.2.2. Obsevable.just(T…)
create()
方法是 RxJava
最基本的建立事件序列的方法。基於這個方法,RxJava
還提供了一些方法用於快捷建立事件佇列,例如 just()
方法:
Observable observable = Observable.just("Hello", "Hi", "Aloha");
// 將會依次呼叫方法序列:onNext("Hello") -> onNext("Hi") -> onCompleted()
複製程式碼
4.2.3. Obsevable.from(T[])和from(Iterable<? extends T>)
將傳入的陣列或 Iterable
拆分成具體物件後,依次傳送給觀察者,示例如下:
String[] words = {"Hello", "Hi", "Aloha"};
Observable observable = Observable.from(words);
// 將會依次呼叫方法序列:onNext("Hello") -> onNext("Hi") -> onCompleted()
複製程式碼
4.3. Subscribe關聯
建立了 Observable
和 Observer
之後,再用 subscribe()
方法將它們關聯起來,整條鏈子就可以工作了。程式碼很簡單:
observable.subscribe(observer);
// 或者
observable.subscribe(subscriber);
複製程式碼
可能會注意到,subscribe() 這個方法有點怪:它看起來是『observable 訂閱了 observer / subscriber』,而不是『observer / subscriber 訂閱了 observable』。這看起來就像『雜誌訂閱了讀者』一樣顛倒了物件關係。
這讓人讀起來有點彆扭,不過如果把 API 設計成 『observer.subscribe(observable) / subscriber.subscribe(observable)』,雖然更加符合思維邏輯,但對流式 API 的設計就造成影響了,比較起來明顯是得不償失的。
Observable.subscribe(Subscriber)
的內部實現是這樣的(核心程式碼):
public Subscription subscribe(Subscriber subscriber) {
subscriber.onStart();
onSubscribe.call(subscriber);
return subscriber;
}
複製程式碼
可以看到subscriber()
做了3件事:
(a). 呼叫Subscriber.onStart()
這個方法在前面已經介紹過,是一個可選的準備方法。
(b). 呼叫Observable中的OnSubscribe.call(Subscriber)
事件傳送的邏輯開始執行。從這也可以看出,在RxJava中,Observable並不是在建立的時候就立即開始傳送事件,而是在它被訂閱的時候,即當subscribe()方法執行的時候。
(c). 返回Subscription
將傳入的Subscriber作為Subscription返回。這是為了方便後面的unsubscribe()。
整個過程中物件間的關係如下圖:
或者可以看動圖:
除了 subscribe(Observer)
和 subscribe(Subscriber)
,subscribe()
還支援不完整定義的回撥,RxJava
會自動根據定義建立出 Subscriber
。形式如下:
Action1<String> onNextAction = new Action1<String>() {
// onNext()
@Override
public void call(String s) {
Log.d(tag, s);
}
};
Action1<Throwable> onErrorAction = new Action1<Throwable>() {
// onError()
@Override
public void call(Throwable throwable) {
// Error handling
}
};
Action0 onCompletedAction = new Action0() {
// onCompleted()
@Override
public void call() {
Log.d(tag, "completed");
}
};
// 自動建立 Subscriber ,並使用 onNextAction 來定義 onNext()
observable.subscribe(onNextAction);
// 自動建立 Subscriber ,並使用 onNextAction 和 onErrorAction 來定義 onNext() 和 onError()
observable.subscribe(onNextAction, onErrorAction);
// 自動建立 Subscriber ,並使用 onNextAction、 onErrorAction 和 onCompletedAction 來定義 onNext()、 onError() 和 onCompleted()
observable.subscribe(onNextAction, onErrorAction, onCompletedAction);
複製程式碼
簡單解釋一下這段程式碼中出現的 Action1
和 Action0
。
- Action0
Action0
是 RxJava
的一個介面,它只有一個方法 call()
,這個方法是無參無返回值的。由於 onCompleted()
方法也是無參無返回值的,因此 Action0
可以被當成一個包裝物件,將 onCompleted()
的內容打包起來將自己作為一個引數傳入 subscribe()
以實現不完整定義的回撥。
- Action1
Action1
也是一個介面,它同樣只有一個方法 call(T param)
,這個方法也無返回值,但有一個引數。與 Action0
同理,由於 onNext(T obj)
和 onError(Throwable error)
也是單引數無返回值的,因此 Action1
可以將 onNext(obj)
和 onError(error)
打包起來傳入 subscribe()
以實現不完整定義的回撥。
事實上,雖然
Action0
和Action1
在API
中使用最廣泛,但RxJava
提供了多個ActionX
形式的介面 (例如:Action2
,Action3
),它們可以被用以包裝不同的無返回值的方法。
4.4. 場景示例
4.4.1. 列印字串陣列
將字串陣列 names 中的所有字串依次列印出來:
String[] names = ...;
Observable.from(names)
.subscribe(new Action1<String>() {
@Override
public void call(String name) {
Log.d(tag, name);
}
});
複製程式碼
4.4.2. 由ID取得圖片顯示
int drawableRes = ...;
ImageView imageView = ...;
Observable.create(new OnSubscribe<Drawable>() {
@Override
public void call(Subscriber<? super Drawable> subscriber) {
Drawable drawable = getTheme().getDrawable(drawableRes));
subscriber.onNext(drawable);
subscriber.onCompleted();
}
}).subscribe(new Observer<Drawable>() {
@Override
public void onNext(Drawable drawable) {
imageView.setImageDrawable(drawable);
}
@Override
public void onCompleted() {
}
@Override
public void onError(Throwable e) {
Toast.makeText(activity, "Error!", Toast.LENGTH_SHORT).show();
}
});
複製程式碼
正如上面兩個例子這樣,建立出 Observable
和 Subscriber
,再用 subscribe()
將它們串起來,一次 RxJava
的基本使用就完成了,非常簡單!
然而。
小結
在 RxJava
的預設規則中,事件的發出和消費都是在同一個執行緒的。也就是說,如果只用上面的方法,實現出來的只是一個同步的觀察者模式。觀察者模式本身的目的就是『後臺處理,前臺回撥』的非同步機制,因此非同步對於 RxJava
是至關重要的。而要實現非同步,則需要用到 RxJava
的另一個核心的概念 Scheduler
,後續將給出詳細介紹。
歡迎關注技術公眾號: 零壹技術棧
本帳號將持續分享後端技術乾貨,包括虛擬機器基礎,多執行緒程式設計,高效能框架,非同步、快取和訊息中介軟體,分散式和微服務,架構學習和進階等學習資料和文章。