com.tangosol.net

Class ViewBuilder<K,V_BACK,V_FRONT>

java.lang.Object

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 Object

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

Constructor Summary

Constructors

Constructor and 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 and 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 Detail

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 Detail

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.

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.

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.

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().

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().

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.

Parameters:

loader - the ClassLoader

Returns:

this ViewBuilder

build

public NamedCache<K,V_FRONT> build()

Construct a view of the NamedCache provided to this builder.

Returns:

the view of the NamedCache provided to this builder