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 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) final 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 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 Object

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

Field Details

downstream

final SingleObserver<? super T> downstream

onSubscribeFailed

boolean onSubscribeFailed

Constructor Details

SafeSingleObserver

public SafeSingleObserver(SingleObserver<? super T> downstream)

Method Details

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(Throwable).

Specified by:

onSuccess in interface SingleObserver<T>

Parameters:

t - the item emitted by the Single

onError

public void onError(@NonNull
 @NonNull 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