com.hazelcast.core

Interface MapStore<K,V>

All Superinterfaces:

MapLoader<K,V>

All Known Implementing Classes:

MapStoreAdapter, MapStoreWrapper

public interface MapStore<K,V>
extends MapLoader<K,V>

Hazelcast distributed map implementation is an in-memory data store, but it can be backed by any type of data store such as RDBMS, OODBMS, NOSQL, or simply a file-based data store.

IMap.put(key, value) normally stores the entry into JVM's memory. If MapStore implementation is provided then Hazelcast will also call the MapStore implementation to store the entry into a user-defined storage, such as RDBMS or some other external storage system. It is completely up to the user how the key-value will be stored or deleted.

Same goes for IMap.remove(key).

Store implementation can be called synchronously (write-through) or asynchronously (write-behind) depending on the configuration.

Note that in write-behind mode, there is a possibility that a map-store implementation can be used by multiple threads at the same time, calling methods like IMap.flush() or IMap.evict(Object) may trigger this behavior.

Method Summary

Methods

Modifier and Type	Method and Description
void	delete(K key) Deletes the entry with a given key from the store.
void	deleteAll(Collection<K> keys) Deletes multiple entries from the store.
void	store(K key, V value) Stores the key-value pair.
void	storeAll(Map<K,V> map) Stores multiple entries.

Methods inherited from interface com.hazelcast.core.MapLoader

load, loadAll, loadAllKeys

Method Detail

store

void store(K key,
         V value)

Stores the key-value pair. If an exception is thrown then the put operation will fail.

Parameters:

key - key of the entry to store

value - value of the entry to store

storeAll

void storeAll(Map<K,V> map)

Stores multiple entries. Implementation of this method can optimize the store operation by storing all entries in one database connection. storeAll is used when writeDelaySeconds is positive (write-behind). If an exception is thrown, the entries will try to be stored one by one using the store() method.

Parameters:

map - map of entries to store

delete

void delete(K key)

Deletes the entry with a given key from the store. If an exception is thrown the remove operation will fail.

Parameters:

key - the key to delete from the store.

deleteAll

void deleteAll(Collection<K> keys)

Deletes multiple entries from the store. If an exception is thrown the entries will try to be deleted one by one using the delete() method.

Parameters:

keys - the keys of the entries to delete.