Package io.reactivex.rxjava3.observers

Class SerializedObserver<T>

java.lang.Object

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

Type Parameters:

T - the value type

All Implemented Interfaces:

Observer<T>, Disposable

public final class SerializedObserver<T>
extends java.lang.Object
implements Observer<T>, Disposable

Serializes access to the Observer.onNext(Object), Observer.onError(Throwable) and Observer.onComplete() methods of another Observer.

Note that onSubscribe(Disposable) is not serialized in respect of the other methods so make sure the onSubscribe() is called with a non-null Disposable before any of the other methods are called.

The implementation assumes that the actual Observer's methods don't throw.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) boolean	delayError
(package private) boolean	done
(package private) Observer<? super T>	downstream
(package private) boolean	emitting
(package private) AppendOnlyLinkedArrayList<java.lang.Object>	queue
(package private) static int	QUEUE_LINK_SIZE
(package private) Disposable	upstream

Constructor Summary

Constructors

Constructor	Description
SerializedObserver(@NonNull Observer<? super T> downstream)	Construct a SerializedObserver by wrapping the given actual Observer.
SerializedObserver(@NonNull Observer<? super T> actual, boolean delayError)	Construct a SerializedObserver by wrapping the given actual Observer and optionally delaying the errors till all regular values have been emitted from the internal buffer.

Method Summary

Modifier and Type	Method	Description
void	dispose()	Dispose the resource, the operation should be idempotent.
(package private) void	emitLoop()
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 java.lang.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

Field Detail

downstream

final Observer<? super T> downstream

delayError

final boolean delayError

QUEUE_LINK_SIZE

static final int QUEUE_LINK_SIZE

See Also:

Constant Field Values

upstream

Disposable upstream

emitting

boolean emitting

queue

AppendOnlyLinkedArrayList<java.lang.Object> queue

done

volatile boolean done

Constructor Detail

SerializedObserver

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

Construct a SerializedObserver by wrapping the given actual Observer.

Parameters:

downstream - the actual Observer, not null (not verified)

SerializedObserver

public SerializedObserver(@NonNull
                          @NonNull Observer<? super T> actual,
                          boolean delayError)

Construct a SerializedObserver by wrapping the given actual Observer and optionally delaying the errors till all regular values have been emitted from the internal buffer.

Parameters:

actual - the actual Observer, not null (not verified)

delayError - if true, errors are emitted after regular values have been emitted

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 java.lang.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>

emitLoop

void emitLoop()