Modifier and Type	Class and Description
pack-priv static class	ObservableCache.CacheDisposable< the value type T> Hosts the downstream consumer and its current requested and replay states.
pack-priv static class	ObservableCache.Node< the element type T> Represents a segment of the cached item list as part of a linked-node-list structure.

Field Summary

Modifier and Type	Field and Description
pack-priv final int	capacityHint The number of items per cached nodes.
pack-priv volatile boolean	done True if the source has terminated.
pack-priv static final ObservableCache.CacheDisposable<T>[]	EMPTY A shared instance of an empty array of observers to avoid creating a new empty array when all observers dispose.
pack-priv Throwable	error If `observers` is `TERMINATED`, this holds the terminal error if not null.
pack-priv final ObservableCache.Node<T>	head The starting point of the cached items.
pack-priv final AtomicReference<ObservableCache.CacheDisposable<T>[]>	observers The current known array of observer state to notify.
pack-priv final AtomicBoolean	once The subscription to the source should happen at most once.
pack-priv volatile long	size The total number of elements in the list available for reads.
pack-priv ObservableCache.Node<T>	tail The current tail of the linked structure holding the items.
pack-priv int	tailOffset How many items have been put into the tail node so far.
pack-priv static final ObservableCache.CacheDisposable<T>[]	TERMINATED A shared instance indicating the source has no more events and there is no need to remember observers anymore.

Inherited from io.reactivex.internal.operators.observable.AbstractObservableWithUpstream:: source

Constructor Summary

Access	Constructor and Description
public	ObservableCache(Observable<T> the source to subscribe to for the first incoming observer source, int the number of items expected (reduce allocation frequency) capacityHint) Constructs an empty, non-connected cache.

Method Summary

Modifier and Type	Method and Description
pack-priv void	add(ObservableCache.CacheDisposable<T> the consumer to add consumer) Atomically adds the consumer to the `observers` copy-on-write array if the source has not yet terminated.
pack-priv long	Returns: the number of currently cached event count cachedEventCount() Returns the number of events currently cached.
pack-priv boolean	Returns: true if the cache has observers hasObservers() Returns true if there are observers subscribed to this observable.
pack-priv boolean	Returns: true if already connected isConnected() Check if this cached observable is connected to its source.
public void	onComplete() Implements io.reactivex.Observer.onComplete. Notifies the Observer that the `Observable` has finished sending push-based notifications.
public void	onError(Throwable the exception encountered by the Observable t) Implements io.reactivex.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 io.reactivex.Observer.onNext. Provides the Observer with a new item to observe.
public void	onSubscribe(Disposable the Disposable instance whose `Disposable#dispose()` can be called anytime to cancel the connection d) Implements io.reactivex.Observer.onSubscribe. Provides the Observer with the means of cancelling (disposing) the connection (channel) with the Observable in both synchronous (from within `onNext(Object)`) and asynchronous manner.
pack-priv void	remove(ObservableCache.CacheDisposable<T> the consumer to remove consumer) Atomically removes the consumer from the `observers` copy-on-write array.
pack-priv void	replay(ObservableCache.CacheDisposable<T> the consumer to continue replaying items to consumer) Replays the contents of this cache to the given consumer based on its current state and number of items requested by it.
protected void	subscribeActual(Observer<? super T> the incoming Observer, never null t) Implements abstract io.reactivex.Observable.subscribeActual. Operator implementations (both source and intermediate) should implement this method that performs the necessary business logic and handles the incoming `Observer`s.

Inherited from io.reactivex.internal.operators.observable.AbstractObservableWithUpstream:: source

Field Detail

capacityHint	back to summary
pack-priv final int capacityHint The number of items per cached nodes.

done	back to summary
pack-priv volatile boolean done True if the source has terminated.

EMPTY	back to summary
pack-priv static final ObservableCache.CacheDisposable<T>[] EMPTY A shared instance of an empty array of observers to avoid creating a new empty array when all observers dispose. Annotations @SuppressWarnings:rawtypes

error	back to summary
pack-priv Throwable error If `observers` is `TERMINATED`, this holds the terminal error if not null.

head	back to summary
pack-priv final ObservableCache.Node<T> head The starting point of the cached items.

observers	back to summary
pack-priv final AtomicReference<ObservableCache.CacheDisposable<T>[]> observers The current known array of observer state to notify.

once	back to summary
pack-priv final AtomicBoolean once The subscription to the source should happen at most once.

size	back to summary
pack-priv volatile long size The total number of elements in the list available for reads.

tail	back to summary
pack-priv ObservableCache.Node<T> tail The current tail of the linked structure holding the items.

tailOffset	back to summary
pack-priv int tailOffset How many items have been put into the tail node so far.

TERMINATED	back to summary
pack-priv static final ObservableCache.CacheDisposable<T>[] TERMINATED A shared instance indicating the source has no more events and there is no need to remember observers anymore. Annotations @SuppressWarnings:rawtypes

Constructor Detail

ObservableCache	back to summary
public ObservableCache(Observable<T> source, int capacityHint) Constructs an empty, non-connected cache. Parameters source:Observable<T> the source to subscribe to for the first incoming observer capacityHint:int the number of items expected (reduce allocation frequency) Annotations @SuppressWarnings:unchecked

ObservableCache

back to summary

public ObservableCache(Observable<T> source, int capacityHint)

Constructs an empty, non-connected cache.

Parameters

source:Observable<T>: the source to subscribe to for the first incoming observer
capacityHint:int: the number of items expected (reduce allocation frequency)

Annotations

@SuppressWarnings:unchecked

Method Detail

add back to summary

add	back to summary
pack-priv void add(ObservableCache.CacheDisposable<T> consumer) Atomically adds the consumer to the `observers` copy-on-write array if the source has not yet terminated. Parameters consumer:ObservableCache.CacheDisposable<T> the consumer to add

pack-priv void add(ObservableCache.CacheDisposable<T> consumer)

Atomically adds the consumer to the observers copy-on-write array if the source has not yet terminated.

Parameters

consumer:ObservableCache.CacheDisposable<T>: the consumer to add

cachedEventCount	back to summary
pack-priv long cachedEventCount() Returns the number of events currently cached. Returns:long the number of currently cached event count

cachedEventCount

back to summary

pack-priv long cachedEventCount()

Returns the number of events currently cached.

Returns:long: the number of currently cached event count

hasObservers	back to summary
pack-priv boolean hasObservers() Returns true if there are observers subscribed to this observable. Returns:boolean true if the cache has observers

hasObservers

back to summary

pack-priv boolean hasObservers()

Returns true if there are observers subscribed to this observable.

Returns:boolean: true if the cache has observers

isConnected	back to summary
pack-priv boolean isConnected() Check if this cached observable is connected to its source. Returns:boolean true if already connected

isConnected

back to summary

pack-priv boolean isConnected()

Check if this cached observable is connected to its source.

Returns:boolean: true if already connected

onComplete back to summary

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

public void onComplete()

Implements io.reactivex.Observer.onComplete.

Doc from io.reactivex.Observer.onComplete.

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

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

Annotations

@SuppressWarnings:unchecked
@Override

onError back to summary

onError	back to summary
public void onError(Throwable t) Implements io.reactivex.Observer.onError. Doc from io.reactivex.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 `onComplete`. Parameters t:Throwable the exception encountered by the Observable Annotations @SuppressWarnings:unchecked @Override

public void onError(Throwable t)

Implements io.reactivex.Observer.onError.

Doc from io.reactivex.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 onComplete.

Parameters

t:Throwable: the exception encountered by the Observable

Annotations

@SuppressWarnings:unchecked
@Override

onNext back to summary

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

public void onNext(T t)

Implements io.reactivex.Observer.onNext.

Doc from io.reactivex.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 onComplete or onError.

Parameters

t:T: the item emitted by the Observable

Annotations

@Override

onSubscribe back to summary

onSubscribe	back to summary
public void onSubscribe(Disposable d) Implements io.reactivex.Observer.onSubscribe. Doc from io.reactivex.Observer.onSubscribe. Provides the Observer with the means of cancelling (disposing) the connection (channel) with the Observable in both synchronous (from within `onNext(Object)`) and asynchronous manner. Parameters d:Disposable the Disposable instance whose `Disposable#dispose()` can be called anytime to cancel the connection Annotations @Override

public void onSubscribe(Disposable d)

Implements io.reactivex.Observer.onSubscribe.

Doc from io.reactivex.Observer.onSubscribe.

Provides the Observer with the means of cancelling (disposing) the connection (channel) with the Observable in both synchronous (from within onNext(Object)) and asynchronous manner.

Parameters

d:Disposable: the Disposable instance whose Disposable#dispose() can be called anytime to cancel the connection

Annotations

@Override

remove back to summary

remove	back to summary
pack-priv void remove(ObservableCache.CacheDisposable<T> consumer) Atomically removes the consumer from the `observers` copy-on-write array. Parameters consumer:ObservableCache.CacheDisposable<T> the consumer to remove Annotations @SuppressWarnings:unchecked

pack-priv void remove(ObservableCache.CacheDisposable<T> consumer)

Atomically removes the consumer from the observers copy-on-write array.

Parameters

consumer:ObservableCache.CacheDisposable<T>: the consumer to remove

Annotations

@SuppressWarnings:unchecked

replay	back to summary
pack-priv void replay(ObservableCache.CacheDisposable<T> consumer) Replays the contents of this cache to the given consumer based on its current state and number of items requested by it. Parameters consumer:ObservableCache.CacheDisposable<T> the consumer to continue replaying items to

replay

back to summary

pack-priv void replay(ObservableCache.CacheDisposable<T> consumer)

Replays the contents of this cache to the given consumer based on its current state and number of items requested by it.

Parameters

consumer:ObservableCache.CacheDisposable<T>: the consumer to continue replaying items to

subscribeActual back to summary

subscribeActual	back to summary
protected void subscribeActual(Observer<? super T> t) Implements abstract io.reactivex.Observable.subscribeActual. Doc from io.reactivex.Observable.subscribeActual. Operator implementations (both source and intermediate) should implement this method that performs the necessary business logic and handles the incoming `Observer`s. There is no need to call any of the plugin hooks on the current `Observable` instance or the `Observer`; all hooks and basic safeguards have been applied by `subscribe(Observer)` before this method gets called. Parameters t:Observer<? super T> the incoming Observer, never null Annotations @Override

protected void subscribeActual(Observer<? super T> t)

Implements abstract io.reactivex.Observable.subscribeActual.

Doc from io.reactivex.Observable.subscribeActual.

Operator implementations (both source and intermediate) should implement this method that performs the necessary business logic and handles the incoming Observers.

There is no need to call any of the plugin hooks on the current Observable instance or the Observer; all hooks and basic safeguards have been applied by subscribe(Observer) before this method gets called.

Parameters

t:Observer<? super T>: the incoming Observer, never null

Annotations

@Override

io.reactivex.internal.operators.observable back to summary

pack-priv final Class ObservableCache.CacheDisposable<T>

Class Inheritance

extends AtomicInteger
implements Disposable

java.lang.Object
java.lang.Number
java.util.concurrent.atomic.AtomicInteger
io.reactivex.internal.operators.observable.ObservableCache.CacheDisposable

All Implemented Interfaces

io.reactivex.disposables.Disposable

Type Parameters

<T>: the value type

Hosts the downstream consumer and its current requested and replay states. this holds the work-in-progress counter for the serialized replay.

Field Summary

Modifier and Type	Field and Description
pack-priv volatile boolean	disposed
pack-priv final Observer<? super T>	downstream
pack-priv long	index
pack-priv ObservableCache.Node<T>	node
pack-priv int	offset
pack-priv final ObservableCache<T>	parent
private static final long	serialVersionUID Hides java.util.concurrent.atomic.AtomicInteger.serialVersionUID.

Constructor Summary

Access	Constructor and Description
pack-priv	CacheDisposable(Observer<? super T> the actual consumer downstream, ObservableCache<T> the parent that holds onto the cached items parent) Constructs a new instance with the actual downstream consumer and the parent cache object.

Method Summary

Modifier and Type	Method and Description
public void	dispose() Implements io.reactivex.disposables.Disposable.dispose. Dispose the resource, the operation should be idempotent.
public boolean	isDisposed() Implements io.reactivex.disposables.Disposable.isDisposed. Returns true if this resource has been disposed.

Field Detail

disposed	back to summary
pack-priv volatile boolean disposed

downstream	back to summary
pack-priv final Observer<? super T> downstream

index	back to summary
pack-priv long index

node	back to summary
pack-priv ObservableCache.Node<T> node

offset	back to summary
pack-priv int offset

parent	back to summary
pack-priv final ObservableCache<T> parent

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

Constructor Detail

CacheDisposable	back to summary
pack-priv CacheDisposable(Observer<? super T> downstream, ObservableCache<T> parent) Constructs a new instance with the actual downstream consumer and the parent cache object. Parameters downstream:Observer<? super T> the actual consumer parent:ObservableCache<T> the parent that holds onto the cached items

CacheDisposable

back to summary

pack-priv CacheDisposable(Observer<? super T> downstream, ObservableCache<T> parent)

Constructs a new instance with the actual downstream consumer and the parent cache object.

Parameters

downstream:Observer<? super T>: the actual consumer
parent:ObservableCache<T>: the parent that holds onto the cached items

Method Detail

dispose	back to summary
public void dispose() Implements io.reactivex.disposables.Disposable.dispose. Doc from io.reactivex.disposables.Disposable.dispose. Dispose the resource, the operation should be idempotent. Annotations @Override

dispose

back to summary

public void dispose()

Implements io.reactivex.disposables.Disposable.dispose.

Doc from io.reactivex.disposables.Disposable.dispose.

Dispose the resource, the operation should be idempotent.

Annotations

@Override

isDisposed	back to summary
public boolean isDisposed() Implements io.reactivex.disposables.Disposable.isDisposed. Doc from io.reactivex.disposables.Disposable.isDisposed. Returns true if this resource has been disposed. Returns:boolean true if this resource has been disposed Annotations @Override

isDisposed

back to summary

public boolean isDisposed()

Implements io.reactivex.disposables.Disposable.isDisposed.

Doc from io.reactivex.disposables.Disposable.isDisposed.

Returns true if this resource has been disposed.

Returns:boolean

true if this resource has been disposed

Annotations

@Override

Modifier and Type	Field and Description
pack-priv volatile ObservableCache.Node<T>	next The next node if not null.
pack-priv final T[]	values The array of values held by this node.

public final Class ObservableCache<T>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class ObservableCache.CacheDisposable<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class ObservableCache.Node<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail