io.reactivex.rxjava3.observers

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and 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.
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.
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 java.lang.Object

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

Methods inherited from interface io.reactivex.rxjava3.disposables.Disposable

disposed, empty, fromAction, fromAutoCloseable, fromFuture, fromFuture, fromRunnable, fromSubscription, toAutoCloseable

Constructor Detail

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 Detail

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

Specified by:

onNext in interface Observer<T>

Parameters:

t - the item emitted by the Observable

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

Specified by:

onComplete in interface Observer<T>