Package com.tangosol.net

Class ViewBuilder<K,V_BACK,V_FRONT>

java.lang.Object

com.tangosol.net.MapViewBuilder<K,V_BACK,V_FRONT>

com.tangosol.net.ViewBuilder<K,V_BACK,V_FRONT>

Type Parameters:

K - the type of the cache entry keys

V_BACK - the type of the entry values in the back cache that is used as the source for this view

V_FRONT - the type of the entry values in this view, which will be the same as V_BACK, unless a transformer is specified when creating this view

public class ViewBuilder<K,V_BACK,V_FRONT>
extends MapViewBuilder<K,V_BACK,V_FRONT>

The ViewBuilder provides a means to build() a view (ContinuousQueryCache) using a fluent pattern / style.

Since:

12.2.1.4

Author:

rl 5.22.19

See Also:

• ContinuousQueryCache

Field Summary

Fields inherited from class com.tangosol.net.MapViewBuilder

f_supplierNamedCache, m_fCacheValues, m_filter, m_listener, m_loader, m_mapper

Constructor Summary

Constructors

Constructor	Description
ViewBuilder(NamedCache<K,V_BACK> cache)	Construct a new ViewBuilder for the provided NamedCache.
ViewBuilder(Supplier<NamedCache<K,V_BACK>> supplierNamedCache)	Construct a new ViewBuilder for the provided NamedCache.

Method Summary

Modifier and Type	Method	Description
NamedCache<K,V_FRONT>	build()	Construct a view of the NamedCache provided to this builder.
ViewBuilder<K,V_BACK,V_FRONT>	filter(Filter filter)	The Filter that will be used to define the entries maintained in this view.
ViewBuilder<K,V_BACK,V_FRONT>	keys()	The resulting view will only cache keys.
ViewBuilder<K,V_BACK,V_FRONT>	listener(MapListener<? super K,? super V_FRONT> listener)	The MapListener that will receive all events, including those that result from the initial population of the view.
ViewBuilder<K,V_BACK,V_FRONT>	map(ValueExtractor<? super V_BACK,? extends V_FRONT> mapper)	The ValueExtractor that this view will use to transform the results from the underlying cache prior to storing them locally.
ViewBuilder<K,V_BACK,V_FRONT>	values()	The resulting view with cache both keys and values.
ViewBuilder<K,V_BACK,V_FRONT>	withClassLoader(ClassLoader loader)	The optional ClassLoader to use when performing serialization/de-serialization operations.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ViewBuilder

public ViewBuilder(NamedCache<K,V_BACK> cache)

Construct a new ViewBuilder for the provided NamedCache.

Parameters:

cache - the NamedCache from which the view will be created

ViewBuilder

public ViewBuilder(Supplier<NamedCache<K,V_BACK>> supplierNamedCache)

Construct a new ViewBuilder for the provided NamedCache. The Supplier should return a new NamedCache instance upon each invocation.

Parameters:

supplierNamedCache - the Supplier returning a NamedCache from which the view will be created

Method Details

filter

public ViewBuilder<K,V_BACK,V_FRONT> filter(Filter filter)

The Filter that will be used to define the entries maintained in this view. If no Filter is specified, AlwaysFilter.INSTANCE will be used.

Overrides:

filter in class MapViewBuilder<K,V_BACK,V_FRONT>

Parameters:

filter - the Filter that will be used to query the underlying NamedCache

Returns:

this ViewBuilder

listener

public ViewBuilder<K,V_BACK,V_FRONT> listener(MapListener<? super K,? super V_FRONT> listener)

The MapListener that will receive all events, including those that result from the initial population of the view.

Overrides:

listener in class MapViewBuilder<K,V_BACK,V_FRONT>

Parameters:

listener - the MapListener that will receive all the events from the view, including those corresponding to its initial population.

Returns:

this ViewBuilder

map

public ViewBuilder<K,V_BACK,V_FRONT> map(ValueExtractor<? super V_BACK,? extends V_FRONT> mapper)

The ValueExtractor that this view will use to transform the results from the underlying cache prior to storing them locally.

Overrides:

map in class MapViewBuilder<K,V_BACK,V_FRONT>

Parameters:

mapper - the ValueExtractor that will be used to transform values retrieved from the underlying cache before storing them locally; if specified, this view will become read-only

Returns:

this ViewBuilder

keys

public ViewBuilder<K,V_BACK,V_FRONT> keys()

The resulting view will only cache keys. NOTE: this is mutually exclusive with values().

Overrides:

keys in class MapViewBuilder<K,V_BACK,V_FRONT>

Returns:

this ViewBuilder

values

public ViewBuilder<K,V_BACK,V_FRONT> values()

The resulting view with cache both keys and values. NOTE: this is mutually exclusive with keys().

Overrides:

values in class MapViewBuilder<K,V_BACK,V_FRONT>

Returns:

this ViewBuilder

withClassLoader

public ViewBuilder<K,V_BACK,V_FRONT> withClassLoader(ClassLoader loader)

The optional ClassLoader to use when performing serialization/de-serialization operations.

Overrides:

withClassLoader in class MapViewBuilder<K,V_BACK,V_FRONT>

Parameters:

loader - the ClassLoader

Returns:

this ViewBuilder

build

public NamedCache<K,V_FRONT> build()

Construct a view of the NamedCache provided to this builder.

Overrides:

build in class MapViewBuilder<K,V_BACK,V_FRONT>

Returns:

the view of the NamedCache provided to this builder