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.