cz.o2.proxima.direct.view

Interface CachedView

All Superinterfaces:

AttributeWriterBase, java.lang.AutoCloseable, java.io.Closeable, OnlineAttributeWriter, RandomAccessReader

All Known Implementing Classes:

LocalCachedPartitionedView

@Stable
public interface CachedView
extends RandomAccessReader, OnlineAttributeWriter

A view of commit-log that caches (and potentially checkpoints) data from partitions and makes in random accessible.

Client can provide callbacks to be called on data updates. Client might also update the view, all updates must be persisted in a way that will guarantee that subsequent reloads will contain the new data and that read-write operations have happens-before relation semantics.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	CachedView.Factory Serializable factory for CachedView.

Nested classes/interfaces inherited from interface cz.o2.proxima.direct.randomaccess.RandomAccessReader

RandomAccessReader.Listing

Nested classes/interfaces inherited from interface cz.o2.proxima.direct.core.AttributeWriterBase

AttributeWriterBase.Type

Method Summary

Modifier and Type	Method and Description
CachedView.Factory	asFactory() Convert instance of this view to CachedView.Factory suitable for serialization.
default void	assign(java.util.Collection<Partition> partitions) Assign and make given partitions accessible by random reads.
void	assign(java.util.Collection<Partition> partitions, BiConsumer<StreamElement,Pair<java.lang.Long,java.lang.Object>> updateCallback) Assign and make given partitions accessible by random reads.
void	cache(StreamElement element) Cache given StreamElement into local cache without writing it to the underlaying writer.
java.util.Collection<Partition>	getAssigned() Retrieve currently assigned partitions.
java.util.Collection<Partition>	getPartitions() Retrieve all partitions of the underlying commit log.

Methods inherited from interface cz.o2.proxima.direct.randomaccess.RandomAccessReader

fetchOffset, get, get, get, get, getEntityDescriptor, listEntities, listEntities, newBuilder, scanWildcard, scanWildcard, scanWildcard, scanWildcard, scanWildcardAll, scanWildcardAll, scanWildcardAll, scanWildcardAll

Methods inherited from interface java.io.Closeable

close

Methods inherited from interface cz.o2.proxima.direct.core.OnlineAttributeWriter

getType, rollback, write

Methods inherited from interface cz.o2.proxima.direct.core.AttributeWriterBase

bulk, close, getUri, online

Method Detail

assign

default void assign(java.util.Collection<Partition> partitions)

Assign and make given partitions accessible by random reads. If the view contains any partitions not listed in the collection, these partitions are dropped.

Parameters:

partitions - the partitions to cache locally

assign

void assign(java.util.Collection<Partition> partitions,
            BiConsumer<StreamElement,Pair<java.lang.Long,java.lang.Object>> updateCallback)

Assign and make given partitions accessible by random reads. If the view contains any partitions not listed in the collection, these partitions are dropped.

Parameters:

partitions - the partitions to cache locally

updateCallback - function that is called when cache gets updated the function takes the new ingest element and pair of the most recent object that was associated with the key and it's currently associated stamp

getAssigned

java.util.Collection<Partition> getAssigned()

Retrieve currently assigned partitions.

Returns:

currently assigned partitions

cache

void cache(StreamElement element)

Cache given StreamElement into local cache without writing it to the underlaying writer. This is used in conjunction with attribute family proxy.

Parameters:

element - the data to cache

getPartitions

java.util.Collection<Partition> getPartitions()

Retrieve all partitions of the underlying commit log.

Returns:

all partitions of underlying commit log

asFactory

CachedView.Factory asFactory()

Convert instance of this view to CachedView.Factory suitable for serialization.

Specified by:

asFactory in interface AttributeWriterBase

Specified by:

asFactory in interface OnlineAttributeWriter

Specified by:

asFactory in interface RandomAccessReader

Returns:

the CachedView.Factory representing this view