Package rx.internal.producers

Class ProducerObserverArbiter<T>

java.lang.Object

rx.internal.producers.ProducerObserverArbiter<T>

Type Parameters:

T - the value type

All Implemented Interfaces:

Observer<T>, Producer

public final class ProducerObserverArbiter<T>
extends java.lang.Object
implements Producer, Observer<T>

Producer that serializes any event emission with requesting and producer changes.

The implementation shortcuts on error and overwrites producers that got delayed, similar to ProducerArbiter.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) Subscriber<? super T>	child
(package private) Producer	currentProducer
(package private) boolean	emitting
(package private) boolean	hasError
(package private) Producer	missedProducer
(package private) long	missedRequested
(package private) java.lang.Object	missedTerminal
(package private) static Producer	NULL_PRODUCER
(package private) java.util.List<T>	queue
(package private) long	requested

Constructor Summary

Constructors

Constructor	Description
ProducerObserverArbiter(Subscriber<? super T> child)

Method Summary

Modifier and Type	Method	Description
(package private) void	emitLoop()
void	onCompleted()	Notifies the Observer that the Observable has finished sending push-based notifications.
void	onError(java.lang.Throwable e)	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	request(long n)	Request a certain maximum number of items from this Producer.
void	setProducer(Producer p)

Methods inherited from class java.lang.Object

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

Field Detail

child

final Subscriber<? super T> child

emitting

boolean emitting

queue

java.util.List<T> queue

currentProducer

Producer currentProducer

requested

long requested

missedRequested

long missedRequested

missedProducer

Producer missedProducer

missedTerminal

java.lang.Object missedTerminal

hasError

volatile boolean hasError

NULL_PRODUCER

static final Producer NULL_PRODUCER

Constructor Detail

ProducerObserverArbiter

public ProducerObserverArbiter(Subscriber<? super T> child)

Method Detail

onNext

public void onNext(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.onCompleted() 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(java.lang.Throwable e)

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

Specified by:

onError in interface Observer<T>

Parameters:

e - the exception encountered by the Observable

onCompleted

public void onCompleted()

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:

onCompleted in interface Observer<T>

request

public void request(long n)

Description copied from interface: Producer

Request a certain maximum number of items from this Producer. This is a way of requesting backpressure. To disable backpressure, pass Long.MAX_VALUE to this method.

Requests are additive but if a sequence of requests totals more than Long.MAX_VALUE then Long.MAX_VALUE requests will be actioned and the extras may be ignored. Arriving at Long.MAX_VALUE by addition of requests cannot be assumed to disable backpressure. For example, the code below may result in Long.MAX_VALUE requests being actioned only.

 request(100);
 request(Long.MAX_VALUE-1);
 

Specified by:

request in interface Producer

Parameters:

n - the maximum number of items you want this Producer to produce, or Long.MAX_VALUE if you want the Producer to produce items at its own pace

setProducer

public void setProducer(Producer p)

emitLoop

void emitLoop()