Package com.oracle.coherence.client

Class RemoteCollection<K,V,T>

java.lang.Object

com.oracle.coherence.client.RemoteCollection<K,V,T>

All Implemented Interfaces:

Iterable<T>, Collection<T>

Direct Known Subclasses:

RemoteEntrySet, RemoteKeySet, RemoteValues

public abstract class RemoteCollection<K,V,T>
extends Object
implements Collection<T>

A base class for implementations of collections related to a remote AsyncNamedCacheClient, for example key set, entry set and values.

This Collection implementation allows removal but does not allow additions to the collection. Methods add(Object) addAll(Collection) will throw an UnsupportedOperationException.

Some methods in this class are intentionally inefficient partly due to their being a more efficient means to perform the same task using the underlying AsyncNamedCacheClient and partly to ensure that using this class on a client will not cause all of the data from the underlying AsyncNamedCacheClient to be pulled back to the caller in one result.

Since:

20.06

Author:

Jonathan Knight 2019.11.12

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	RemoteCollection.EntryAdvancer<K,V>	A PagedIterator.Advancer to support a PagedIterator over an entry set.
protected static class	RemoteCollection.EntryResultMapEntry	A Map.Entry implementation that wraps a EntryResult.

Field Summary

Fields

Modifier and Type	Field	Description
protected AsyncNamedCacheClient<K,V>	f_client	The wrapped AsyncNamedCacheClient.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RemoteCollection(AsyncNamedCacheClient<K,V> client)

Method Summary

Modifier and Type	Method	Description
boolean	add(T t)
boolean	addAll(Collection<? extends T> c)
void	clear()
boolean	containsAll(Collection<?> colKeys)
protected RemoteCollection.EntryAdvancer<K,V>	createEntryAdvancer()	Create an RemoteCollection.EntryAdvancer to use in a PagedIterator.
boolean	equals(Object other)
protected AsyncNamedCacheClient<K,V>	getCache()	Obtain the underlying NamedCache.
int	hashCode()
boolean	isEmpty()
boolean	removeAll(Collection<?> colKeys)
boolean	retainAll(Collection<?> colKeys)
int	size()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

contains, iterator, parallelStream, remove, removeIf, spliterator, stream, toArray, toArray, toArray

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

f_client

protected final AsyncNamedCacheClient<K,V> f_client

The wrapped AsyncNamedCacheClient.

Constructor Detail

RemoteCollection

protected RemoteCollection(AsyncNamedCacheClient<K,V> client)

Method Detail

size

public int size()

Specified by:

size in interface Collection<K>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<K>

add

public boolean add(T t)

Specified by:

add in interface Collection<K>

addAll

public boolean addAll(Collection<? extends T> c)

Specified by:

addAll in interface Collection<K>

clear

public void clear()

Specified by:

clear in interface Collection<K>

containsAll

public boolean containsAll(Collection<?> colKeys)

Specified by:

containsAll in interface Collection<K>

removeAll

public boolean removeAll(Collection<?> colKeys)

Specified by:

removeAll in interface Collection<K>

retainAll

public boolean retainAll(Collection<?> colKeys)

Specified by:

retainAll in interface Collection<K>

equals

public boolean equals(Object other)

Specified by:

equals in interface Collection<K>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<K>

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

getCache

protected AsyncNamedCacheClient<K,V> getCache()

Obtain the underlying NamedCache.

Returns:

the underlying NamedCache

createEntryAdvancer

protected RemoteCollection.EntryAdvancer<K,V> createEntryAdvancer()

Create an RemoteCollection.EntryAdvancer to use in a PagedIterator.

Returns:

an RemoteCollection.EntryAdvancer to use in a PagedIterator