Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

ConcurrentHashMap — souběžná mapa klíč–hodnota

ConcurrentHashMap umožňuje více vláknům bezpečně používat sdílenou mapu. Atomické operace pro jeden klíč však nemění posloupnost volání v transakci.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

ConcurrentHashMap<K, V> map = new ConcurrentHashMap<>();
map.put(key, value);
map.get(key);
map.merge(key, value, remappingFunction);
map.computeIfAbsent(key, mappingFunction);
map.forEach((k, v) -> { /* action */ });

java.util.concurrent.ConcurrentHashMap je vláknově bezpečná hashovací mapa implementující ConcurrentMap. Nepoužívá jediný zámek, který by řídil veškerý přístup. Nepovoluje klíče ani hodnoty null.

ConcurrentHashMap.put vloží nebo nahradí hodnotu a vrátí předchozí hodnotu, případně null, pokud žádná nebyla. ConcurrentHashMap.get vrátí hodnotu nebo null. Posloupnost volání get a put není atomická: souběžná inkrementace mohou vést ke ztrátě aktualizací.

ConcurrentHashMap.merge atomicky vloží zadanou hodnotu, pokud klíč chybí, nebo zkombinuje starou a zadanou hodnotu; výsledek null položku odstraní. ConcurrentHashMap.computeIfAbsent atomicky vypočítá chybějící hodnotu; výsledek null se neuloží. Funkce by měly být krátké a nesmějí tuto mapu měnit, protože výpočty mohou blokovat aktualizace.

ConcurrentHashMap.forEach provede akci pro položky bez záruky pořadí. Při souběžných změnách je průchod slabě konzistentní, nejde o atomický snímek celé mapy. Bezpečnost mapy nezajišťuje bezpečnost vláken pro měnitelné objekty uložené jako hodnoty.

Příklady

import java.util.TreeMap;
import java.util.concurrent.ConcurrentHashMap;

public class Main {
    public static void main(String[] args) {
        ConcurrentHashMap<String, Integer> counts = new ConcurrentHashMap<>();
        counts.put("java", 1);
        counts.merge("java", 1, Integer::sum);
        counts.computeIfAbsent("sql", key -> 0);
        System.out.println(counts.get("java"));

        TreeMap<String, Integer> sorted = new TreeMap<>();
        counts.forEach((key, value) -> sorted.put(key, value));
        System.out.println(sorted);
    }
}

Výsledek

2
{java=2, sql=0}

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje