Package com.oracle.coherence.client

Class NamedCacheClient<K,V>

java.lang.Object

com.oracle.coherence.client.NamedCacheClient<K,V>

Type Parameters:

K - the type of the cache keys

V - the type of the cache values

All Implemented Interfaces:

com.tangosol.net.cache.CacheMap<K,V>, com.tangosol.net.NamedCache<K,V>, com.tangosol.net.NamedCollection, com.tangosol.net.NamedMap<K,V>, com.tangosol.net.Releasable, com.tangosol.util.ConcurrentMap<K,V>, com.tangosol.util.InvocableMap<K,V>, com.tangosol.util.ObservableMap<K,V>, com.tangosol.util.QueryMap<K,V>, AutoCloseable, Map<K,V>

public class NamedCacheClient<K,V>
extends Object
implements com.tangosol.net.NamedCache<K,V>

Implementation of a NamedCache that wraps an AsyncNamedCacheClient.

Since:

20.06

Author:

Jonathan Knight 2019.11.07

Nested Class Summary

Nested classes/interfaces inherited from interface com.tangosol.util.InvocableMap

com.tangosol.util.InvocableMap.Entry<K extends Object,V extends Object>, com.tangosol.util.InvocableMap.EntryAggregator<K extends Object,V extends Object,R extends Object>, com.tangosol.util.InvocableMap.EntryProcessor<K extends Object,V extends Object,R extends Object>, com.tangosol.util.InvocableMap.ParallelAwareAggregator<K extends Object,V extends Object,P extends Object,R extends Object>, com.tangosol.util.InvocableMap.StreamingAggregator<K extends Object,V extends Object,P extends Object,R extends Object>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Nested classes/interfaces inherited from interface com.tangosol.net.NamedMap

com.tangosol.net.NamedMap.Option

Nested classes/interfaces inherited from interface com.tangosol.util.QueryMap

com.tangosol.util.QueryMap.Entry<K extends Object,V extends Object>

Field Summary

Fields

Modifier and Type	Field	Description
protected AsyncNamedCacheClient<K,V>	f_asyncClient	The asynchronous client.

Fields inherited from interface com.tangosol.net.cache.CacheMap

EXPIRY_DEFAULT, EXPIRY_NEVER

Fields inherited from interface com.tangosol.util.ConcurrentMap

LOCK_ALL

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	NamedCacheClient(AsyncNamedCacheClient<K,V> asyncClient)	Creates a NamedCacheClient with the specified cache name and NamedCacheGrpcClient.

Method Summary

Modifier and Type	Method	Description
<T,E> void	addIndex(com.tangosol.util.ValueExtractor<? super T,? extends E> valueExtractor, boolean sorted, Comparator<? super E> comparator)
void	addMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener)
void	addMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener, com.tangosol.util.Filter filter, boolean lite)
void	addMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener, K key, boolean lite)
<R> R	aggregate(com.tangosol.util.Filter filter, com.tangosol.util.InvocableMap.EntryAggregator<? super K,? super V,R> aggregator)
<R> R	aggregate(com.tangosol.util.InvocableMap.EntryAggregator<? super K,? super V,R> aggregator)
<R> R	aggregate(Collection<? extends K> keys, com.tangosol.util.InvocableMap.EntryAggregator<? super K,? super V,R> aggregator)
com.tangosol.net.AsyncNamedCache<K,V>	async()
com.tangosol.net.AsyncNamedCache<K,V>	async(com.tangosol.net.AsyncNamedMap.Option... options)
void	clear()
boolean	containsKey(Object key)
boolean	containsValue(Object value)
void	destroy()
Set<Map.Entry<K,V>>	entrySet()
Set<Map.Entry<K,V>>	entrySet(com.tangosol.util.Filter filter)
Set<Map.Entry<K,V>>	entrySet(com.tangosol.util.Filter filter, Comparator comparator)
V	get(Object key)
Map<K,V>	getAll(Collection<? extends K> keys)
AsyncNamedCacheClient<K,V>	getAsyncClient()	Return an asynchronous version of the client.
String	getCacheName()
com.tangosol.net.CacheService	getCacheService()
V	getOrDefault(Object key, V defaultValue)
protected <T> T	handleCompletableFuture(CompletableFuture<T> future)
protected <T> T	handleCompletableFuture(CompletableFuture<T> future, long cTimeoutMillis)
<R> R	invoke(K k, com.tangosol.util.InvocableMap.EntryProcessor<K,V,R> entryProcessor)
<R> Map<K,R>	invokeAll(com.tangosol.util.Filter filter, com.tangosol.util.InvocableMap.EntryProcessor<K,V,R> entryProcessor)
<R> Map<K,R>	invokeAll(Collection<? extends K> keys, com.tangosol.util.InvocableMap.EntryProcessor<K,V,R> entryProcessor)
boolean	isActive()
boolean	isDestroyed()
boolean	isEmpty()
boolean	isReady()
boolean	isReleased()
Set<K>	keySet()
Set<K>	keySet(com.tangosol.util.Filter filter)
boolean	lock(Object o)
boolean	lock(Object o, long l)
V	put(K key, V value)
V	put(K key, V value, long ttl)
void	putAll(Map<? extends K,? extends V> m)
V	putIfAbsent(K key, V value)
void	release()
V	remove(Object key)
boolean	remove(Object key, Object value)
<T,E> void	removeIndex(com.tangosol.util.ValueExtractor<? super T,? extends E> valueExtractor)
void	removeMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener)
void	removeMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener, com.tangosol.util.Filter filter)
void	removeMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener, K key)
boolean	replace(K key, V oldValue, V newValue)
int	size()
String	toString()
void	truncate()
boolean	unlock(Object o)
Collection<V>	values()
Collection<V>	values(com.tangosol.util.Filter filter)
Collection<V>	values(com.tangosol.util.Filter filter, Comparator comparator)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.tangosol.util.InvocableMap

compute, compute, computeIfAbsent, computeIfAbsent, computeIfPresent, computeIfPresent, invokeAll, merge, merge, replace, replaceAll, replaceAll, replaceAll, replaceAll, stream, stream, stream, stream, stream, stream

Methods inherited from interface java.util.Map

equals, hashCode

Methods inherited from interface com.tangosol.net.NamedCache

as, forEach, view

Methods inherited from interface com.tangosol.net.NamedMap

getName, getService

Methods inherited from interface com.tangosol.util.QueryMap

addIndex, forEach, forEach

Methods inherited from interface com.tangosol.net.Releasable

close

Field Detail

f_asyncClient

protected final AsyncNamedCacheClient<K,V> f_asyncClient

The asynchronous client.

Constructor Detail

NamedCacheClient

protected NamedCacheClient(AsyncNamedCacheClient<K,V> asyncClient)

Creates a NamedCacheClient with the specified cache name and NamedCacheGrpcClient.

Parameters:

asyncClient - the asynchronous client

Method Detail

getAsyncClient

public AsyncNamedCacheClient<K,V> getAsyncClient()

Return an asynchronous version of the client.

Returns:

an asynchronous version of the client

toString

public String toString()

Overrides:

toString in class Object

addIndex

public <T,E> void addIndex(com.tangosol.util.ValueExtractor<? super T,? extends E> valueExtractor,
                                 boolean sorted,
                                 Comparator<? super E> comparator)

Specified by:

addIndex in interface com.tangosol.util.QueryMap<K,V>

addMapListener

public void addMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener)

Specified by:

addMapListener in interface com.tangosol.util.ObservableMap<K,V>

addMapListener

public void addMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener,
                           K key,
                           boolean lite)

Specified by:

addMapListener in interface com.tangosol.util.ObservableMap<K,V>

addMapListener

public void addMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener,
                           com.tangosol.util.Filter filter,
                           boolean lite)

Specified by:

addMapListener in interface com.tangosol.util.ObservableMap<K,V>

aggregate

public <R> R aggregate(Collection<? extends K> keys,
                       com.tangosol.util.InvocableMap.EntryAggregator<? super K,? super V,R> aggregator)

Specified by:

aggregate in interface com.tangosol.util.InvocableMap<K,V>

aggregate

public <R> R aggregate(com.tangosol.util.Filter filter,
                       com.tangosol.util.InvocableMap.EntryAggregator<? super K,? super V,R> aggregator)

Specified by:

aggregate in interface com.tangosol.util.InvocableMap<K,V>

clear

public void clear()

Specified by:

clear in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

clear in interface Map<K,V>

Specified by:

clear in interface com.tangosol.net.NamedMap<K,V>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

containsKey in interface Map<K,V>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

containsValue in interface Map<K,V>

destroy

public void destroy()

Specified by:

destroy in interface com.tangosol.net.NamedCollection

entrySet

public Set<Map.Entry<K,V>> entrySet(com.tangosol.util.Filter filter)

Specified by:

entrySet in interface com.tangosol.util.QueryMap<K,V>

entrySet

public Set<Map.Entry<K,V>> entrySet(com.tangosol.util.Filter filter,
                                          Comparator comparator)

Specified by:

entrySet in interface com.tangosol.util.QueryMap<K,V>

entrySet

public Set<Map.Entry<K,V>> entrySet()

Specified by:

entrySet in interface Map<K,V>

get

public V get(Object key)

Specified by:

get in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

get in interface Map<K,V>

getAll

public Map<K,V> getAll(Collection<? extends K> keys)

Specified by:

getAll in interface com.tangosol.net.cache.CacheMap<K,V>

Specified by:

getAll in interface com.tangosol.net.NamedMap<K,V>

getCacheName

public String getCacheName()

Specified by:

getCacheName in interface com.tangosol.net.NamedCache<K,V>

getCacheService

public com.tangosol.net.CacheService getCacheService()

Specified by:

getCacheService in interface com.tangosol.net.NamedCache<K,V>

invoke

public <R> R invoke(K k,
                    com.tangosol.util.InvocableMap.EntryProcessor<K,V,R> entryProcessor)

Specified by:

invoke in interface com.tangosol.util.InvocableMap<K,V>

invokeAll

public <R> Map<K,R> invokeAll(Collection<? extends K> keys,
                                    com.tangosol.util.InvocableMap.EntryProcessor<K,V,R> entryProcessor)

Specified by:

invokeAll in interface com.tangosol.util.InvocableMap<K,V>

invokeAll

public <R> Map<K,R> invokeAll(com.tangosol.util.Filter filter,
                                    com.tangosol.util.InvocableMap.EntryProcessor<K,V,R> entryProcessor)

Specified by:

invokeAll in interface com.tangosol.util.InvocableMap<K,V>

isActive

public boolean isActive()

Specified by:

isActive in interface com.tangosol.net.NamedMap<K,V>

Specified by:

isActive in interface com.tangosol.net.Releasable

isReady

public boolean isReady()

Specified by:

isReady in interface com.tangosol.net.NamedMap<K,V>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

isEmpty in interface Map<K,V>

keySet

public Set<K> keySet(com.tangosol.util.Filter filter)

Specified by:

keySet in interface com.tangosol.util.QueryMap<K,V>

keySet

public Set<K> keySet()

Specified by:

keySet in interface Map<K,V>

lock

public boolean lock(Object o,
                    long l)

Specified by:

lock in interface com.tangosol.util.ConcurrentMap<K,V>

lock

public boolean lock(Object o)

Specified by:

lock in interface com.tangosol.util.ConcurrentMap<K,V>

put

public V put(K key,
             V value)

Specified by:

put in interface com.tangosol.net.cache.CacheMap<K,V>

Specified by:

put in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

put in interface Map<K,V>

put

public V put(K key,
             V value,
             long ttl)

Specified by:

put in interface com.tangosol.net.cache.CacheMap<K,V>

Specified by:

put in interface com.tangosol.net.NamedCache<K,V>

putAll

public void putAll(Map<? extends K,? extends V> m)

Specified by:

putAll in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

putAll in interface Map<K,V>

release

public void release()

Specified by:

release in interface com.tangosol.net.Releasable

remove

public V remove(Object key)

Specified by:

remove in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

remove in interface Map<K,V>

removeIndex

public <T,E> void removeIndex(com.tangosol.util.ValueExtractor<? super T,? extends E> valueExtractor)

Specified by:

removeIndex in interface com.tangosol.util.QueryMap<K,V>

removeMapListener

public void removeMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener)

Specified by:

removeMapListener in interface com.tangosol.util.ObservableMap<K,V>

removeMapListener

public void removeMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener,
                              K key)

Specified by:

removeMapListener in interface com.tangosol.util.ObservableMap<K,V>

removeMapListener

public void removeMapListener(com.tangosol.util.MapListener<? super K,? super V> mapListener,
                              com.tangosol.util.Filter filter)

Specified by:

removeMapListener in interface com.tangosol.util.ObservableMap<K,V>

size

public int size()

Specified by:

size in interface com.tangosol.util.ConcurrentMap<K,V>

Specified by:

size in interface Map<K,V>

unlock

public boolean unlock(Object o)

Specified by:

unlock in interface com.tangosol.util.ConcurrentMap<K,V>

values

public Collection<V> values()

Specified by:

values in interface Map<K,V>

aggregate

public <R> R aggregate(com.tangosol.util.InvocableMap.EntryAggregator<? super K,? super V,R> aggregator)

Specified by:

aggregate in interface com.tangosol.util.InvocableMap<K,V>

async

public com.tangosol.net.AsyncNamedCache<K,V> async()

Specified by:

async in interface com.tangosol.net.NamedCache<K,V>

async

public com.tangosol.net.AsyncNamedCache<K,V> async(com.tangosol.net.AsyncNamedMap.Option... options)

Specified by:

async in interface com.tangosol.net.NamedCache<K,V>

Specified by:

async in interface com.tangosol.net.NamedMap<K,V>

getOrDefault

public V getOrDefault(Object key,
                      V defaultValue)

Specified by:

getOrDefault in interface com.tangosol.util.InvocableMap<K,V>

Specified by:

getOrDefault in interface Map<K,V>

isDestroyed

public boolean isDestroyed()

Specified by:

isDestroyed in interface com.tangosol.net.NamedCollection

isReleased

public boolean isReleased()

Specified by:

isReleased in interface com.tangosol.net.Releasable

putIfAbsent

public V putIfAbsent(K key,
                     V value)

Specified by:

putIfAbsent in interface com.tangosol.util.InvocableMap<K,V>

Specified by:

putIfAbsent in interface Map<K,V>

remove

public boolean remove(Object key,
                      Object value)

Specified by:

remove in interface com.tangosol.util.InvocableMap<K,V>

Specified by:

remove in interface Map<K,V>

replace

public boolean replace(K key,
                       V oldValue,
                       V newValue)

Specified by:

replace in interface com.tangosol.util.InvocableMap<K,V>

Specified by:

replace in interface Map<K,V>

truncate

public void truncate()

Specified by:

truncate in interface com.tangosol.net.NamedMap<K,V>

values

public Collection<V> values(com.tangosol.util.Filter filter)

Specified by:

values in interface com.tangosol.util.QueryMap<K,V>

values

public Collection<V> values(com.tangosol.util.Filter filter,
                            Comparator comparator)

Specified by:

values in interface com.tangosol.util.QueryMap<K,V>

handleCompletableFuture

protected <T> T handleCompletableFuture(CompletableFuture<T> future)

handleCompletableFuture

protected <T> T handleCompletableFuture(CompletableFuture<T> future,
                                        long cTimeoutMillis)