rx.internal.operators.OnSubscribeCombineLatest Maven / Gradle / Ivy
Show all versions of rxjava-core Show documentation
/**
* Copyright 2014 Netflix, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
package rx.internal.operators;
import java.util.BitSet;
import java.util.List;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.concurrent.atomic.AtomicLong;
import java.util.concurrent.atomic.AtomicLongFieldUpdater;
import rx.Observable;
import rx.Observable.OnSubscribe;
import rx.Producer;
import rx.Subscriber;
import rx.exceptions.MissingBackpressureException;
import rx.functions.FuncN;
import rx.internal.util.RxRingBuffer;
/**
* Returns an Observable that combines the emissions of multiple source observables. Once each
* source Observable has emitted at least one item, combineLatest emits an item whenever any of
* the source Observables emits an item, by combining the latest emissions from each source
* Observable with a specified function.
*
* 
*
* @param
* the common basetype of the source values
* @param
* the result type of the combinator function
*/
public final class OnSubscribeCombineLatest implements OnSubscribe {
final List> sources;
final FuncN combinator;
public OnSubscribeCombineLatest(List> sources, FuncN combinator) {
this.sources = sources;
this.combinator = combinator;
if (sources.size() > 128) {
// For design simplicity this is limited to 128. If more are really needed we'll need to adjust
// the design of how RxRingBuffer is used in the implementation below.
throw new IllegalArgumentException("More than 128 sources to combineLatest is not supported.");
}
}
@Override
public void call(final Subscriber child) {
if (sources.isEmpty()) {
child.onCompleted();
return;
}
if (sources.size() == 1) {
child.setProducer(new SingleSourceProducer(child, sources.get(0), combinator));
} else {
child.setProducer(new MultiSourceProducer(child, sources, combinator));
}
}
/*
* benjchristensen => This implementation uses a buffer enqueue/drain pattern. It could be optimized to have a fast-path to
* skip the buffer and emit directly when no conflict, but that is quite complicated and I don't have the time to attempt it right now.
*/
final static class MultiSourceProducer implements Producer {
private final AtomicBoolean started = new AtomicBoolean();
private final AtomicLong requested = new AtomicLong();
private final List> sources;
private final Subscriber child;
private final FuncN combinator;
private final MultiSourceRequestableSubscriber[] subscribers;
/* following are guarded by WIP */
private final RxRingBuffer buffer = RxRingBuffer.getSpmcInstance();
private final Object[] collectedValues;
private final BitSet haveValues;
private volatile int haveValuesCount; // does this need to be volatile or is WIP sufficient?
private final BitSet completion;
private volatile int completionCount; // does this need to be volatile or is WIP sufficient?
@SuppressWarnings("unused")
private volatile long counter;
@SuppressWarnings("rawtypes")
private static final AtomicLongFieldUpdater WIP = AtomicLongFieldUpdater.newUpdater(MultiSourceProducer.class, "counter");
@SuppressWarnings("unchecked")
public MultiSourceProducer(final Subscriber child, final List> sources, FuncN combinator) {
this.sources = sources;
this.child = child;
this.combinator = combinator;
int n = sources.size();
this.subscribers = new MultiSourceRequestableSubscriber[n];
this.collectedValues = new Object[n];
this.haveValues = new BitSet(n);
this.completion = new BitSet(n);
}
@Override
public void request(long n) {
requested.getAndAdd(n);
if (!started.get() && started.compareAndSet(false, true)) {
/*
* NOTE: this logic will ONLY work if we don't have more sources than the size of the buffer.
*
* We would likely need to make an RxRingBuffer that can be sized to [numSources * n] instead
* of the current global default size it has.
*/
int sizePerSubscriber = RxRingBuffer.SIZE / sources.size();
int leftOver = RxRingBuffer.SIZE % sources.size();
for (int i = 0; i < sources.size(); i++) {
Observable o = sources.get(i);
int toRequest = sizePerSubscriber;
if (i == sources.size() - 1) {
toRequest += leftOver;
}
MultiSourceRequestableSubscriber s = new MultiSourceRequestableSubscriber(i, toRequest, child, this);
subscribers[i] = s;
o.unsafeSubscribe(s);
}
}
tick();
}
/**
* This will only allow one thread at a time to do the work, but ensures via `counter` increment/decrement
* that there is always once who acts on each `tick`. Same concept as used in OperationObserveOn.
*/
@SuppressWarnings("unchecked")
void tick() {
if (WIP.getAndIncrement(this) == 0) {
int emitted = 0;
do {
// we only emit if requested > 0
if (requested.get() > 0) {
Object o = buffer.poll();
if (o != null) {
if (buffer.isCompleted(o)) {
child.onCompleted();
} else {
child.onNext(NotificationLite.instance().getValue(o));
emitted++;
requested.decrementAndGet();
}
}
}
} while (WIP.decrementAndGet(this) > 0);
if (emitted > 0) {
for (MultiSourceRequestableSubscriber s : subscribers) {
s.requestUpTo(emitted);
}
}
}
}
public void onCompleted(int index, boolean hadValue) {
if (!hadValue) {
child.onCompleted();
return;
}
boolean done = false;
synchronized (this) {
if (!completion.get(index)) {
completion.set(index);
completionCount++;
done = completionCount == collectedValues.length;
}
}
if (done) {
buffer.onCompleted();
tick();
}
}
public void onNext(int index, T t) {
synchronized (this) {
if (!haveValues.get(index)) {
haveValues.set(index);
haveValuesCount++;
}
collectedValues[index] = t;
if (haveValuesCount != collectedValues.length) {
// haven't received value from each source yet so won't emit
return;
}
try {
buffer.onNext(combinator.call(collectedValues));
} catch (MissingBackpressureException e) {
onError(e);
} catch (Throwable e) {
onError(e);
}
}
tick();
}
public void onError(Throwable e) {
child.onError(e);
}
}
final static class MultiSourceRequestableSubscriber extends Subscriber {
final MultiSourceProducer producer;
final int index;
final AtomicLong emitted = new AtomicLong();
boolean hasValue = false;
public MultiSourceRequestableSubscriber(int index, int initial, Subscriber child, MultiSourceProducer producer) {
super(child);
this.index = index;
this.producer = producer;
request(initial);
}
public void requestUpTo(long n) {
long r = Math.min(emitted.get(), n);
request(r);
emitted.addAndGet(-r);
}
@Override
public void onCompleted() {
producer.onCompleted(index, hasValue);
}
@Override
public void onError(Throwable e) {
producer.onError(e);
}
@Override
public void onNext(T t) {
hasValue = true;
emitted.incrementAndGet();
producer.onNext(index, t);
}
}
final static class SingleSourceProducer implements Producer {
final AtomicBoolean started = new AtomicBoolean();
final Observable source;
final Subscriber child;
final FuncN combinator;
final SingleSourceRequestableSubscriber subscriber;
public SingleSourceProducer(final Subscriber child, Observable source, FuncN combinator) {
this.source = source;
this.child = child;
this.combinator = combinator;
this.subscriber = new SingleSourceRequestableSubscriber(child, combinator);
}
@Override
public void request(final long n) {
subscriber.requestMore(n);
if (started.compareAndSet(false, true)) {
source.unsafeSubscribe(subscriber);
}
}
}
final static class SingleSourceRequestableSubscriber extends Subscriber {
private final Subscriber child;
private final FuncN combinator;
SingleSourceRequestableSubscriber(Subscriber child, FuncN combinator) {
super(child);
this.child = child;
this.combinator = combinator;
}
public void requestMore(long n) {
request(n);
}
@Override
public void onNext(T t) {
child.onNext(combinator.call(t));
}
@Override
public void onError(Throwable e) {
child.onError(e);
}
@Override
public void onCompleted() {
child.onCompleted();
}
}
}