Modifier and Type	Class and Description
pack-priv static class	OperatorMerge.HolderDelayErrors Lazy initialization via inner-class holder.
pack-priv static class	OperatorMerge.HolderNoDelay Lazy initialization via inner-class holder.
pack-priv static class	OperatorMerge.InnerSubscriber<T>
pack-priv static class	OperatorMerge.MergeProducer<T>
pack-priv static class	OperatorMerge.MergeSubscriber< the value type T> The subscriber that observes Observables.

Modifier and Type	Field and Description
pack-priv final boolean	delayErrors
pack-priv final int	maxConcurrent

Access	Constructor and Description
pack-priv	OperatorMerge(boolean delayErrors, int maxConcurrent)

Modifier and Type	Method and Description
public Subscriber<Observable<? extends T>>	call(final Subscriber<? super T> child) Implements rx.functions.Func1.call.
public static < the common value type T> OperatorMerge<T>	Returns: a singleton instance of this stateless operator. instance(boolean should the merge delay errors? delayErrors)
public static < the value type T> OperatorMerge<T>	Returns: the Operator instance with the given settings instance(boolean if true, errors are delayed till all sources terminate, if false the first error will be emitted and all sequences unsubscribed delayErrors, int the maximum number of concurrent subscriptions or Integer.MAX_VALUE for unlimited maxConcurrent) Creates a new instance of the operator with the given delayError and maxConcurrency settings.

delayErrors	back to summary
pack-priv final boolean delayErrors

maxConcurrent	back to summary
pack-priv final int maxConcurrent

OperatorMerge	back to summary
pack-priv OperatorMerge(boolean delayErrors, int maxConcurrent)

call	back to summary
public Subscriber<Observable<? extends T>> call(final Subscriber<? super T> child) Implements rx.functions.Func1.call. Annotations @Override

instance	back to summary
public static <T> OperatorMerge<T> instance(boolean delayErrors) Parameters <T> the common value type delayErrors:boolean should the merge delay errors? Returns:OperatorMerge<T> a singleton instance of this stateless operator. Annotations @SuppressWarnings:unchecked

instance	back to summary
public static <T> OperatorMerge<T> instance(boolean delayErrors, int maxConcurrent) Creates a new instance of the operator with the given delayError and maxConcurrency settings. Parameters <T> the value type delayErrors:boolean if true, errors are delayed till all sources terminate, if false the first error will be emitted and all sequences unsubscribed maxConcurrent:int the maximum number of concurrent subscriptions or Integer.MAX_VALUE for unlimited Returns:OperatorMerge<T> the Operator instance with the given settings

pack-priv final Class OperatorMerge.HolderDelayErrors

Class Inheritance

extends Object

java.lang.Object
rx.internal.operators.OperatorMerge.HolderDelayErrors

Lazy initialization via inner-class holder.

Field Summary

Modifier and Type	Field and Description
pack-priv static final OperatorMerge<Object>	INSTANCE A singleton instance.

Constructor Summary

Access	Constructor and Description
pack-priv	HolderDelayErrors()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

INSTANCE	back to summary
pack-priv static final OperatorMerge<Object> INSTANCE A singleton instance.

Constructor Detail

HolderDelayErrors	back to summary
pack-priv HolderDelayErrors()

rx.internal.operators back to summary

pack-priv final Class OperatorMerge.HolderNoDelay

Class Inheritance

extends Object

java.lang.Object
rx.internal.operators.OperatorMerge.HolderNoDelay

Lazy initialization via inner-class holder.

Field Summary

Modifier and Type	Field and Description
pack-priv static final OperatorMerge<Object>	INSTANCE A singleton instance.

Constructor Summary

Access	Constructor and Description
pack-priv	HolderNoDelay()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

INSTANCE	back to summary
pack-priv static final OperatorMerge<Object> INSTANCE A singleton instance.

Constructor Detail

HolderNoDelay	back to summary
pack-priv HolderNoDelay()

rx.internal.operators back to summary

pack-priv final Class OperatorMerge.InnerSubscriber<T>

Class Inheritance

extends Subscriber<T>

java.lang.Object
rx.Subscriber
rx.internal.operators.OperatorMerge.InnerSubscriber

Field Summary

Modifier and Type	Field and Description
pack-priv volatile boolean	done
pack-priv final long	id
pack-priv static final int	LIMIT
pack-priv int	outstanding
pack-priv final OperatorMerge.MergeSubscriber<T>	parent
pack-priv volatile RxRingBuffer	queue

Constructor Summary

Access	Constructor and Description
public	InnerSubscriber(OperatorMerge.MergeSubscriber<T> parent, long id)

Method Summary

Modifier and Type	Method and Description
public void	onCompleted() Implements rx.Observer.onCompleted. Notifies the Observer that the `Observable` has finished sending push-based notifications.
public void	onError(Throwable the exception encountered by the Observable e) Implements rx.Observer.onError. Notifies the Observer that the `Observable` has experienced an error condition.
public void	onNext(T the item emitted by the Observable t) Implements rx.Observer.onNext. Provides the Observer with a new item to observe.
public void	onStart() Overrides rx.Subscriber.onStart. This method is invoked when the Subscriber and Observable have been connected but the Observable has not yet begun to emit items or send notifications to the Subscriber.
public void	requestMore(long n)

Inherited from rx.Subscriber:: add isUnsubscribed request setProducer unsubscribe

Field Detail

done	back to summary
pack-priv volatile boolean done

id	back to summary
pack-priv final long id

LIMIT	back to summary
pack-priv static final int LIMIT

outstanding	back to summary
pack-priv int outstanding

parent	back to summary
pack-priv final OperatorMerge.MergeSubscriber<T> parent

queue	back to summary
pack-priv volatile RxRingBuffer queue

Constructor Detail

InnerSubscriber	back to summary
public InnerSubscriber(OperatorMerge.MergeSubscriber<T> parent, long id)

Method Detail

onCompleted back to summary

onCompleted	back to summary
public void onCompleted() Implements rx.Observer.onCompleted. Doc from rx.Observer.onCompleted. Notifies the Observer that the `Observable` has finished sending push-based notifications. The `Observable` will not call this method if it calls `onError`. Annotations @Override

public void onCompleted()

Implements rx.Observer.onCompleted.

Doc from rx.Observer.onCompleted.

Notifies the Observer that the Observable has finished sending push-based notifications.

The Observable will not call this method if it calls onError.

Annotations

@Override

onError back to summary

onError	back to summary
public void onError(Throwable e) Implements rx.Observer.onError. Doc from rx.Observer.onError. Notifies the Observer that the `Observable` has experienced an error condition. If the `Observable` calls this method, it will not thereafter call `onNext` or `onCompleted`. Parameters e:Throwable the exception encountered by the Observable Annotations @Override

public void onError(Throwable e)

Implements rx.Observer.onError.

Doc from rx.Observer.onError.

Notifies the Observer that the Observable has experienced an error condition.

If the Observable calls this method, it will not thereafter call onNext or onCompleted.

Parameters

e:Throwable: the exception encountered by the Observable

Annotations

@Override

onNext back to summary

onNext	back to summary
public void onNext(T t) Implements rx.Observer.onNext. Doc from rx.Observer.onNext. 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 `onCompleted` or `onError`. Parameters t:T the item emitted by the Observable Annotations @Override

public void onNext(T t)

Implements rx.Observer.onNext.

Doc from rx.Observer.onNext.

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 onCompleted or onError.

Parameters

t:T: the item emitted by the Observable

Annotations

@Override

onStart	back to summary
public void onStart() Overrides rx.Subscriber.onStart. Doc from rx.Subscriber.onStart. This method is invoked when the Subscriber and Observable have been connected but the Observable has not yet begun to emit items or send notifications to the Subscriber. Override this method to add any useful initialization to your subscription, for instance to initiate backpressure. Annotations @Override

onStart

back to summary

public void onStart()

Overrides rx.Subscriber.onStart.

Doc from rx.Subscriber.onStart.

This method is invoked when the Subscriber and Observable have been connected but the Observable has not yet begun to emit items or send notifications to the Subscriber. Override this method to add any useful initialization to your subscription, for instance to initiate backpressure.

Annotations

@Override

requestMore	back to summary
public void requestMore(long n)

rx.internal.operators back to summary

pack-priv final Class OperatorMerge.MergeProducer<T>

Class Inheritance

extends AtomicLong
implements Producer

java.lang.Object
java.lang.Number
java.util.concurrent.atomic.AtomicLong
rx.internal.operators.OperatorMerge.MergeProducer

All Implemented Interfaces

rx.Producer

Field Summary

Modifier and Type	Field and Description
private static final long	serialVersionUID Hides java.util.concurrent.atomic.AtomicLong.serialVersionUID.
pack-priv final OperatorMerge.MergeSubscriber<T>	subscriber

Constructor Summary

Access	Constructor and Description
public	MergeProducer(OperatorMerge.MergeSubscriber<T> subscriber)

Method Summary

Modifier and Type	Method and Description
public long	produced(int n)
public void	request(long 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 n) Implements rx.Producer.request. Request a certain maximum number of items from this Producer.

Field Detail

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.util.concurrent.atomic.AtomicLong.serialVersionUID.

subscriber	back to summary
pack-priv final OperatorMerge.MergeSubscriber<T> subscriber

Constructor Detail

MergeProducer	back to summary
public MergeProducer(OperatorMerge.MergeSubscriber<T> subscriber)

Method Detail

produced	back to summary
public long produced(int n)

request back to summary

request	back to summary
public void request(long n) Implements rx.Producer.request. Doc from rx.Producer.request. 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); Parameters n:long 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 Annotations @Override

public void request(long n)

Implements rx.Producer.request.

Doc from rx.Producer.request.

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);

Parameters

n:long: 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

Annotations

@Override

rx.internal.operators back to summary

pack-priv final Class OperatorMerge.MergeSubscriber<T>

Class Inheritance

extends Subscriber<Observable<? extends T>>

java.lang.Object
rx.Subscriber
rx.internal.operators.OperatorMerge.MergeSubscriber

Type Parameters

<T>: the value type

The subscriber that observes Observables.

Field Summary

Modifier and Type	Field and Description
pack-priv final Subscriber<? super T>	child
pack-priv final boolean	delayErrors
pack-priv volatile boolean	done
pack-priv boolean	emitting Guarded by this.
pack-priv static final OperatorMerge.InnerSubscriber<?>[]	EMPTY An empty array to avoid creating new empty arrays in removeInner.
pack-priv volatile ConcurrentLinkedQueue<Throwable>	errors Due to the emission loop, we need to store errors somewhere if !delayErrors.
pack-priv final Object	innerGuard
pack-priv volatile OperatorMerge.InnerSubscriber<?>[]	innerSubscribers Copy-on-write array, guarded by innerGuard.
pack-priv long	lastId Which was the last InnerSubscriber that emitted?
pack-priv int	lastIndex What was its index in the innerSubscribers array?
pack-priv final int	maxConcurrent
pack-priv boolean	missed Guarded by this.
pack-priv OperatorMerge.MergeProducer<T>	producer Hides rx.Subscriber.producer.
pack-priv volatile Queue<Object>	queue
pack-priv int	scalarEmissionCount
pack-priv final int	scalarEmissionLimit
pack-priv volatile CompositeSubscription	subscriptions Hides rx.Subscriber.subscriptions. Tracks the active subscriptions to sources.
pack-priv long	uniqueId Used to generate unique InnerSubscriber IDs.

Constructor Summary

Access	Constructor and Description
public	MergeSubscriber(Subscriber<? super T> child, boolean delayErrors, int maxConcurrent)

Method Summary

Modifier and Type	Method and Description
pack-priv void	addInner(OperatorMerge.InnerSubscriber<T> inner)
pack-priv boolean	Returns: true if the child unsubscribed or there are errors available and merge doesn't delay errors. checkTerminate() Check if the operator reached some terminal state: child unsubscribed, an error was reported and we don't delay errors.
pack-priv void	emit()
pack-priv void	emitEmpty()
pack-priv void	emitLoop() The standard emission loop serializing events and requests.
protected void	emitScalar(OperatorMerge.InnerSubscriber<T> subscriber, T value, long r)
protected void	emitScalar(T value, long r)
pack-priv CompositeSubscription	getOrCreateComposite()
pack-priv Queue<Throwable>	getOrCreateErrorQueue()
public void	onCompleted() Implements rx.Observer.onCompleted. Notifies the Observer that the `Observable` has finished sending push-based notifications.
public void	onError(Throwable the exception encountered by the Observable e) Implements rx.Observer.onError. Notifies the Observer that the `Observable` has experienced an error condition.
public void	onNext(Observable<? extends T> the item emitted by the Observable t) Implements rx.Observer.onNext. Provides the Observer with a new item to observe.
protected void	queueScalar(OperatorMerge.InnerSubscriber<T> subscriber, T value)
protected void	queueScalar(T value)
pack-priv void	removeInner(OperatorMerge.InnerSubscriber<T> inner)
private void	reportError()
public void	requestMore(long n)
pack-priv void	tryEmit(OperatorMerge.InnerSubscriber<T> the subscriber to one of the inner Observables running subscriber, T the value that inner Observable produced value) Tries to emit the value directly to the child if no concurrent emission is happening at the moment.
pack-priv void	tryEmit(T the scalar value the main Observable emitted through `just()` value) Tries to emit the value directly to the child if no concurrent emission is happening at the moment.

Inherited from rx.Subscriber:: add isUnsubscribed onStart request setProducer unsubscribe

Field Detail

child	back to summary
pack-priv final Subscriber<? super T> child

delayErrors	back to summary
pack-priv final boolean delayErrors

done	back to summary
pack-priv volatile boolean done

emitting	back to summary
pack-priv boolean emitting Guarded by this.

EMPTY	back to summary
pack-priv static final OperatorMerge.InnerSubscriber<?>[] EMPTY An empty array to avoid creating new empty arrays in removeInner.

errors	back to summary
pack-priv volatile ConcurrentLinkedQueue<Throwable> errors Due to the emission loop, we need to store errors somewhere if !delayErrors.

innerGuard	back to summary
pack-priv final Object innerGuard

innerSubscribers	back to summary
pack-priv volatile OperatorMerge.InnerSubscriber<?>[] innerSubscribers Copy-on-write array, guarded by innerGuard.

lastId	back to summary
pack-priv long lastId Which was the last InnerSubscriber that emitted? Accessed if emitting == true.

lastIndex	back to summary
pack-priv int lastIndex What was its index in the innerSubscribers array? Accessed if emitting == true.

maxConcurrent	back to summary
pack-priv final int maxConcurrent

missed	back to summary
pack-priv boolean missed Guarded by this.

producer	back to summary
pack-priv OperatorMerge.MergeProducer<T> producer Hides rx.Subscriber.producer.

queue	back to summary
pack-priv volatile Queue<Object> queue

scalarEmissionCount	back to summary
pack-priv int scalarEmissionCount

scalarEmissionLimit	back to summary
pack-priv final int scalarEmissionLimit

subscriptions

back to summary

pack-priv volatile CompositeSubscription subscriptions

Hides rx.Subscriber.subscriptions.

Tracks the active subscriptions to sources.

uniqueId	back to summary
pack-priv long uniqueId Used to generate unique InnerSubscriber IDs. Modified from onNext only.

Constructor Detail

MergeSubscriber	back to summary
public MergeSubscriber(Subscriber<? super T> child, boolean delayErrors, int maxConcurrent)

Method Detail

addInner	back to summary
pack-priv void addInner(OperatorMerge.InnerSubscriber<T> inner)

checkTerminate

back to summary

pack-priv boolean checkTerminate()

Check if the operator reached some terminal state: child unsubscribed, an error was reported and we don't delay errors.

Returns:boolean: true if the child unsubscribed or there are errors available and merge doesn't delay errors.

emit	back to summary
pack-priv void emit()

emitEmpty	back to summary
pack-priv void emitEmpty()

emitLoop	back to summary
pack-priv void emitLoop() The standard emission loop serializing events and requests.

emitScalar	back to summary
protected void emitScalar(OperatorMerge.InnerSubscriber<T> subscriber, T value, long r)

emitScalar	back to summary
protected void emitScalar(T value, long r)

getOrCreateComposite	back to summary
pack-priv CompositeSubscription getOrCreateComposite()

getOrCreateErrorQueue	back to summary
pack-priv Queue<Throwable> getOrCreateErrorQueue()

onCompleted back to summary

public void onCompleted()

Implements rx.Observer.onCompleted.

Doc from rx.Observer.onCompleted.

Notifies the Observer that the Observable has finished sending push-based notifications.

The Observable will not call this method if it calls onError.

Annotations

@Override

onError back to summary

public void onError(Throwable e)

Implements rx.Observer.onError.

Doc from rx.Observer.onError.

Notifies the Observer that the Observable has experienced an error condition.

If the Observable calls this method, it will not thereafter call onNext or onCompleted.

Parameters

e:Throwable: the exception encountered by the Observable

Annotations

@Override

onNext back to summary

public void onNext(Observable<? extends T> t)

Implements rx.Observer.onNext.

Doc from rx.Observer.onNext.

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 onCompleted or onError.

Parameters

t:Observable<? extends T>: the item emitted by the Observable

Annotations

@Override

queueScalar	back to summary
protected void queueScalar(OperatorMerge.InnerSubscriber<T> subscriber, T value)

queueScalar	back to summary
protected void queueScalar(T value)

removeInner	back to summary
pack-priv void removeInner(OperatorMerge.InnerSubscriber<T> inner)

reportError	back to summary
private void reportError()

requestMore	back to summary
public void requestMore(long n)

tryEmit

back to summary

pack-priv void tryEmit(OperatorMerge.InnerSubscriber<T> subscriber, T value)

Tries to emit the value directly to the child if no concurrent emission is happening at the moment.

Since the scalar-value queue optimization applies to both the main source and the inner subscribers, we handle things in a shared manner.

Parameters

subscriber:OperatorMerge.InnerSubscriber<T>: the subscriber to one of the inner Observables running
value:T: the value that inner Observable produced

tryEmit back to summary

pack-priv void tryEmit(T value)

Tries to emit the value directly to the child if no concurrent emission is happening at the moment.

Since the scalar-value queue optimization applies to both the main source and the inner subscribers, we handle things in a shared manner.

Parameters

value:T: the scalar value the main Observable emitted through just()

public final Class OperatorMerge<T>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class OperatorMerge.HolderDelayErrors

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

pack-priv final Class OperatorMerge.HolderNoDelay

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

pack-priv final Class OperatorMerge.InnerSubscriber<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class OperatorMerge.MergeProducer<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class OperatorMerge.MergeSubscriber<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail