reactor.core.subscriber

Class MultiSubscriptionSubscriber<I,O>

java.lang.Object

reactor.core.subscriber.MultiSubscriptionSubscriber<I,O>

Type Parameters:

I - the input value type

O - the output value type

All Implemented Interfaces:

org.reactivestreams.Subscriber<I>, org.reactivestreams.Subscription, Producer, Receiver, Cancellable, Completable, Requestable

public abstract class MultiSubscriptionSubscriber<I,O>
extends java.lang.Object
implements org.reactivestreams.Subscription, org.reactivestreams.Subscriber<I>, Producer, Cancellable, Requestable, Receiver, Completable

A subscription implementation that arbitrates request amounts between subsequent Subscriptions, including the duration until the first Subscription is set.

The class is thread safe but switching Subscriptions should happen only when the source associated with the current Subscription has finished emitting values. Otherwise, two sources may emit for one request.

You should call produced(long) or producedOne() after each element has been delivered to properly account the outstanding request amount in case a Subscription switch happens.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.reactivestreams.Subscriber<? super O>	subscriber
protected boolean	unbounded

Constructor Summary

Constructors

Constructor and Description
MultiSubscriptionSubscriber(org.reactivestreams.Subscriber<? super O> subscriber)

Method Summary

Modifier and Type	Method and Description
void	cancel()
org.reactivestreams.Subscriber<? super O>	downstream() Return the direct data receiver.
boolean	isCancelled()
boolean	isStarted() Has this upstream started or "onSubscribed" ?
boolean	isTerminated() Has this upstream finished or "completed" / "failed" ?
boolean	isUnbounded()
void	onComplete()
void	onError(java.lang.Throwable t)
void	onSubscribe(org.reactivestreams.Subscription s)
void	produced(long n)
void	producedOne()
void	request(long n)
long	requestedFromDownstream() Return defined element capacity, used to drive new Subscription request needs.
void	set(org.reactivestreams.Subscription s)
protected boolean	shouldCancelCurrent()
org.reactivestreams.Subscription	upstream() Return the direct source of data, Supports reference.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.reactivestreams.Subscriber

onNext

Field Detail

subscriber

protected final org.reactivestreams.Subscriber<? super O> subscriber

unbounded

protected boolean unbounded

Constructor Detail

MultiSubscriptionSubscriber

public MultiSubscriptionSubscriber(org.reactivestreams.Subscriber<? super O> subscriber)

Method Detail

onSubscribe

public void onSubscribe(org.reactivestreams.Subscription s)

Specified by:

onSubscribe in interface org.reactivestreams.Subscriber<I>

onError

public void onError(java.lang.Throwable t)

Specified by:

onError in interface org.reactivestreams.Subscriber<I>

onComplete

public void onComplete()

Specified by:

onComplete in interface org.reactivestreams.Subscriber<I>

set

public final void set(org.reactivestreams.Subscription s)

request

public final void request(long n)

Specified by:

request in interface org.reactivestreams.Subscription

producedOne

public final void producedOne()

produced

public final void produced(long n)

cancel

public void cancel()

Specified by:

cancel in interface org.reactivestreams.Subscription

isCancelled

public final boolean isCancelled()

Specified by:

isCancelled in interface Cancellable

Returns:

has the downstream "cancelled" and interrupted its consuming ?

downstream

public final org.reactivestreams.Subscriber<? super O> downstream()

Description copied from interface: Producer

Return the direct data receiver.

Specified by:

downstream in interface Producer

Returns:

the direct data receiver

upstream

public final org.reactivestreams.Subscription upstream()

Description copied from interface: Receiver

Return the direct source of data, Supports reference.

Specified by:

upstream in interface Receiver

Returns:

the direct source of data, Supports reference.

requestedFromDownstream

public final long requestedFromDownstream()

Description copied from interface: Requestable

Return defined element capacity, used to drive new Subscription request needs. This is the maximum in-flight data allowed to transit to this elements.

Specified by:

requestedFromDownstream in interface Requestable

Returns:

long capacity

isTerminated

public boolean isTerminated()

Description copied from interface: Completable

Has this upstream finished or "completed" / "failed" ?

Specified by:

isTerminated in interface Completable

Returns:

has this upstream finished or "completed" / "failed" ?

isStarted

public boolean isStarted()

Description copied from interface: Completable

Has this upstream started or "onSubscribed" ?

Specified by:

isStarted in interface Completable

Returns:

has this upstream started or "onSubscribed" ?

isUnbounded

public final boolean isUnbounded()

shouldCancelCurrent

protected boolean shouldCancelCurrent()