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()用来接收完成通知。

                                                                  
                                                                           全栈开发者微信公众号 

猜你喜欢

转载自blog.csdn.net/qiujiaxin050/article/details/81188281