CKTIS / Java
ConcurrentHashMap — súbežná mapa kľúč–hodnota
ConcurrentHashMap umožňuje viacerým vláknam bezpečne používať spoločnú mapu. Atómové operácie pre jeden kľúč však nemenia postupnosť volaní na transakciu.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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áknovo bezpečná hashovacia mapa, ktorá implementuje ConcurrentMap. Nepoužíva jediný zámok, ktorý by riadil všetky prístupy. Nepovoľuje kľúče ani hodnoty null.
ConcurrentHashMap.put vloží alebo nahradí hodnotu a vráti predchádzajúcu hodnotu, prípadne null, ak žiadna neexistovala. ConcurrentHashMap.get vráti hodnotu alebo null. Postupnosť volaní get a put nie je atómová: súbežné inkrementácie môžu viesť k strate aktualizácií.
ConcurrentHashMap.merge atómovo vloží zadanú hodnotu, ak kľúč chýba, alebo skombinuje starú a zadanú hodnotu; výsledok null položku odstráni. ConcurrentHashMap.computeIfAbsent atómovo vypočíta chýbajúcu hodnotu; výsledok null sa neuloží. Funkcie by mali byť krátke a nesmú túto mapu meniť, pretože výpočty môžu blokovať aktualizácie.
ConcurrentHashMap.forEach vykoná akciu pre položky bez záruky poradia. Počas súbežných zmien je priechod slabo konzistentný, nejde o atómový snímok celej mapy. Bezpečnosť mapy nezaručuje bezpečnosť vlákien pre meniteľné objekty uložené ako hodnoty.
Prí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ýsledok
2
{java=2, sql=0}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.