Top Description Fields Constructors Methods
io.reactivex.subscribers

public final Class SerializedSubscriber<T>

extends Object
implements FlowableSubscriber<T>, Subscription
Class Inheritance
All Implemented Interfaces
org.reactivestreams.Subscription, io.reactivex.FlowableSubscriber, org.reactivestreams.Subscriber
Type Parameters
<T>
the value type
Imports
org.reactivestreams.*, io.reactivex.FlowableSubscriber, io.reactivex.internal.subscriptions.SubscriptionHelper, io.reactivex.internal.util.*, io.reactivex.plugins.RxJavaPlugins
Serializes access to the onNext, onError and onComplete methods of another Subscriber.

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

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

Field Summary

Modifier and TypeField and Description
pack-priv final boolean
delayError

pack-priv volatile boolean
done

pack-priv final Subscriber<? super T>
downstream

pack-priv boolean
emitting

pack-priv AppendOnlyLinkedArrayList<Object>
queue

pack-priv Subscription
upstream

Constructor Summary

AccessConstructor and Description
public
SerializedSubscriber(Subscriber<? super T>
the actual Subscriber, not null (not verified)
downstream)

Construct a SerializedSubscriber by wrapping the given actual Subscriber.

public
SerializedSubscriber(Subscriber<? super T>
the actual Subscriber, not null (not verified)
actual, boolean
if true, errors are emitted after regular values have been emitted
delayError)

Construct a SerializedSubscriber 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 TypeMethod and Description
public void
cancel()

Implements org.reactivestreams.Subscription.cancel.

Request the Publisher to stop sending data and clean up resources.
pack-priv void
emitLoop()

public void
onComplete()

Implements org.reactivestreams.Subscriber.onComplete.

Successful terminal state.
public void
onError(Throwable
the throwable signaled
t)

Implements org.reactivestreams.Subscriber.onError.

Failed terminal state.
public void
onNext(T
the element signaled
t)

Implements org.reactivestreams.Subscriber.onNext.

Data notification sent by the Publisher in response to requests to Subscription#request(long).
public void
onSubscribe(Subscription
the Subscription that allows requesting data via Subscription#request(long)
s)

Implements io.reactivex.FlowableSubscriber.onSubscribe.

Implementors of this method should make sure everything that needs to be visible in onNext(Object) is established before calling Subscription#request(long).
public void
request(long
the strictly positive number of elements to requests to the upstream Publisher
n)

Implements org.reactivestreams.Subscription.request.

No events will be sent by a Publisher until demand is signaled via this method.
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

delayErrorback to summary
pack-priv final boolean delayError
doneback to summary
pack-priv volatile boolean done
downstreamback to summary
pack-priv final Subscriber<? super T> downstream
emittingback to summary
pack-priv boolean emitting
queueback to summary
pack-priv AppendOnlyLinkedArrayList<Object> queue
upstreamback to summary
pack-priv Subscription upstream

Constructor Detail

SerializedSubscriberback to summary
public SerializedSubscriber(Subscriber<? super T> downstream)

Construct a SerializedSubscriber by wrapping the given actual Subscriber.

Parameters
downstream:Subscriber<? super T>

the actual Subscriber, not null (not verified)

SerializedSubscriberback to summary
public SerializedSubscriber(Subscriber<? super T> actual, boolean delayError)

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

Parameters
actual:Subscriber<? super T>

the actual Subscriber, not null (not verified)

delayError:boolean

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

Method Detail

cancelback to summary
public void cancel()

Implements org.reactivestreams.Subscription.cancel.

Doc from org.reactivestreams.Subscription.cancel.

Request the Publisher to stop sending data and clean up resources.

Data may still be sent to meet previously signalled demand after calling cancel.

Annotations
@Override
emitLoopback to summary
pack-priv void emitLoop()
onCompleteback to summary
public void onComplete()

Implements org.reactivestreams.Subscriber.onComplete.

Doc from org.reactivestreams.Subscriber.onComplete.

Successful terminal state.

No further events will be sent even if Subscription#request(long) is invoked again.

Annotations
@Override
onErrorback to summary
public void onError(Throwable t)

Implements org.reactivestreams.Subscriber.onError.

Doc from org.reactivestreams.Subscriber.onError.

Failed terminal state.

No further events will be sent even if Subscription#request(long) is invoked again.

Parameters
t:Throwable

the throwable signaled

Annotations
@Override
onNextback to summary
public void onNext(T t)

Implements org.reactivestreams.Subscriber.onNext.

Doc from org.reactivestreams.Subscriber.onNext.

Data notification sent by the Publisher in response to requests to Subscription#request(long).

Parameters
t:T

the element signaled

Annotations
@Override
onSubscribeback to summary
public void onSubscribe(Subscription s)

Implements io.reactivex.FlowableSubscriber.onSubscribe.

Doc from io.reactivex.FlowableSubscriber.onSubscribe.

Implementors of this method should make sure everything that needs to be visible in onNext(Object) is established before calling Subscription#request(long). In practice this means no initialization should happen after the request() call and additional behavior is thread safe in respect to onNext. Invoked after calling Publisher#subscribe(Subscriber).

No data will start flowing until Subscription#request(long) is invoked.

It is the responsibility of this Subscriber instance to call Subscription#request(long) whenever more data is wanted.

The Publisher will send notifications only in response to Subscription#request(long).

Parameters
s:Subscription

Doc from org.reactivestreams.Subscriber.onSubscribe.

the Subscription that allows requesting data via Subscription#request(long)

Annotations
@Override
requestback to summary
public void request(long n)

Implements org.reactivestreams.Subscription.request.

Doc from org.reactivestreams.Subscription.request.

No events will be sent by a Publisher until demand is signaled via this method.

It can be called however often and whenever needed—but if the outstanding cumulative demand ever becomes Long.MAX_VALUE or more, it may be treated by the Publisher as "effectively unbounded".

Whatever has been requested can be sent by the Publisher so only signal demand for what can be safely handled.

A Publisher can send less than is requested if the stream ends but then must emit either Subscriber#onError(Throwable) or Subscriber#onComplete().

Parameters
n:long

the strictly positive number of elements to requests to the upstream Publisher

Annotations
@Override