java.util.concurrent

Interface ConcurrentMap<K,V>

Inhoudsopgave
  • Type Parameters:
    K - the type of keys maintained by this map
    V - the type of mapped values
    All Superinterfaces:
    Map<K,V>
    All Known Subinterfaces:
    ConcurrentNavigableMap<K,V>
    All Known Implementing Classes:
    ConcurrentHashMap, ConcurrentSkipListMap

    public interface ConcurrentMap<K,V>
extends Map<K,V>
    A Map providing additional atomic putIfAbsent, remove, and replace methods.

    Memory consistency effects: As with other concurrent collections, actions in a thread prior to placing an object into a ConcurrentMap as a key or value happen-before actions subsequent to the access or removal of that object from the ConcurrentMap in another thread.

    This interface is a member of the Java Collections Framework.

    Since:
    1.5

    • Method Detail

      • 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 - key with which the specified value is to be associated
        value - value to be associated with the specified key
        Returns:
        the previous value associated with the specified key, or null if there was no mapping for the key. (A null return can also indicate that the map previously associated null with the key, if the implementation supports null values.)
        Throws:
        UnsupportedOperationException - if the put operation is not supported by this map
        ClassCastException - if the class of the specified key or value prevents it from being stored in this map
        NullPointerException - if the specified key or value is null, and this map does not permit null keys or values
        IllegalArgumentException - if some property of the specified key or value prevents it from being stored in this map

      • 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 - key with which the specified value is associated
        value - value expected to be associated with the specified key
        Returns:
        true if the value was removed
        Throws:
        UnsupportedOperationException - if the remove operation is not supported by this map
        ClassCastException - if the key or value is of an inappropriate type for this map (optional)
        NullPointerException - if the specified key or value is null, and this map does not permit null keys or values (optional)

      • 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 - key with which the specified value is associated
        oldValue - value expected to be associated with the specified key
        newValue - value to be associated with the specified key
        Returns:
        true if the value was replaced
        Throws:
        UnsupportedOperationException - if the put operation is not supported by this map
        ClassCastException - if the class of a specified key or value prevents it from being stored in this map
        NullPointerException - if a specified key or value is null, and this map does not permit null keys or values
        IllegalArgumentException - if some property of a specified key or value prevents it from being stored in this map

      • replace

        V replace(K key,
        V value)
        Replaces the entry for a key only if 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 - key with which the specified value is associated
        value - value to be associated with the specified key
        Returns:
        the previous value associated with the specified key, or null if there was no mapping for the key. (A null return can also indicate that the map previously associated null with the key, if the implementation supports null values.)
        Throws:
        UnsupportedOperationException - if the put operation is not supported by this map
        ClassCastException - if the class of the specified key or value prevents it from being stored in this map
        NullPointerException - if the specified key or value is null, and this map does not permit null keys or values
        IllegalArgumentException - if some property of the specified key or value prevents it from being stored in this map

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/util/concurrent/ConcurrentMap.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Inhoudsopgave Haut