A solution to the "time gap" problem that occurs with groupBy and pivot.

This currently has temporary unbounded buffers. It needs to become bounded and then do one of two things:

blow up and make the user do something about it
work with the backpressure solution ... still to be implemented (such as co-routines)

Generally the buffer should be very short lived (milliseconds) and then stops being involved. It can become a memory leak though if a GroupedObservable backed by this class is emitted but never subscribed to (such as filtered out). In that case, either a time-bomb to throw away the buffer, or just blowing up and making the user do something about it is needed.

For example, to filter out GroupedObservables, perhaps they need a silent subscribe() on them to just blackhole the data.

This is an initial start at solving this problem and solves the immediate problem of groupBy and pivot and trades off the possibility of memory leak for deterministic functionality.

Modifier and Type	Class and Description
pack-priv static class	BufferUntilSubscriber.OnSubscribeAction<T>
pack-priv static class	BufferUntilSubscriber.State<T> The common state.

Field Summary

Modifier and Type	Field and Description
pack-priv static final Observer<T>	EMPTY_OBSERVER
private boolean	forward
pack-priv final BufferUntilSubscriber.State<T>	state

Constructor Summary

Access	Constructor and Description
private	BufferUntilSubscriber(BufferUntilSubscriber.State<T> state)

Method Summary

Modifier and Type	Method and Description
public static < the value type T> BufferUntilSubscriber<T>	Returns: the instance create() Creates a default, unbounded buffering Subject instance.
private void	emit(Object v)
public boolean	hasObservers() Implements abstract rx.subjects.Subject.hasObservers. Indicates whether the `Subject` has `Observers` subscribed to it.
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.

Inherited from rx.subjects.Subject:: toSerialized

Field Detail

EMPTY_OBSERVER	back to summary
pack-priv static final Observer<T> EMPTY_OBSERVER Annotations @SuppressWarnings:rawtypes

forward	back to summary
private boolean forward

state	back to summary
pack-priv final BufferUntilSubscriber.State<T> state

Constructor Detail

BufferUntilSubscriber	back to summary
private BufferUntilSubscriber(BufferUntilSubscriber.State<T> state)

Method Detail

create	back to summary
public static <T> BufferUntilSubscriber<T> create() Creates a default, unbounded buffering Subject instance. Parameters <T> the value type Returns:BufferUntilSubscriber<T> the instance

create

back to summary

public static <T> BufferUntilSubscriber<T> create()

Creates a default, unbounded buffering Subject instance.

Parameters

<T>: the value type

Returns:BufferUntilSubscriber<T>

the instance

emit	back to summary
private void emit(Object v)

hasObservers back to summary

hasObservers	back to summary
public boolean hasObservers() Implements abstract rx.subjects.Subject.hasObservers. Doc from rx.subjects.Subject.hasObservers. Indicates whether the `Subject` has `Observers` subscribed to it. Returns:boolean true if there is at least one Observer subscribed to this Subject, false otherwise Annotations @Override

public boolean hasObservers()

Implements abstract rx.subjects.Subject.hasObservers.

Doc from rx.subjects.Subject.hasObservers.

Indicates whether the Subject has Observers subscribed to it.

Returns:boolean

true if there is at least one Observer subscribed to this Subject, false otherwise

Annotations

@Override

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

rx.internal.operators back to summary

pack-priv final Class BufferUntilSubscriber.OnSubscribeAction<T>

Class Inheritance

extends Object
implements Observable.OnSubscribe<T>

java.lang.Object
rx.internal.operators.BufferUntilSubscriber.OnSubscribeAction

All Implemented Interfaces

rx.Observable.OnSubscribe, rx.functions.Action1, rx.functions.Action, rx.functions.Function

Field Summary

Modifier and Type	Field and Description
pack-priv final BufferUntilSubscriber.State<T>	state

Constructor Summary

Access	Constructor and Description
public	OnSubscribeAction(BufferUntilSubscriber.State<T> state)

Method Summary

Modifier and Type	Method and Description
public void	call(final Subscriber<? super T> s) Implements rx.functions.Action1.call.

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

Field Detail

state	back to summary
pack-priv final BufferUntilSubscriber.State<T> state

Constructor Detail

OnSubscribeAction	back to summary
public OnSubscribeAction(BufferUntilSubscriber.State<T> state)

Method Detail

call	back to summary
public void call(final Subscriber<? super T> s) Implements rx.functions.Action1.call. Annotations @Override

call

back to summary

public void call(final Subscriber<? super T> s)

Implements rx.functions.Action1.call.

Annotations

@Override

rx.internal.operators back to summary

pack-priv final Class BufferUntilSubscriber.State<T>

Class Inheritance

extends AtomicReference<Observer<? super T>>

java.lang.Object
java.util.concurrent.atomic.AtomicReference
rx.internal.operators.BufferUntilSubscriber.State

The common state.

Field Summary

Modifier and Type	Field and Description
pack-priv final ConcurrentLinkedQueue<Object>	buffer
pack-priv boolean	emitting
pack-priv final Object	guard
private static final long	serialVersionUID Hides java.util.concurrent.atomic.AtomicReference.serialVersionUID.

Constructor Summary

Access	Constructor and Description
pack-priv	State()

Method Summary

Modifier and Type	Method and Description
pack-priv boolean	casObserverRef(Observer<? super T> expected, Observer<? super T> next)

Field Detail

buffer	back to summary
pack-priv final ConcurrentLinkedQueue<Object> buffer

emitting	back to summary
pack-priv boolean emitting

guard	back to summary
pack-priv final Object guard

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

Constructor Detail

State	back to summary
pack-priv State()

Method Detail

casObserverRef	back to summary
pack-priv boolean casObserverRef(Observer<? super T> expected, Observer<? super T> next)

public final Class BufferUntilSubscriber<T>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class BufferUntilSubscriber.OnSubscribeAction<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class BufferUntilSubscriber.State<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail