Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

WeakHashMap — mapa so slabými kľúčmi

WeakHashMap uchováva kľúče pomocou slabých referencií: samotná mapa ich nechráni pred uvoľnením garbage collectorom. Spoznajte metódy put, get, containsKey, containsValue a size aj rozdiel medzi chýbajúcou položkou a hodnotou null.

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

Syntax

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šovacia mapa so slabými kľúčmi. Slabá referencia nebráni garbage collectoru (GC) uvoľniť objekt. Mapa preto môže stratiť položku po uvoľnení jej kľúča; okamih odstránenia nie je deterministický.

WeakHashMap.put(key, value) pridá alebo nahradí hodnotu a vráti predchádzajúcu hodnotu alebo null (položka neexistuje alebo predchádzajúca hodnota bola null). WeakHashMap.get(key) vráti hodnotu alebo null. WeakHashMap.containsKey(key) overí, či položka existuje, a rozlišuje medzi jej neprítomnosťou a priradením hodnoty null; WeakHashMap.containsValue(value) overí prítomnosť hodnoty. WeakHashMap.size() vráti okamžitý počet položiek, ktorý sa môže znížiť aj bez výslovných zmien.

Kľúč null aj hodnoty null sú povolené. Vyhľadávanie rešpektuje equals a hashCode, nielen identitu objektov. Hodnoty sa uchovávajú pomocou silných referencií: ich priame alebo nepriame odkazy na kľúče môžu zabrániť ich uvoľneniu. Mapa nie je synchronizovaná; synchronizácia nezabráni odstraňovaniu spôsobenému GC.

Príklad udržiava key dosiahnuteľný až po Reference.reachabilityFence(key), aby výsledok nezávisel od GC. Ukazuje nahradenie hodnoty a rozdiel medzi tým, keď get(key) vráti null, a tým, že kľúč v mape existuje.

Prí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ýsledok

null
draft
ready
true
true
1
null
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje