CKTIS / Java
java.util.Map — associare chiavi e valori
Map<K,V> associa ogni chiave al massimo a un valore. Scopri come cercare e aggiornare i dati, calcolare valori e usare le viste della mappa, prestando particolare attenzione alla gestione di null e alle garanzie dell’implementazione.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
Map<K, V> map = new HashMap<>();java.util.Map<K,V> è un’interfaccia che associa chiavi a valori; i valori possono ripetersi. HashMap non garantisce alcun ordine, mentre TreeMap ordina le chiavi. Il supporto per null dipende dall’implementazione. Non modificare una chiave memorizzata in modo da influenzarne il confronto.
Map.put(k, v) aggiunge o sostituisce un valore e restituisce quello precedente; Map.remove(k) elimina una voce e restituisce il suo vecchio valore. Entrambi restituiscono anche null se la voce è assente. Map.get(k) restituisce il valore oppure null; Map.containsKey(k) distingue l’assenza da una voce associata a null. Map.getOrDefault(k, d) restituisce d solo se la voce è assente, non se il valore associato è null. Map.size() conta le voci; Map.containsValue(v) verifica se un valore è presente.
Map.compute(k, f) passa alla funzione la chiave e il valore corrente, oppure null; un risultato null elimina la voce o la lascia assente. Map.computeIfAbsent(k, f) chiama la funzione se la voce è assente o il suo valore è null; memorizza solo un risultato non nullo. Map.merge(k, v, f) richiede v != null: se la voce è assente o il suo valore è null, memorizza v; altrimenti combina il vecchio valore con v. Un risultato null elimina la voce.
Map.keySet() espone un insieme di chiavi, Map.values() una raccolta di valori e Map.entrySet() un insieme di coppie Map.Entry<K,V>. Sono viste collegate alla mappa, non copie; se supportata, la rimozione tramite una vista elimina la voce. Map.forEach(action) visita ogni coppia.
Le operazioni che modificano la mappa possono generare UnsupportedOperationException. Le funzioni di calcolo non dovrebbero modificare la stessa mappa. I metodi predefiniti di Map non garantiscono né atomicità né sincronizzazione. L’esempio usa TreeMap per ottenere un ordine di output deterministico.
Esempi
import java.util.Map;
import java.util.TreeMap;
public class Main {
public static void main(String[] args) {
Map<String, Integer> counts = new TreeMap<>();
counts.put("pear", 1);
counts.merge("pear", 2, Integer::sum);
counts.computeIfAbsent("apple", key -> 1);
counts.compute("apple", (key, value) -> value + 1);
System.out.println(counts.get("pear"));
System.out.println(counts.getOrDefault("plum", 0));
System.out.println(counts.containsKey("plum"));
System.out.println(counts.containsValue(2));
System.out.println(counts.size());
System.out.println(counts.keySet());
System.out.println(counts.values());
System.out.println(counts.entrySet());
counts.forEach((key, value) -> System.out.println(key + ":" + value));
System.out.println(counts.remove("pear"));
System.out.println(counts.size());
}
}Risultato
3 0 false true 2 [apple, pear] [2, 3] [apple=2, pear=3] apple:2 pear:3 3 1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.