CKTIS / Java
java.util.Map — Schlüssel Werten zuordnen
Map<K,V> ordnet jedem Schlüssel höchstens einen Wert zu. Lerne das Abrufen, Aktualisieren und Berechnen von Werten sowie Map-Ansichten kennen, insbesondere den Umgang mit null und die Garantien der Implementierung.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Map<K, V> map = new HashMap<>();java.util.Map<K,V> ist eine Schnittstelle, die Schlüssel Werten zuordnet; Werte können mehrfach vorkommen. HashMap garantiert keine Reihenfolge, während TreeMap die Schlüssel sortiert. Die Unterstützung für null hängt von der Implementierung ab. Ändere einen gespeicherten Schlüssel nicht so, dass seine Vergleichsweise beeinflusst wird.
Map.put(k, v) fügt einen Wert hinzu oder ersetzt ihn und gibt den vorherigen zurück; Map.remove(k) löscht einen Eintrag und gibt dessen alten Wert zurück. Bei einem nicht vorhandenen Eintrag geben beide ebenfalls null zurück. Map.get(k) gibt den Wert oder null zurück; Map.containsKey(k) unterscheidet zwischen einem fehlenden Eintrag und einem Eintrag mit dem Wert null. Map.getOrDefault(k, d) gibt d nur zurück, wenn kein Eintrag vorhanden ist, nicht wenn ein Eintrag den Wert null hat. Map.size() zählt die Einträge; Map.containsValue(v) prüft, ob ein Wert vorkommt.
Map.compute(k, f) übergibt der Funktion den Schlüssel und den aktuellen Wert oder null; ein Ergebnis von null entfernt den Eintrag oder lässt ihn nicht vorhanden. Map.computeIfAbsent(k, f) ruft die Funktion auf, wenn ein Eintrag fehlt oder sein Wert null ist; gespeichert wird nur ein Ergebnis, das nicht null ist. Map.merge(k, v, f) erfordert v != null: Bei einem fehlenden Eintrag oder einem Wert null wird v gespeichert, andernfalls wird der alte Wert mit v kombiniert; ein Ergebnis von null entfernt den Eintrag.
Map.keySet() stellt eine Menge von Schlüsseln bereit, Map.values() eine Sammlung von Werten und Map.entrySet() eine Menge von Map.Entry<K,V>-Paaren. Dies sind Ansichten, die von der Map unterstützt werden, keine Kopien; das Entfernen über eine Ansicht entfernt den Eintrag, sofern dies unterstützt wird. Map.forEach(action) durchläuft jedes Paar.
Ändernde Operationen können UnsupportedOperationException auslösen. Berechnungsfunktionen sollten dieselbe Map nicht verändern. Die Standardmethoden von Map garantieren weder Atomarität noch Synchronisierung. Das Beispiel verwendet TreeMap, damit die Ausgabereihenfolge deterministisch ist.
Beispiele
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());
}
}Ergebnis
3 0 false true 2 [apple, pear] [2, 3] [apple=2, pear=3] apple:2 pear:3 3 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.