如需下載源碼,請訪問
https://github.com/fengchuanfang/Rxjava2Tutorial
文章原創,轉載請注明出處:
Rxjava2入門教程六:Single、Completable、Maybe——簡化版的Observable
在Rxjava2中,Observale和Flowable都是用來發射數據流的,但是,我們在實際應用中,很多時候,需要發射的數據并不是數據流的形式,而只是一條單一的數據,或者一條完成通知,或者一條錯誤通知。在這種情況下,我們再使用Observable或者Flowable就顯得有點大材小用,于是,為了滿足這種單一數據或通知的使用場景,便出現了Observable的簡化版——Single、Completable、Maybe。
Single
只發射一條單一的數據,或者一條異常通知,不能發射完成通知,其中數據與通知只能發射一個。
Completable
只發射一條完成通知,或者一條異常通知,不能發射數據,其中完成通知與異常通知只能發射一個
Maybe
可發射一條單一的數據,以及發射一條完成通知,或者一條異常通知,其中完成通知和異常通知只能發射一個,發射數據只能在發射完成通知或者異常通知之前,否則發射數據無效。
示例一:Single發射單一數據
singleDemo1.jpg
示例二:Single發射異常通知
singleDemo2.jpg
SingleEmitter:Single的發射器
可觀察對象Single的發射器接口SingleEmitter中,
1、方法void onSuccess(T t)用來發射一條單一的數據,且一次訂閱只能調用一次,不同于Observale的發射器ObservableEmitter中的void onNext(@NonNull T value)方法,在一次訂閱中,可以多次調用多次發射。
2、方法void onError(Throwable t)等同于ObservableEmitter中的void onError(@NonNull Throwable error)用來發射一條錯誤通知
3、SingleEmitter中沒有用來發射完成通知的void onComplete()方法。
方法onSuccess與onError只可調用一個,若先調用onError則會導致onSuccess無效,若先調用onSuccess,則會拋出io.reactivex.exceptions.UndeliverableException異常。
SingleObserver:Single觀察者
可觀察對象Single對應的觀察者為SingleObserver
SingleObserver.jpg
方法void onSubscribe(Disposable d)等同于Observer中的void onSubscribe(Disposable d)。
方法void onSuccess(T t)類似于Observer中的onNext(T t)用來接收Single發的數據。
方法void onError(Throwable e)等同于Observer中的void onError(Throwable e)用來處理異常通知。
沒有用來處理完成通知的方法void onComplete()
示例三:Completable發射完成通知
completableDemo1.jpg
示例四:Completable發射異常通知
completableDemo2.jpg
CompletableEmitter:Completable的發射器
可觀察對象Completable的發射器接口CompletableEmitter中
1、方法onComplete()等同于Observale的發射器ObservableEmitter中的onComplete(),用來發射完成通知。
2、方法onError(Throwable e)等同于ObservableEmitter中的onError(Throwable e),用來發射異常通知。
方法onComplete與onError只可調用一個,若先調用onError則會導致onComplete無效,若先調用onComplete,則會拋出io.reactivex.exceptions.UndeliverableException異常。
CompletableObserver:Completable的觀察者
可觀察對象Completable對應的觀察者為CompletableObserver
completableObserver.jpg
其中的三個方法均等同于Observer中的對應的方法,CompletableObserver中沒有用來發射數據的方法。
示例五:Maybe發射單一數據和完成通知
maybeDemo1.jpg
示例六:Maybe發射單一數據和異常通知
maybeDemo2.jpg
MaybeEmitter:Maybe的發射器
可觀察對象Maybe的發射器接口MaybeEmitter中
1、方法void onSuccess(T t)用來發射一條單一的數據,且一次訂閱只能調用一次,不同于Observale的發射器ObservableEmitter中的void onNext(@NonNull T value)方法,在一次訂閱中,可以多次調用多次發射。
2、方法void onError(Throwable t)等同于ObservableEmitter中的void onError(@NonNull Throwable error);用來發射一條錯誤通知
3、方法onComplete()等同于Observale的發射器ObservableEmitter中的onComplete(),用來發射完成通知。
方法onComplete與onError只可調用一個,若先調用onError則會導致onComplete無效,若先調用onComplete,則會拋出io.reactivex.exceptions.UndeliverableException異常。
方法onSuccess必須在方法onComplete或onError之前調用,否則會導致方法onSuccess調用無效。
MaybeObserver:Maybe的觀察者
可觀察對象Maybe對應的觀察者為MaybeObserver
MaybeObserver.jpg
方法void onSubscribe(Disposable d)等同于Observer中的void onSubscribe(Disposable d)。
方法void onSuccess(T t)類似于Observer中的onNext(T t)用來接收Single發的數據。
方法void onError(Throwable e)等同于Observer中的void onError(Throwable e)用來處理異常通知。
方法void onComplete()等同于Observer中的void onComplete()用來接收完成通知。