Interface BaseMap<K,​V>

Type Parameters:
K - Key
V - Value
All Superinterfaces:
DistributedObject
All Known Subinterfaces:
IMap<K,​V>, TransactionalMap<K,​V>

public interface BaseMap<K,​V>
extends DistributedObject
Base interface for Hazelcast distributed maps.
See Also:
IMap, TransactionalMap
  • Method Summary

    Modifier and Type Method Description
    boolean containsKey​(Object key)
    Returns true if this map contains an entry for the specified key.
    void delete​(Object key)
    Removes the mapping for a key from this map if it is present.
    V get​(Object key)
    Returns the value for the specified key, or null if this map does not contain this key.
    boolean isEmpty()
    Returns true if this map contains no entries.
    Set<K> keySet()
    Returns a set clone of the keys contained in this map.
    Set<K> keySet​(Predicate<K,​V> predicate)
    Queries the map based on the specified predicate and returns the keys of matching entries.
    V put​(K key, V value)
    Associates the specified value with the specified key in this map.
    V put​(K key, V value, long ttl, TimeUnit timeunit)
    Associates the specified value with the specified key in this map with a given ttl (time to live) value.
    V putIfAbsent​(K key, V value)
    If the specified key is not already associated with a value, associate it with the given value.
    V remove​(Object key)
    Removes the mapping for a key from this map if it is present.
    boolean remove​(Object key, Object value)
    Removes the entry for a key only if currently mapped to a given value.
    V replace​(K key, V value)
    Replaces the entry for a key only if it is currently mapped to some value.
    boolean replace​(K key, V oldValue, V newValue)
    Replaces the entry for a key only if currently mapped to a given value.
    void set​(K key, V value)
    Associates the specified value with the specified key in this map.
    int size()
    Returns the number of entries in this map.
    Collection<V> values()
    Returns a collection clone of the values contained in this map.
    Collection<V> values​(Predicate<K,​V> predicate)
    Queries the map based on the specified predicate and returns the values of matching entries.

    Methods inherited from interface com.hazelcast.core.DistributedObject

    destroy, getDestroyContextForTenant, getName, getPartitionKey, getServiceName
  • Method Details

    • containsKey

      boolean containsKey​(Object key)
      Returns true if this map contains an entry for the specified key.
      Parameters:
      key - The specified key.
      Returns:
      true if this map contains an entry for the specified key.
    • get

      V get​(Object key)
      Returns the value for the specified key, or null if this map does not contain this key.
      Parameters:
      key - The specified key.
      Returns:
      The value for the specified key.
    • put

      V put​(K key, V value)
      Associates the specified value with the specified key in this map. If the map previously contained a mapping for the key, the old value is replaced by the specified value.
      Parameters:
      key - The specified key.
      value - The value to associate with the key.
      Returns:
      Previous value associated with key or null if there was no mapping for key.
    • put

      V put​(K key, V value, long ttl, TimeUnit timeunit)
      Associates the specified value with the specified key in this map with a given ttl (time to live) value. Entry will expire and get evicted after the ttl. If ttl is 0, then the entry lives forever.
      Parameters:
      key - The specified key.
      value - The value to associate with the key.
      ttl - maximum time for this entry to stay in the map 0 means infinite.
      timeunit - time unit for the ttl
      Returns:
      Previous value associated with key or null if there was no mapping for key.
    • set

      void set​(K key, V value)
      Associates the specified value with the specified key in this map. If the map previously contained a mapping for the key, the old value is replaced by the specified value.

      This method is preferred to put(Object, Object) if the old value is not needed.

      Parameters:
      key - The specified key.
      value - The value to associate with the key.
    • putIfAbsent

      V putIfAbsent​(K key, V value)
      If the specified key is not already associated with a value, associate it with the given value. This is equivalent to
         if (!map.containsKey(key))
             return map.put(key, value);
         else
             return map.get(key);
      except that the action is performed atomically.
      Parameters:
      key - The specified key.
      value - The value to associate with the key when there is no previous value.
      Returns:
      The previous value associated with key, or null if there was no mapping for key.
    • replace

      V replace​(K key, V value)
      Replaces the entry for a key only if it is currently mapped to some value. This is equivalent to
         if (map.containsKey(key)) {
             return map.put(key, value);
         } else return null;
      except that the action is performed atomically.
      Parameters:
      key - The specified key.
      value - The value to replace the previous value.
      Returns:
      The previous value associated with key, or null if there was no mapping for key.
    • replace

      boolean replace​(K key, V oldValue, V newValue)
      Replaces the entry for a key only if currently mapped to a given value. This is equivalent to
         if (map.containsKey(key) && map.get(key).equals(oldValue)) {
             map.put(key, newValue);
             return true;
         } else return false;
      except that the action is performed atomically.
      Parameters:
      key - The specified key.
      oldValue - Replace the key value if it is the old value.
      newValue - The new value to replace the old value.
      Returns:
      true if the value was replaced.
    • remove

      V remove​(Object key)
      Removes the mapping for a key from this map if it is present.

      The map will not contain a mapping for the specified key once the call returns.

      Parameters:
      key - Remove the mapping for this key.
      Returns:
      The previous value associated with key, or null if there was no mapping for key.
    • delete

      void delete​(Object key)
      Removes the mapping for a key from this map if it is present.

      The map will not contain a mapping for the specified key once the call returns.

      *

      This method is preferred to remove(Object) if the old value is not needed.

      Parameters:
      key - Remove the mapping for this key.
    • remove

      boolean remove​(Object key, Object value)
      Removes the entry for a key only if currently mapped to a given value. This is equivalent to
         if (map.containsKey(key) && map.get(key).equals(value)) {
             map.remove(key);
             return true;
         } else return false;
      except that the action is performed atomically.
      Parameters:
      key - The specified key.
      value - Remove the key if it has this value.
      Returns:
      true if the value was removed.
    • isEmpty

      boolean isEmpty()
      Returns true if this map contains no entries.
      Returns:
      true if this map contains no entries.
    • size

      int size()
      Returns the number of entries in this map.
      Returns:
      the number of entries in this map.
    • keySet

      Set<K> keySet()
      Returns a set clone of the keys contained in this map.
      Returns:
      a set clone of the keys contained in this map.
    • keySet

      Set<K> keySet​(Predicate<K,​V> predicate)
      Queries the map based on the specified predicate and returns the keys of matching entries.
      Parameters:
      predicate - specified query criteria.
      Returns:
      result key set of the query.
      Throws:
      NullPointerException - if the specified predicate is null.
    • values

      Collection<V> values()
      Returns a collection clone of the values contained in this map.
      Returns:
      a collection clone of the values contained in this map
    • values

      Collection<V> values​(Predicate<K,​V> predicate)
      Queries the map based on the specified predicate and returns the values of matching entries.
      Parameters:
      predicate - specified query criteria.
      Returns:
      result value collection of the query.
      Throws:
      NullPointerException - if the predicate is null