Package rx.observables

Class AsyncOnSubscribe.AsyncOuterManager<S,T>

java.lang.Object

rx.observables.AsyncOnSubscribe.AsyncOuterManager<S,T>

All Implemented Interfaces:

Observer<Observable<? extends T>>, Producer, Subscription

Enclosing class:

AsyncOnSubscribe<S,T>

static final class AsyncOnSubscribe.AsyncOuterManager<S,T>
extends Object
implements Producer, Subscription, Observer<Observable<? extends T>>

Field Summary

Fields

Modifier and Type	Field	Description
(package private) Producer	concatProducer
(package private) boolean	emitting
(package private) long	expectedDelivery
private boolean	hasTerminated
(package private) final AtomicBoolean	isUnsubscribed
private final AsyncOnSubscribe.UnicastSubject<Observable<T>>	merger
private boolean	onNextCalled
private final AsyncOnSubscribe<S,T>	parent
(package private) List<Long>	requests
private final SerializedObserver<Observable<? extends T>>	serializedSubscriber
private S	state
(package private) final CompositeSubscription	subscriptions

Constructor Summary

Constructors

Constructor	Description
AsyncOuterManager(AsyncOnSubscribe<S,T> parent, S initialState, AsyncOnSubscribe.UnicastSubject<Observable<T>> merger)

Method Summary

Modifier and Type	Method	Description
(package private) void	cleanup()
private void	handleThrownError(Throwable ex)
boolean	isUnsubscribed()	Indicates whether this Subscription is currently unsubscribed.
void	nextIteration(long requestCount)
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(Observable<? extends 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	requestRemaining(long n)	Called when a source has produced less than its provision (completed prematurely); this will trigger the generation of another source that will hopefully emit the missing amount.
(package private) void	setConcatProducer(Producer p)
private void	subscribeBufferToObservable(Observable<? extends T> t)
(package private) boolean	tryEmit(long n)
void	unsubscribe()	Stops the receipt of notifications on the Subscriber that was registered when this Subscription was received.

Methods inherited from class java.lang.Object

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

Field Details

isUnsubscribed

final AtomicBoolean isUnsubscribed

parent

private final AsyncOnSubscribe<S,T> parent

serializedSubscriber

private final SerializedObserver<Observable<? extends T>> serializedSubscriber

subscriptions

final CompositeSubscription subscriptions

hasTerminated

private boolean hasTerminated

onNextCalled

private boolean onNextCalled

state

private S state

merger

private final AsyncOnSubscribe.UnicastSubject<Observable<T>> merger

emitting

boolean emitting

requests

List<Long> requests

concatProducer

Producer concatProducer

expectedDelivery

long expectedDelivery

Constructor Details

AsyncOuterManager

public AsyncOuterManager(AsyncOnSubscribe<S,T> parent,
 S initialState,
 AsyncOnSubscribe.UnicastSubject<Observable<T>> merger)

Method Details

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

setConcatProducer

void setConcatProducer(Producer p)

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

nextIteration

public void nextIteration(long requestCount)

cleanup

void cleanup()

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

requestRemaining

public void requestRemaining(long n)

Called when a source has produced less than its provision (completed prematurely); this will trigger the generation of another source that will hopefully emit the missing amount.

Parameters:

n - the missing amount to produce via a new source.

tryEmit

boolean tryEmit(long n)

handleThrownError

private void handleThrownError(Throwable ex)

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(Observable<? extends 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<S>

Parameters:

t - the item emitted by the Observable

subscribeBufferToObservable

private void subscribeBufferToObservable(Observable<? extends T> t)