com.hazelcast.internal.nearcache

Interface NearCache<K,V>

Type Parameters:

K - the type of the key

V - the type of the value

All Superinterfaces:

InitializingObject

All Known Implementing Classes:

DefaultNearCache, InvalidationAwareWrapper

public interface NearCache<K,V>
extends InitializingObject

NearCache is the contract point to store keys and values in underlying NearCacheRecordStore.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_EXPIRATION_TASK_DELAY_IN_SECONDS Default expiration task delay time as seconds
static int	DEFAULT_EXPIRATION_TASK_INITIAL_DELAY_IN_SECONDS Default expiration task initial delay time as seconds
static Object	NULL_OBJECT NULL Object

Method Summary

Modifier and Type	Method and Description
void	clear() Removes all stored values.
void	destroy() Clears the record store and destroys it.
V	get(K key) Gets the value associated with the given key.
InMemoryFormat	getInMemoryFormat() Gets the InMemoryFormat of the storage for internal records.
String	getName() Gets the name of this NearCache instance.
NearCacheStats	getNearCacheStats() Get the NearCacheStats instance to monitor this store.
NearCachePreloaderConfig	getPreloaderConfig() Gets the NearCachePreloaderConfig of this Near Cache.
boolean	isInvalidatedOnChange() Checks if values are invalidated on changes.
boolean	isPreloadDone() Checks if the pre-loading of the Near Cache is done.
void	preload(DataStructureAdapter<Data,?> adapter) Executes the Near Cache pre-loader on the given DataStructureAdapter.
void	put(K key, V value) Puts (associates) a value with the given key.
boolean	remove(K key) Removes the value associated with the given key.
Object	selectToSave(Object... candidates) Selects the best candidate object to store from the given candidates.
int	size() Gets the count of stored records.
void	storeKeys() Stores the keys of the Near Cache.
<T> T	unwrap(Class<T> clazz) Used to access non-standard methods of an implementation.

Methods inherited from interface com.hazelcast.spi.InitializingObject

initialize

Field Detail

DEFAULT_EXPIRATION_TASK_INITIAL_DELAY_IN_SECONDS

static final int DEFAULT_EXPIRATION_TASK_INITIAL_DELAY_IN_SECONDS

Default expiration task initial delay time as seconds

See Also:

Constant Field Values

DEFAULT_EXPIRATION_TASK_DELAY_IN_SECONDS

static final int DEFAULT_EXPIRATION_TASK_DELAY_IN_SECONDS

Default expiration task delay time as seconds

See Also:

Constant Field Values

NULL_OBJECT

static final Object NULL_OBJECT

NULL Object

Method Detail

getName

String getName()

Gets the name of this NearCache instance.

Returns:

the name of this NearCache instance

get

V get(K key)

Gets the value associated with the given key.

Parameters:

key - the key of the requested value

Returns:

the value associated with the given key

put

void put(K key,
         V value)

Puts (associates) a value with the given key.

Parameters:

key - the key of the value will be stored

value - the value will be stored

remove

boolean remove(K key)

Removes the value associated with the given key.

Parameters:

key - the key of the value will be removed

isInvalidatedOnChange

boolean isInvalidatedOnChange()

Checks if values are invalidated on changes.

Returns:

true if values are invalidated on changes, false otherwise

clear

void clear()

Removes all stored values.

destroy

void destroy()

Clears the record store and destroys it.

getInMemoryFormat

InMemoryFormat getInMemoryFormat()

Gets the InMemoryFormat of the storage for internal records.

Returns:

the InMemoryFormat of the storage for internal records

getPreloaderConfig

NearCachePreloaderConfig getPreloaderConfig()

Gets the NearCachePreloaderConfig of this Near Cache.

Returns:

the NearCachePreloaderConfig of this Near Cache

getNearCacheStats

NearCacheStats getNearCacheStats()

Get the NearCacheStats instance to monitor this store.

Returns:

the NearCacheStats instance to monitor this store

selectToSave

Object selectToSave(Object... candidates)

Selects the best candidate object to store from the given candidates.

Parameters:

candidates - the candidates from which the best candidate object will be selected.

Returns:

the best candidate object to store, selected from the given candidates.

size

int size()

Gets the count of stored records.

Returns:

the count of stored records

preload

void preload(DataStructureAdapter<Data,?> adapter)

Executes the Near Cache pre-loader on the given DataStructureAdapter.

storeKeys

void storeKeys()

Stores the keys of the Near Cache.

isPreloadDone

boolean isPreloadDone()

Checks if the pre-loading of the Near Cache is done.

Returns:

true if the pre-loading is done, false otherwise.

unwrap

<T> T unwrap(Class<T> clazz)

Used to access non-standard methods of an implementation.

If this method is called on a wrapper object, result is wrapped object.

Type Parameters:

T - the type of the class modeled by this Class object

Parameters:

clazz - the type of returning object.

Returns:

an instance of the supplied clazz type.

Throws:

IllegalArgumentException - if no implementation found for the supplied clazz type.