AbstractKeyBasedCache Class

Oracle® Fusion Middleware .NET API Reference for Oracle Coherence
14c (14.1.1.0)
F23534-02

AbstractKeyBasedCache is a base class for ICache implementations.

Inheritance Hierarchy

SystemObject
Tangosol.Net.Cache.SupportAbstractKeyBasedCache
Tangosol.Net.Cache.SupportAbstractKeySetBasedCache

Namespace: Tangosol.Net.Cache.Support
Assembly: Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)

Syntax

Copy

public abstract class AbstractKeyBasedCache : ICache, 
	IDictionary, ICollection, IEnumerable

The AbstractKeyBasedCache type exposes the following members.

Constructors

	Name	Description
	AbstractKeyBasedCache	Initializes a new instance of the AbstractKeyBasedCache class

Top

Properties

	Name	Description
	Count	Returns the number of key-value mappings in this cache.
	Entries	Returns a collection of the mappings contained in this cache.
	IsFixedSize	Gets a value indicating whether the IDictionary object has a fixed size.
	IsReadOnly	Gets a value indicating whether the IDictionary object is read-only.
	IsSynchronized	Gets a value indicating whether access to the ICollection is synchronized (thread safe).
	Item	Returns the value to which this cache maps the specified key.
	Keys	Returns a collection view of the keys contained in this cache.
	SyncRoot	Gets an object that can be used to synchronize access to the ICollection.
	Values	Returns a collection of the values contained in this cache.

Top

Methods

	Name	Description
	Add	Adds an element with the provided key and value to the IDictionary object.
	Clear	Clear all key/value mappings.
	Contains	Returns true if this cache contains a mapping for the specified key.
	CopyTo	Copies the elements of the ICollection to an Array, starting at a particular index.
	Equals	Compares the specified object with this cache for equality. (Overrides ObjectEquals(Object).)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	Get	Returns the value for the specified key.
	GetAll	Get all the specified keys, if they are in the cache.
	GetEnumerator	Returns an ICacheEnumerator object for the ICache instance.
	GetHashCode	Returns the hash code value for this cache. (Overrides ObjectGetHashCode.)
	GetKeysEnumerator	Create an IEnumerator over the keys in this cache.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	Insert(Object, Object)	Associates the specified value with the specified key in this cache.
	Insert(Object, Object, Int64)	Associates the specified value with the specified key in this cache.
	InsertAll	Copies all of the mappings from the specified IDictionary to this cache.
	InstantiateEntriesCollection	Factory pattern: Create a collection that represents the entries in the cache.
	InstantiateKeysCollection	Factory pattern: Create a collection that represents the keys in the cache.
	InstantiateValuesCollection	Factory pattern: Instantiate the values collection.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Remove	Removes the mapping for this key from this cache if present.
	RemoveBlind	Removes the mapping for this key from this cache if present.
	ToString	Returns a string representation of this cache. (Overrides ObjectToString.)

Top

Remarks

AbstractKeyBasedCache requires a read-only sub-type to implement only Get(Object) and GetKeysEnumerator methods, and a read-write sub-type to additionally implement only Insert(Object, Object, Int64) and Remove(Object).

A number of the methods have implementations provided, but are extremely inefficient for caches that contain large amounts of data, including Clear, Contains(Object) and Count. Furthermore, if any of a number of method implementations has any cost of returning an "old value", then the InsertAll(IDictionary) and RemoveBlind(Object) methods should also be implemented.

Reference

Tangosol.Net.Cache.Support Namespace