CKTIS / Java
Map.containsValue — prüfen, ob ein Wert vorhanden ist
Prüfe, ob mindestens ein Schlüssel dem gesuchten Wert zugeordnet ist, und erfahre, warum das Beispiel mit `WeakHashMap` vor `reachabilityFence(t3)` nach `null` sucht.
Version: Java SE 21
Syntax
boolean containsValue(Object value);Map.containsValue ist eine Instanzmethode von java.util.Map<K, V>. Sie akzeptiert ein Object, nicht V. Laut Schnittstellenvertrag liefert sie true, wenn Objects.equals(value, v) für mindestens einen gespeicherten Wert v gilt, sonst false. Sie liefert weder einen passenden Schlüssel noch die Anzahl der Treffer. IdentityHashMap weicht bewusst von diesem Vertrag ab und vergleicht Werte mit ==.
containsKey(key) sucht nach einem Schlüssel, containsValue(value) unter den Werten. Erlaubt die Map null als Wert, erkennt containsValue(null) einen Eintrag mit dem Wert null, keinen fehlenden Eintrag. Bei unzulässigem null oder ungeeignetem Typ kann die Implementierung false zurückgeben oder eine NullPointerException beziehungsweise ClassCastException auslösen. ConcurrentHashMap löst bei einer Suche nach dem Wert null eine NullPointerException aus.
Bei den meisten Implementierungen wächst die Laufzeit der Wertsuche typischerweise linear mit der Anzahl der Einträge: Die gesamte Map muss möglicherweise durchsucht werden. Gehe nicht davon aus, dass die Wertsuche genauso schnell ist wie die Schlüsselsuche.
WeakHashMap erlaubt null als Wert und hält Schlüssel über schwache Referenzen. Wird ein Schlüssel schwach erreichbar, kann sein Eintrag infolge der Garbage Collection verschwinden. Der Aufruf von Reference.reachabilityFence(t3) nach der Prüfung hält das Schlüsselobjekt mindestens bis zum Ende dieses Aufrufs stark erreichbar. Er löst keine Garbage Collection aus und garantiert nicht, dass der Eintrag später verschwindet.
Beispiele
import java.lang.ref.Reference;
import java.util.Map;
import java.util.WeakHashMap;
public class Main {
public static void main(String[] args) {
Map<Object, String> map = new WeakHashMap<>();
Object t3 = new Object();
map.put(t3, null);
System.out.println(map.containsValue(null));
System.out.println(map.containsKey(null));
System.out.println(map.containsValue("ready"));
Reference.reachabilityFence(t3);
}
}Ergebnis
true false false
Die erste Zeile lautet `true`, weil `t3` den Wert `null` hat. Die zweite lautet `false`, weil `null` kein Schlüssel ist, und die dritte lautet `false`, weil kein Eintrag den Wert `"ready"` hat.
Zugehörige Lektionen
- Java · Lektion 18 · Fortgeschritten · Version: 2
Quellen
- Map (Java SE 21 & JDK 21) — containsValue
- WeakHashMap (Java SE 21 & JDK 21)
- Reference (Java SE 21 & JDK 21) — reachabilityFence
- IdentityHashMap (Java SE 21 & JDK 21) — containsValue
- ConcurrentHashMap (Java SE 21 & JDK 21) — containsValue
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs