CKTIS / Java
Map.get – einen Wert über seinen Schlüssel abrufen
Mit `map.get(key)` rufst du einen gespeicherten Wert ab. Erlaubt die Map `null`-Werte, lässt sich am Ergebnis allein nicht erkennen, ob der Schlüssel fehlt oder auf `null` abgebildet ist.
Version: Java SE 21
Syntax
V get(Object key); // instance method declared by java.util.Map<K, V>
map.get(key) // call with one key argumentIn Java SE 21 ist Map.get eine Instanzmethode von java.util.Map<K, V> mit der Deklaration V get(Object key). Map.get() ist eine Kurzschreibweise, keine Überladung ohne Argumente: Rufe map.get(key) auf. Die Methode liefert den gespeicherten Wert oder null, wenn keine Zuordnung existiert. Der Vertrag von Map beschreibt einen Treffer mit Objects.equals(key, k), wobei k der gespeicherte Schlüssel ist. In einer HashMap kann eine andere, aber gleiche Schlüsselinstanz denselben Eintrag finden. Laut equals gleiche Schlüssel müssen denselben hashCode haben. Ändere keine für die Gleichheit relevanten Eigenschaften eines Schlüssels, solange er in der Map liegt.
Bei Map<Integer, Long> liest Long total = totals.get(7); einen zuvor berechneten Wert ohne Typumwandlung. Der Parametertyp ist Object, nicht K. Ein roher Map-Typ ohne Typargumente liefert Object. Für die Zuweisung an String oder Integer ist dann ein expliziter Cast nötig, etwa (String) raw.get(key) oder (Integer) raw.get(key). Bei einem inkompatiblen Wert ungleich null löst der Cast eine ClassCastException aus. Bevorzuge Maps mit Typargumenten.
Erlaubt die Map null-Werte, unterscheidet get einen fehlenden Schlüssel nicht von einer Zuordnung zu null. Prüfe die Existenz mit containsKey(key); bei nebenläufigen Änderungen bilden die beiden Aufrufe keine atomare Operation. getOrDefault(key, fallback) liefert fallback nur bei fehlender Zuordnung. Je nach Implementierung kann ein ungeeigneter Schlüsseltyp eine ClassCastException und ein unzulässiger null-Schlüssel eine NullPointerException auslösen. Rufe gespeicherte Werte true und false über ihre jeweiligen Schlüssel ab, statt dich auf die Iterationsreihenfolge zu verlassen. Beim Unboxing von null, etwa von Boolean zu boolean, tritt eine NullPointerException auf.
In einer LinkedHashMap mit Zugriffsreihenfolge (accessOrder = true im Konstruktor) verschiebt ein Treffer den Eintrag ans Ende der Iterationsreihenfolge, auch bei einem Wert von null. Ohne Treffer bleibt die Reihenfolge unverändert. Bei Einfügereihenfolge ändert get die Reihenfolge nicht.
Wenn mehrere Threads Ergebnisse schreiben, verwende beispielsweise eine ConcurrentHashMap, die weder null-Schlüssel noch null-Werte zulässt. Sobald der Hauptthread für jeden Arbeitsthread erfolgreich aus join() zurückgekehrt ist, sind deren Schreibvorgänge für ihn sichtbar. Rufe die Ergebnisse nach aufsteigendem Anfrageindex ab, um die Anfragereihenfolge statt der Abschlussreihenfolge zu erhalten. join() macht frühere gleichzeitige Schreibzugriffe auf eine gewöhnliche HashMap nicht sicher.
Beispiele
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Map;
public class MapGetDemo {
record Key(int id) {}
public static void main(String[] args) {
Map<Key, Long> totals = new HashMap<>();
totals.put(new Key(7), 6L * 7);
totals.put(new Key(8), null);
Long total = totals.get(new Key(7));
System.out.println("total: " + total);
for (int id : new int[] {8, 9}) {
Key key = new Key(id);
System.out.println(id + ": " + totals.get(key) + ", present: " + totals.containsKey(key));
}
Map<String, Boolean> flags = Map.of("a", true, "b", false);
System.out.println("flags: " + flags.get("a") + ", " + flags.get("b"));
Map<String, Integer> recent = new LinkedHashMap<>(16, 0.75f, true);
recent.put("a", 1);
recent.put("b", 2);
System.out.println("before: " + recent.keySet());
System.out.println("get a: " + recent.get("a"));
System.out.println("after: " + recent.keySet());
}
}Ergebnis
total: 42 8: null, present: true 9: null, present: false flags: true, false before: [a, b] get a: 1 after: [b, a]
Ein neuer `Key(7)` findet den gespeicherten Wert `42`. Für `8` und `9` liefert `get` jeweils `null`, doch nur `8` ist vorhanden. Die Flags werden ausdrücklich für `a` und dann für `b` abgefragt. In der letzten Map ändert der Zugriff auf `a` die Reihenfolge von `[a, b]` zu `[b, a]`.
Zugehörige Lektionen
- Java · Lektion 13 · Fortgeschritten · Version: 2
- Java · Lektion 17 · Fortgeschritten · Version: 2
- Java · Lektion 18 · Fortgeschritten · Version: 2
- Java · Lektion 36 · Fortgeschritten · Version: 2
- Java · Lektion 35 · Grundlagen · Version: 2
- Java · Lektion 42 · Grundlagen · Version: 2
- Java · Lektion 58 · Grundlagen · Version: 2
- Java · Lektion 40 · Mittlere Stufe · Version: 2
- Java · Lektion 43 · Mittlere Stufe · Version: 2
Quellen
- Map (Java SE 21 & JDK 21) — get(Object)
- Map (Java SE 21 & JDK 21) — getOrDefault(Object, V)
- HashMap (Java SE 21 & JDK 21) — get(Object)
- Object (Java SE 21 & JDK 21) — hashCode()
- LinkedHashMap (Java SE 21 & JDK 21)
- ConcurrentHashMap (Java SE 21 & JDK 21) — get(Object)
- Java Language Specification, Java SE 21 — §4.8 Raw Types
- Java Language Specification, Java SE 21 — Chapter 5. Conversions and Contexts
- Java Language Specification, Java SE 21 — §17.4.5 Happens-before Order