com.tangosol.net.cache
Class CacheStoreMap

java.lang.Object
  com.tangosol.util.Base
      com.tangosol.util.ConverterCollections.ConverterMap
          com.tangosol.net.cache.CacheStoreMap

All Implemented Interfaces:

QueryMap, Serializable, Map

public class CacheStoreMap
extends ConverterCollections.ConverterMap

A backing Map implementation that delegates all operations to a CacheStore.

Note: The clear() method is explicitly not implemented. Items can be removed individually, but the suggested usage is to indicate item deletion by state change, such as by setting a persistent "item-deleted" flag. There are two reasons for this:

1. The CacheHandler for the backing Map may use the clear() method as part of setup and tear-down.
2. Deletions are not replicatable to new members, since there is no record of the deletions having occurred. To be certain that new members are aware of items having been deleted, the "evidence" of the deletion must be recorded (i.e. as part of the "deleted" item's state).

Since:

Coherence 3.2

Author:

cp 2006.09.06

Nested Class Summary

static class

CacheStoreMap.ReadWriteMap A Map implementation that delegates straight through to a CacheStore.

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

QueryMap.Entry

Field Summary

Fields inherited from class com.tangosol.util.ConverterCollections.ConverterMap

m_convKeyDown, m_convKeyUp, m_convValDown, m_convValUp, m_map, m_set

Constructor Summary

CacheStoreMap(BackingMapManagerContext ctx, CacheStore store)
Construct a read/write CacheStoreMap.

CacheStoreMap(BackingMapManagerContext ctx, CacheStore store, boolean fBlind)
Construct a read/write CacheStoreMap.

CacheStoreMap(BackingMapManagerContext ctx, IterableCacheLoader loader)
Construct a read-only CacheStoreMap.

Method Summary

Methods inherited from class com.tangosol.util.ConverterCollections.ConverterMap

addIndex, clear, containsKey, containsValue, entrySet, entrySet, entrySet, get, instantiateCollection, instantiateEntrySet, instantiateMap, instantiateSet, isEmpty, keySet, keySet, put, putAll, remove, removeIndex, size, toString, values

Constructor Detail

CacheStoreMap

public CacheStoreMap(BackingMapManagerContext ctx,
                     IterableCacheLoader loader)

Construct a read-only CacheStoreMap.

Parameters:

ctx - the context provided by the CacheService which is using this backing map

loader - the CacheLoader to delegate read operations to

CacheStoreMap

public CacheStoreMap(BackingMapManagerContext ctx,
                     CacheStore store)

Construct a read/write CacheStoreMap.

Parameters:

ctx - the context provided by the CacheService which is using this backing map

store - the CacheStore to delegate read and write operations to

CacheStoreMap

public CacheStoreMap(BackingMapManagerContext ctx,
                     CacheStore store,
                     boolean fBlind)

Construct a read/write CacheStoreMap.

Parameters:

ctx - the context provided by the CacheService which is using this backing map

store - the CacheStore to delegate read and write operations to

fBlind - pass true to optimize put() and remove() by allowing them to skip the loading of old values