如需下載源碼，請?jiān)L問
https://github.com/fengchuanfang/Rxjava2Tutorial
文章原創(chuàng)，轉(zhuǎn)載請注明出處：
Rxjava2入門教程六：Single、Completable、Maybe——簡化版的Observable

在Rxjava2中，Observale和Flowable都是用來發(fā)射數(shù)據(jù)流的，但是，我們在實(shí)際應(yīng)用中，很多時(shí)候，需要發(fā)射的數(shù)據(jù)并不是數(shù)據(jù)流的形式，而只是一條單一的數(shù)據(jù)，或者一條完成通知，或者一條錯(cuò)誤通知。在這種情況下，我們再使用Observable或者Flowable就顯得有點(diǎn)大材小用，于是，為了滿足這種單一數(shù)據(jù)或通知的使用場景，便出現(xiàn)了Observable的簡化版——Single、Completable、Maybe。

Single

只發(fā)射一條單一的數(shù)據(jù)，或者一條異常通知，不能發(fā)射完成通知，其中數(shù)據(jù)與通知只能發(fā)射一個(gè)。

Completable

只發(fā)射一條完成通知，或者一條異常通知，不能發(fā)射數(shù)據(jù)，其中完成通知與異常通知只能發(fā)射一個(gè)

Maybe

可發(fā)射一條單一的數(shù)據(jù)，以及發(fā)射一條完成通知，或者一條異常通知，其中完成通知和異常通知只能發(fā)射一個(gè)，發(fā)射數(shù)據(jù)只能在發(fā)射完成通知或者異常通知之前，否則發(fā)射數(shù)據(jù)無效。

示例一：Single發(fā)射單一數(shù)據(jù)

singleDemo1.jpg

示例二：Single發(fā)射異常通知

singleDemo2.jpg

SingleEmitter：Single的發(fā)射器

可觀察對象Single的發(fā)射器接口SingleEmitter中，

1、方法void onSuccess(T t)用來發(fā)射一條單一的數(shù)據(jù)，且一次訂閱只能調(diào)用一次，不同于Observale的發(fā)射器ObservableEmitter中的void onNext(@NonNull T value)方法，在一次訂閱中，可以多次調(diào)用多次發(fā)射。
2、方法void onError(Throwable t)等同于ObservableEmitter中的void onError(@NonNull Throwable error)用來發(fā)射一條錯(cuò)誤通知
3、SingleEmitter中沒有用來發(fā)射完成通知的void onComplete()方法。
方法onSuccess與onError只可調(diào)用一個(gè)，若先調(diào)用onError則會導(dǎo)致onSuccess無效，若先調(diào)用onSuccess,則會拋出io.reactivex.exceptions.UndeliverableException異常。

SingleObserver：Single觀察者

可觀察對象Single對應(yīng)的觀察者為SingleObserver

SingleObserver.jpg

方法void onSubscribe(Disposable d)等同于Observer中的void onSubscribe(Disposable d)。
方法void onSuccess(T t)類似于Observer中的onNext(T t)用來接收Single發(fā)的數(shù)據(jù)。
方法void onError(Throwable e)等同于Observer中的void onError(Throwable e)用來處理異常通知。
沒有用來處理完成通知的方法void onComplete()

示例三：Completable發(fā)射完成通知

completableDemo1.jpg

示例四：Completable發(fā)射異常通知

completableDemo2.jpg

CompletableEmitter：Completable的發(fā)射器

可觀察對象Completable的發(fā)射器接口CompletableEmitter中
1、方法onComplete()等同于Observale的發(fā)射器ObservableEmitter中的onComplete()，用來發(fā)射完成通知。
2、方法onError(Throwable e)等同于ObservableEmitter中的onError(Throwable e)，用來發(fā)射異常通知。
方法onComplete與onError只可調(diào)用一個(gè)，若先調(diào)用onError則會導(dǎo)致onComplete無效，若先調(diào)用onComplete,則會拋出io.reactivex.exceptions.UndeliverableException異常。

CompletableObserver：Completable的觀察者

可觀察對象Completable對應(yīng)的觀察者為CompletableObserver

completableObserver.jpg

其中的三個(gè)方法均等同于Observer中的對應(yīng)的方法，CompletableObserver中沒有用來發(fā)射數(shù)據(jù)的方法。

示例五：Maybe發(fā)射單一數(shù)據(jù)和完成通知

maybeDemo1.jpg

示例六：Maybe發(fā)射單一數(shù)據(jù)和異常通知

maybeDemo2.jpg

MaybeEmitter：Maybe的發(fā)射器

可觀察對象Maybe的發(fā)射器接口MaybeEmitter中
1、方法void onSuccess(T t)用來發(fā)射一條單一的數(shù)據(jù)，且一次訂閱只能調(diào)用一次，不同于Observale的發(fā)射器ObservableEmitter中的void onNext(@NonNull T value)方法，在一次訂閱中，可以多次調(diào)用多次發(fā)射。
2、方法void onError(Throwable t)等同于ObservableEmitter中的void onError(@NonNull Throwable error);用來發(fā)射一條錯(cuò)誤通知
3、方法onComplete()等同于Observale的發(fā)射器ObservableEmitter中的onComplete()，用來發(fā)射完成通知。
方法onComplete與onError只可調(diào)用一個(gè)，若先調(diào)用onError則會導(dǎo)致onComplete無效，若先調(diào)用onComplete,則會拋出io.reactivex.exceptions.UndeliverableException異常。
方法onSuccess必須在方法onComplete或onError之前調(diào)用，否則會導(dǎo)致方法onSuccess調(diào)用無效。

MaybeObserver：Maybe的觀察者

可觀察對象Maybe對應(yīng)的觀察者為MaybeObserver

MaybeObserver.jpg