CKTIS / Java
Map.containsValue — verificare la presenza di un valore
Verifica se almeno una chiave è associata a un valore e scopri perché l’esempio con `WeakHashMap` cerca `null` prima di chiamare `reachabilityFence(t3)`.
Versione: Java SE 21
Sintassi
boolean containsValue(Object value);Map.containsValue è un metodo di istanza di java.util.Map<K, V>. Accetta un Object, non un V. Secondo il contratto dell’interfaccia, restituisce true se Objects.equals(value, v) vale per almeno un valore memorizzato v, altrimenti restituisce false. Non indica la chiave corrispondente né conta le corrispondenze. IdentityHashMap si discosta intenzionalmente da questo contratto e confronta i valori con ==.
containsKey(key) cerca una chiave; containsValue(value) cerca tra i valori. Se la mappa ammette valori null, containsValue(null) rileva una voce con valore null, non una voce mancante. Se null non è ammesso o il tipo è inappropriato, l’implementazione può restituire false o lanciare, rispettivamente, NullPointerException o ClassCastException. ConcurrentHashMap lancia NullPointerException quando si cerca il valore null.
Nella maggior parte delle implementazioni, la ricerca di un valore richiede in genere un tempo lineare rispetto al numero di voci: può essere necessario esaminare l’intera mappa. Non dare per scontato che sia veloce quanto la ricerca di una chiave.
WeakHashMap ammette valori null e mantiene le chiavi tramite riferimenti deboli. Quando una chiave diventa debolmente raggiungibile, la relativa voce può scomparire a seguito della garbage collection. Collocare Reference.reachabilityFence(t3) dopo la verifica mantiene l’oggetto chiave fortemente raggiungibile almeno fino al termine della chiamata. La chiamata non avvia la garbage collection né garantisce che la voce scompaia in seguito.
Esempi
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);
}
}Risultato
true false false
La prima riga è `true` perché `t3` è associato a `null`. La seconda è `false` perché `null` non è una chiave, e la terza è `false` perché nessuna voce ha il valore `"ready"`.
Lezioni correlate
- Java · Lezione 18 · Avanzato · Versione: 2
Fonti
- 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