CKTIS / Java
ConcurrentHashMap — konkurentna mapa ključ–vrijednost
ConcurrentHashMap omogućuje većem broju dretvi sigurnu upotrebu zajedničke mape. Atomske operacije za pojedini ključ ipak ne pretvaraju niz poziva u transakciju.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
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 dretveno sigurna hash-mapa koja implementira ConcurrentMap. Ne koristi jednu zaključavajuću bravu koja upravlja svim pristupima. Ključevi i vrijednosti null nisu dopušteni.
ConcurrentHashMap.put umeće ili zamjenjuje vrijednost i vraća prethodnu vrijednost, odnosno null ako je nije bilo. ConcurrentHashMap.get vraća vrijednost ili null. Niz poziva get i put nije atomski: istodobna povećanja mogu dovesti do gubitka ažuriranja.
ConcurrentHashMap.merge atomski umeće zadanu vrijednost ako ključ ne postoji ili spaja staru i zadanu vrijednost; rezultat null uklanja unos. ConcurrentHashMap.computeIfAbsent atomski izračunava vrijednost koja nedostaje; rezultat null ne pohranjuje se. Funkcije trebaju biti kratke i ne smiju mijenjati ovu mapu jer izračuni mogu blokirati ažuriranja.
ConcurrentHashMap.forEach izvršava radnju za unose bez jamstva redoslijeda. Tijekom istodobnih promjena prolazak je slabo konzistentan, a ne atomska snimka cijele mape. Sigurnost mape ne čini promjenjive objekte pohranjene kao vrijednosti sigurnima za dretve.
Primjeri
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);
}
}Rezultat
2
{java=2, sql=0}Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.