Package rx.observables

Class SyncOnSubscribe.SubscriptionProducer<S,T>

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.AtomicLong

rx.observables.SyncOnSubscribe.SubscriptionProducer<S,T>

Type Parameters:

T - the type of compatible Subscribers

All Implemented Interfaces:

Serializable, Observer<T>, Producer, Subscription

Enclosing class:

SyncOnSubscribe<S,T>

static final class SyncOnSubscribe.SubscriptionProducer<S,T>
extends AtomicLong
implements Producer, Subscription, Observer<T>

Contains the producer loop that reacts to downstream requests of work.

Field Summary

Fields

Modifier and Type	Field	Description
private final Subscriber<? super T>	actualSubscriber
private boolean	hasTerminated
private boolean	onNextCalled
private final SyncOnSubscribe<S,T>	parent
private static final long	serialVersionUID
private S	state

Constructor Summary

Constructors

Constructor	Description
SubscriptionProducer(Subscriber<? super T> subscriber, SyncOnSubscribe<S,T> parent, S state)

Method Summary

Modifier and Type	Method	Description
private void	doUnsubscribe()
private void	fastpath()
private void	handleThrownError(Subscriber<? super T> a, Throwable ex)
boolean	isUnsubscribed()	Indicates whether this Subscription is currently unsubscribed.
private void	nextIteration(SyncOnSubscribe<S,T> parent)
void	onCompleted()	Notifies the Observer that the Observable has finished sending push-based notifications.
void	onError(Throwable e)	Notifies the Observer that the Observable has experienced an error condition.
void	onNext(T value)	Provides the Observer with a new item to observe.
void	request(long n)	Request a certain maximum number of items from this Producer.
private void	slowPath(long n)
private boolean	tryUnsubscribe()
void	unsubscribe()	Stops the receipt of notifications on the Subscriber that was registered when this Subscription was received.

Methods inherited from class java.util.concurrent.atomic.AtomicLong

accumulateAndGet, addAndGet, compareAndExchange, compareAndExchangeAcquire, compareAndExchangeRelease, compareAndSet, decrementAndGet, doubleValue, floatValue, get, getAcquire, getAndAccumulate, getAndAdd, getAndDecrement, getAndIncrement, getAndSet, getAndUpdate, getOpaque, getPlain, incrementAndGet, intValue, lazySet, longValue, set, setOpaque, setPlain, setRelease, toString, updateAndGet, weakCompareAndSet, weakCompareAndSetAcquire, weakCompareAndSetPlain, weakCompareAndSetRelease, weakCompareAndSetVolatile

Methods inherited from class java.lang.Number

byteValue, shortValue

Methods inherited from class java.lang.Object

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

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

actualSubscriber

private final Subscriber<? super T> actualSubscriber

parent

private final SyncOnSubscribe<S,T> parent

onNextCalled

private boolean onNextCalled

hasTerminated

private boolean hasTerminated

state

private S state

Constructor Details

SubscriptionProducer

SubscriptionProducer(Subscriber<? super T> subscriber,
 SyncOnSubscribe<S,T> parent,
 S state)

Method Details

isUnsubscribed

public boolean isUnsubscribed()

Description copied from interface: Subscription

Indicates whether this Subscription is currently unsubscribed.

Specified by:

isUnsubscribed in interface Subscription

Returns:

true if this Subscription is currently unsubscribed, false otherwise

unsubscribe

public void unsubscribe()

Description copied from interface: Subscription

Stops the receipt of notifications on the Subscriber that was registered when this Subscription was received.

This allows unregistering an Subscriber before it has finished receiving all events (i.e. before onCompleted is called).

Specified by:

unsubscribe in interface Subscription

tryUnsubscribe

private boolean tryUnsubscribe()

doUnsubscribe

private void doUnsubscribe()

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

fastpath

private void fastpath()

handleThrownError

private void handleThrownError(Subscriber<? super T> a,
 Throwable ex)

slowPath

private void slowPath(long n)

nextIteration

private void nextIteration(SyncOnSubscribe<S,T> parent)

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<S>

onError

public void onError(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<S>

Parameters:

e - the exception encountered by the Observable

onNext

public void onNext(T value)

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<S>

Parameters:

value - the item emitted by the Observable