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

CKTIS / Java

WeakHashMap — une map à clés faibles

WeakHashMap conserve ses clés au moyen de références faibles : la map, à elle seule, ne les protège pas du ramasse-miettes. Découvrez put, get, containsKey, containsValue et size, ainsi que la différence entre une entrée absente et une valeur null.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

WeakHashMap<K, V> map = new WeakHashMap<>();
V previous = map.put(key, value);
V retrieved = map.get(key);
boolean hasKey = map.containsKey(key);
boolean hasValue = map.containsValue(value);
int count = map.size();

java.util.WeakHashMap<K, V> est une map de hachage à clés faibles. Une référence faible n’empêche pas le ramasse-miettes (GC) de récupérer un objet. La map peut donc perdre une entrée après la récupération de sa clé ; le moment de la suppression est indéterminé.

WeakHashMap.put(key, value) ajoute ou remplace une valeur et renvoie la valeur précédente ou null (absence d’entrée ou valeur précédente null). WeakHashMap.get(key) renvoie la valeur ou null. WeakHashMap.containsKey(key) vérifie la présence d’une entrée et distingue l’absence d’une association à null ; WeakHashMap.containsValue(value) vérifie la présence d’une valeur. WeakHashMap.size() renvoie un décompte instantané qui peut diminuer sans modification explicite.

La clé null et les valeurs null sont autorisées. La recherche tient compte de equals et de hashCode, et pas seulement de l’identité des objets. Les valeurs sont conservées par des références fortes : leurs références directes ou indirectes vers les clés peuvent empêcher leur récupération. La map n’est pas synchronisée ; la synchronisation n’empêche pas les suppressions dues au GC.

L’exemple garde key accessible jusqu’à Reference.reachabilityFence(key) afin que son résultat ne dépende pas du GC. Il montre le remplacement d’une valeur et la différence entre get(key) qui renvoie null et la présence de la clé.

Exemples

import java.lang.ref.Reference;
import java.util.WeakHashMap;

public class Main {
    public static void main(String[] args) {
        Object key = new Object();
        WeakHashMap<Object, String> map = new WeakHashMap<>();
        try {
            System.out.println(map.put(key, "draft"));
            System.out.println(map.put(key, "ready"));
            System.out.println(map.get(key));
            System.out.println(map.containsKey(key));
            System.out.println(map.containsValue("ready"));
            System.out.println(map.size());
            map.put(key, null);
            System.out.println(map.get(key));
            System.out.println(map.containsKey(key));
        } finally {
            Reference.reachabilityFence(key);
        }
    }
}

Résultat

null
draft
ready
true
true
1
null
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources