Class SafeObserver<T>

java.lang.Object

io.reactivex.rxjava3.observers.SafeObserver<T>

Type Parameters:

T - the value type

All Implemented Interfaces:

Observer<T>, Disposable

public final class SafeObserver<T>
extends Object
implements Observer<T>, Disposable

Wraps another Observer and ensures all onXXX methods conform the protocol (except the requirement for serialized access).

Field Summary

Fields

Modifier and Type	Field	Description
(package private) boolean	done	Indicates a terminal state.
(package private) final Observer<? super T>	downstream	The actual Subscriber.
(package private) Disposable	upstream	The subscription.

Constructor Summary

Constructors

Constructor	Description
SafeObserver(@NonNull Observer<? super T> downstream)	Constructs a SafeObserver by wrapping the given actual Observer.

Method Summary

Modifier and Type	Method	Description
void	dispose()	Dispose the resource, the operation should be idempotent.
boolean	isDisposed()	Returns true if this resource has been disposed.
void	onComplete()	Notifies the Observer that the Observable has finished sending push-based notifications.
(package private) void	onCompleteNoSubscription()
void	onError(@NonNull Throwable t)	Notifies the Observer that the Observable has experienced an error condition.
void	onNext(T t)	Provides the Observer with a new item to observe.
(package private) void	onNextNoSubscription()
void	onSubscribe(@NonNull Disposable d)	Provides the Observer with the means of cancelling (disposing) the connection (channel) with the Observable in both synchronous (from within Observer.onNext(Object)) and asynchronous manner.

Methods inherited from class Object

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

Field Details

downstream

final Observer<? super T> downstream

The actual Subscriber.

upstream

Disposable upstream

The subscription.

done

boolean done

Indicates a terminal state.

Constructor Details

SafeObserver

public SafeObserver(@NonNull
 @NonNull Observer<? super T> downstream)

Constructs a SafeObserver by wrapping the given actual Observer.

Parameters:

downstream - the actual Observer to wrap, not null (not validated)

Method Details

onSubscribe

public void onSubscribe(@NonNull
 @NonNull Disposable d)

Description copied from interface: Observer

Provides the Observer with the means of cancelling (disposing) the connection (channel) with the Observable in both synchronous (from within Observer.onNext(Object)) and asynchronous manner.

Specified by:

onSubscribe in interface Observer<T>

Parameters:

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

dispose

public void dispose()

Description copied from interface: Disposable

Dispose the resource, the operation should be idempotent.

Specified by:

dispose in interface Disposable

isDisposed

public boolean isDisposed()

Description copied from interface: Disposable

Returns true if this resource has been disposed.

Specified by:

isDisposed in interface Disposable

Returns:

true if this resource has been disposed

onNext

public void onNext(@NonNull
 T t)

Description copied from interface: Observer

Provides the Observer with a new item to observe.

The Observable may call this method 0 or more times.

The Observable will not call this method again after it calls either Observer.onComplete() or Observer.onError(Throwable).

Specified by:

onNext in interface Observer<T>

Parameters:

t - the item emitted by the Observable

onNextNoSubscription

void onNextNoSubscription()

onError

public void onError(@NonNull
 @NonNull Throwable t)

Description copied from interface: Observer

Notifies the Observer that the Observable has experienced an error condition.

If the Observable calls this method, it will not thereafter call Observer.onNext(T) or Observer.onComplete().

Specified by:

onError in interface Observer<T>

Parameters:

t - the exception encountered by the Observable

onComplete

public void onComplete()

Description copied from interface: Observer

Notifies the Observer that the Observable has finished sending push-based notifications.

The Observable will not call this method if it calls Observer.onError(Throwable).

Specified by:

onComplete in interface Observer<T>

onCompleteNoSubscription

void onCompleteNoSubscription()