Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

WeakHashMap — mapa se slabými klíči

WeakHashMap uchovává klíče pomocí slabých referencí: samotná mapa je nechrání před uvolněním garbage collectorem. Seznamte se s metodami put, get, containsKey, containsValue a size i s rozdílem mezi chybějící položkou a hodnotou null.

Verze: 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> je hašovací mapa se slabými klíči. Slabá reference nebrání garbage collectoru (GC) v uvolnění objektu. Mapa proto může přijít o položku poté, co je její klíč uvolněn; okamžik odstranění není deterministický.

WeakHashMap.put(key, value) přidá nebo nahradí hodnotu a vrátí předchozí hodnotu, nebo null (položka neexistuje nebo byla předchozí hodnota null). WeakHashMap.get(key) vrátí hodnotu nebo null. WeakHashMap.containsKey(key) ověří, zda položka existuje, a rozlišuje mezi její nepřítomností a přiřazením hodnoty null; WeakHashMap.containsValue(value) ověří přítomnost hodnoty. WeakHashMap.size() vrátí okamžitý počet položek, který se může snížit i bez výslovných změn.

Klíč null i hodnoty null jsou povoleny. Vyhledávání respektuje equals a hashCode, nikoli pouze identitu objektů. Hodnoty jsou drženy silnými referencemi: jejich přímé nebo nepřímé odkazy na klíče mohou zabránit jejich uvolnění. Mapa není synchronizovaná; synchronizace nezabrání odstraňování způsobenému GC.

Příklad udržuje key dosažitelný až do Reference.reachabilityFence(key), aby výsledek nezávisel na GC. Ukazuje nahrazení hodnoty a rozdíl mezi tím, když get(key) vrátí null, a tím, že klíč v mapě existuje.

Příklady

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);
        }
    }
}

Výsledek

null
draft
ready
true
true
1
null
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje