net.sf.ehcache.store
Interface TerracottaStore

All Superinterfaces:

Store

All Known Subinterfaces:

NonstopStore, RejoinAwareNonstopStore

All Known Implementing Classes:

AbstractTransactionStore, ExceptionOnTimeoutStore, ExecutorServiceStore, JtaLocalTransactionStore, LocalReadsOnTimeoutStore, LocalTransactionStore, NonstopStoreImpl, NoOpOnTimeoutStore, TransactionalExecutorServiceStore, XATransactionStore

public interface TerracottaStore
extends Store

Use for internal purpose only. Teaser: Stores of Terracotta clustered caches implements this interface.

Author:

Abhishek Sanoujam

Field Summary

Fields inherited from interface net.sf.ehcache.store.Store

CLUSTER_COHERENT, NODE_COHERENT

Method Summary

Set	getLocalKeys() Returns set of keys from the cache which are present in the node locally.
CacheConfiguration.TransactionalMode	getTransactionalMode() Get the transactional mode of this store.
Element	unlockedGet(Object key) Gets the value associated with the key without acquiring any locks.
Element	unlockedGetQuiet(Object key) Same as unlockedGet(Object) but does not update statistics
Element	unsafeGet(Object key) Returns the local value associated with the key.
Element	unsafeGetQuiet(Object key) Same as unsafeGet(Object) but does not update last usage statistics

Methods inherited from interface net.sf.ehcache.store.Store

addStoreListener, bufferFull, containsKey, containsKeyInMemory, containsKeyOffHeap, containsKeyOnDisk, dispose, executeQuery, expireElements, flush, get, getAll, getAllQuiet, getInMemoryEvictionPolicy, getInMemorySize, getInMemorySizeInBytes, getInternalContext, getKeys, getMBean, getOffHeapSize, getOffHeapSizeInBytes, getOnDiskSize, getOnDiskSizeInBytes, getQuiet, getSearchAttribute, getSize, getStatus, getTerracottaClusteredSize, hasAbortedSizeOf, isCacheCoherent, isClusterCoherent, isNodeCoherent, isPinned, put, putAll, putIfAbsent, putWithWriter, recalculateSize, remove, removeAll, removeAll, removeElement, removeStoreListener, removeWithWriter, replace, replace, setAttributeExtractors, setInMemoryEvictionPolicy, setNodeCoherent, setPinned, unpinAll, waitUntilClusterCoherent

Method Detail

unsafeGet

Element unsafeGet(Object key)

Returns the local value associated with the key. Local value means that the object mapped to the key is present in the VM locally. In case its not, will return null. Note that even when returning null, the value may be present in the Terracotta server array.

This operation does not acquire any locks when doing the operation and may return stale values.

Parameters:

key - the key

Returns:

the element associated with key or null

unsafeGetQuiet

Element unsafeGetQuiet(Object key)

Same as unsafeGet(Object) but does not update last usage statistics

Parameters:

key - the key

Returns:

the element associated with key or null

unlockedGet

Element unlockedGet(Object key)

Gets the value associated with the key without acquiring any locks. This may return stale values as locks are not acquired.

Parameters:

key -

Returns:

the element associated with the key or null

unlockedGetQuiet

Element unlockedGetQuiet(Object key)

Same as unlockedGet(Object) but does not update statistics

Parameters:

key -

Returns:

the element associated with the key or null

getLocalKeys

Set getLocalKeys()

Returns set of keys from the cache which are present in the node locally.

Returns:

set of keys present locally in the node

getTransactionalMode

CacheConfiguration.TransactionalMode getTransactionalMode()

Get the transactional mode of this store. The returned value is the String value of CacheConfiguration.TransactionalMode.

Returns:

a String representation of this store's transactional mode.

See Also:

CacheConfiguration.TransactionalMode