Package io.reactivex.rxjava3.internal.observers

Class SafeSingleObserver<T>

java.lang.Object

io.reactivex.rxjava3.internal.observers.SafeSingleObserver<T>

Type Parameters:

T - the element type of the sequence

All Implemented Interfaces:

SingleObserver<T>

public final class SafeSingleObserver<T>
extends java.lang.Object
implements SingleObserver<T>

Wraps another SingleObserver and catches exceptions thrown by its onSubscribe, onSuccess or onError methods despite the protocol forbids it.

Such exceptions are routed to the RxJavaPlugins.onError(Throwable) handler.

Since:

3.0.0

Field Summary

Fields

Modifier and Type	Field	Description
(package private) SingleObserver<? super T>	downstream
(package private) boolean	onSubscribeFailed

Constructor Summary

Constructors

Constructor	Description
SafeSingleObserver(SingleObserver<? super T> downstream)

Method Summary

Modifier and Type	Method	Description
void	onError(@NonNull java.lang.Throwable e)	Notifies the SingleObserver that the Single has experienced an error condition.
void	onSubscribe(@NonNull Disposable d)	Provides the SingleObserver with the means of cancelling (disposing) the connection (channel) with the Single in both synchronous (from within onSubscribe(Disposable) itself) and asynchronous manner.
void	onSuccess(T t)	Notifies the SingleObserver with a single item and that the Single has finished sending push-based notifications.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

downstream

final SingleObserver<? super T> downstream

onSubscribeFailed

boolean onSubscribeFailed

Constructor Detail

SafeSingleObserver

public SafeSingleObserver(SingleObserver<? super T> downstream)

Method Detail

onSubscribe

public void onSubscribe(@NonNull
                        @NonNull Disposable d)

Description copied from interface: SingleObserver

Provides the SingleObserver with the means of cancelling (disposing) the connection (channel) with the Single in both synchronous (from within onSubscribe(Disposable) itself) and asynchronous manner.

Specified by:

onSubscribe in interface SingleObserver<T>

Parameters:

d - the Disposable instance whose Disposable.dispose() can be called anytime to cancel the connection

onSuccess

public void onSuccess(@NonNull
                      T t)

Description copied from interface: SingleObserver

Notifies the SingleObserver with a single item and that the Single has finished sending push-based notifications.

The Single will not call this method if it calls SingleObserver.onError(java.lang.Throwable).

Specified by:

onSuccess in interface SingleObserver<T>

Parameters:

t - the item emitted by the Single

onError

public void onError(@NonNull
                    @NonNull java.lang.Throwable e)

Description copied from interface: SingleObserver

Notifies the SingleObserver that the Single has experienced an error condition.

If the Single calls this method, it will not thereafter call SingleObserver.onSuccess(T).

Specified by:

onError in interface SingleObserver<T>

Parameters:

e - the exception encountered by the Single