CKTIS / Java
Map.containsValue — tester la présence d’une valeur
Vérifiez si au moins une clé est associée à une valeur donnée et voyez pourquoi l’exemple avec `WeakHashMap` recherche `null` avant l’appel à `reachabilityFence(t3)`.
Version : Java SE 21
Syntaxe
boolean containsValue(Object value);Map.containsValue est une méthode d’instance de java.util.Map<K, V>. Elle prend un Object, et non un V. D’après le contrat de l’interface, elle renvoie true si Objects.equals(value, v) est vrai pour au moins une valeur stockée v, et false sinon. Elle ne donne ni la clé correspondante ni le nombre de correspondances. IdentityHashMap déroge volontairement à ce contrat et compare les valeurs avec ==.
containsKey(key) recherche une clé ; containsValue(value) cherche parmi les valeurs. Si la map accepte les valeurs null, containsValue(null) détecte une entrée dont la valeur est null, pas une entrée absente. Si null est interdit ou si le type est inadapté, l’implémentation peut renvoyer false ou lever respectivement une NullPointerException ou une ClassCastException. ConcurrentHashMap lève une NullPointerException lorsqu’on recherche la valeur null.
Dans la plupart des implémentations, la recherche d’une valeur prend généralement un temps linéaire en fonction du nombre d’entrées : elle peut nécessiter de parcourir toute la map. Ne supposez pas qu’elle soit aussi rapide qu’une recherche par clé.
WeakHashMap accepte les valeurs null et conserve les clés via des références faibles. Lorsqu’une clé devient faiblement accessible, son entrée peut disparaître sous l’effet du ramasse-miettes. Placer Reference.reachabilityFence(t3) après le test maintient l’objet clé fortement accessible au moins jusqu’à la fin de cet appel. L’appel ne déclenche pas le ramasse-miettes et ne garantit pas la disparition ultérieure de l’entrée.
Exemples
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);
}
}Résultat
true false false
La première ligne vaut `true` parce que `t3` est associé à `null`. La deuxième vaut `false` parce que `null` n’est pas une clé, et la troisième vaut `false` parce qu’aucune entrée n’a pour valeur `"ready"`.
Leçons associées
- Java · Leçon 18 · Avancé · Version : 2
Sources
- 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