This operation takes values from the specified Observable source and stores them in the currently active chunks. Initially there are no chunks active.

Chunks can be created by pushing a TOpening value to the "bufferOpenings" Observable. This creates a new buffer which will then start recording values which are produced by the "source" Observable. Additionally the "bufferClosingSelector" will be used to construct an Observable which can produce values. When it does so it will close this (and only this) newly created buffer. When the source Observable completes or produces an error, all chunks are emitted, and the event is propagated to all subscribed Observers.

Note that when using this operation multiple overlapping chunks could be active at any one point.

Nested and Inner Type Summary

Modifier and Type	Class and Description
pack-priv class	OperatorBufferWithStartEndObservable.BufferingSubscriber

Field Summary

Modifier and Type	Field and Description
pack-priv final Func1<? super TOpening, ? extends Observable<? extends TClosing>>	bufferClosing
pack-priv final Observable<? extends TOpening>	bufferOpening

Access	Constructor and Description
public	OperatorBufferWithStartEndObservable(Observable<? extends TOpening> an `Observable` which when it produces a `TOpening` value will create a new buffer which instantly starts recording the "source" `Observable` bufferOpenings, Func1<? super TOpening, ? extends Observable<? extends TClosing>> a `Func1` object which produces `Observable`s. These `Observable`s determine when a buffer is emitted and replaced by simply producing an object. bufferClosingSelector)

Modifier and Type	Method and Description
public Subscriber<? super T>	call(final Subscriber<? super List<T>> child) Implements rx.functions.Func1.call.

Field Detail

bufferClosing	back to summary
pack-priv final Func1<? super TOpening, ? extends Observable<? extends TClosing>> bufferClosing

bufferOpening	back to summary
pack-priv final Observable<? extends TOpening> bufferOpening

Constructor Detail

OperatorBufferWithStartEndObservable back to summary

OperatorBufferWithStartEndObservable	back to summary
public OperatorBufferWithStartEndObservable(Observable<? extends TOpening> bufferOpenings, Func1<? super TOpening, ? extends Observable<? extends TClosing>> bufferClosingSelector) Parameters bufferOpenings:Observable<? extends TOpening> an `Observable` which when it produces a `TOpening` value will create a new buffer which instantly starts recording the "source" `Observable` bufferClosingSelector:Func1<? super TOpening, ? extends Observable<? extends TClosing>> a `Func1` object which produces `Observable`s. These `Observable`s determine when a buffer is emitted and replaced by simply producing an object.

public OperatorBufferWithStartEndObservable(Observable<? extends TOpening> bufferOpenings, Func1<? super TOpening, ? extends Observable<? extends TClosing>> bufferClosingSelector)

Parameters

bufferOpenings:Observable<? extends TOpening>: an Observable which when it produces a TOpening value will create a new buffer which instantly starts recording the "source" Observable
bufferClosingSelector:Func1<? super TOpening, ? extends Observable<? extends TClosing>>: a Func1 object which produces Observables. These Observables determine when a buffer is emitted and replaced by simply producing an object.

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

rx.internal.operators back to summary

pack-priv final Class OperatorBufferWithStartEndObservable.BufferingSubscriber

Class Inheritance

extends Subscriber<T>

java.lang.Object
rx.Subscriber
rx.internal.operators.OperatorBufferWithStartEndObservable.BufferingSubscriber

Field Summary

Modifier and Type	Field and Description
pack-priv final Subscriber<? super List<T>>	child
pack-priv final List<List<T>>	chunks Guarded by this.
pack-priv final CompositeSubscription	closingSubscriptions
pack-priv boolean	done Guarded by this.

Constructor Summary

Access	Constructor and Description
public	BufferingSubscriber(Subscriber<? super List<T>> child)

Method Summary

Modifier and Type	Method and Description
pack-priv void	endBuffer(List<T> toEnd)
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.
pack-priv void	startBuffer(TOpening v)

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

Field Detail

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

chunks	back to summary
pack-priv final List<List<T>> chunks Guarded by this.

closingSubscriptions	back to summary
pack-priv final CompositeSubscription closingSubscriptions

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

Constructor Detail

BufferingSubscriber	back to summary
public BufferingSubscriber(Subscriber<? super List<T>> child)

Method Detail

endBuffer	back to summary
pack-priv void endBuffer(List<T> toEnd)

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

startBuffer	back to summary
pack-priv void startBuffer(TOpening v)

public final Class OperatorBufferWithStartEndObservable<T, TOpening, TClosing>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class OperatorBufferWithStartEndObservable.BufferingSubscriber

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail