Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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