Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

WeakHashMap — mapa sa slabim ključevima

WeakHashMap čuva ključeve putem slabih referenci: sama ih mapa ne štiti od odvoza smeća. Upoznajte put, get, containsKey, containsValue i size te razliku između nedostajućeg unosa i vrijednosti null.

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

Sintaksa

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> hash-mapa je sa slabim ključevima. Slaba referenca ne sprječava garbage collector (GC) da oslobodi objekt. Mapa stoga može izgubiti unos nakon što se njegov ključ prikupi; trenutak uklanjanja nije deterministički.

WeakHashMap.put(key, value) dodaje ili zamjenjuje vrijednost te vraća prethodnu vrijednost ili null (unos ne postoji ili je prethodna vrijednost bila null). WeakHashMap.get(key) vraća vrijednost ili null. WeakHashMap.containsKey(key) provjerava postoji li unos i razlikuje njegovu odsutnost od mapiranja na null; WeakHashMap.containsValue(value) provjerava postoji li vrijednost. WeakHashMap.size() vraća trenutačni broj unosa, koji se može smanjiti bez izričitih izmjena.

Dopušteni su ključ null i vrijednosti null. Pretraživanje uvažava equals i hashCode, a ne samo identitet objekata. Vrijednosti se čuvaju snažnim referencama: njihove izravne ili neizravne reference na ključeve mogu spriječiti njihovo prikupljanje. Mapa nije sinkronizirana; sinkronizacija ne sprječava uklanjanje koje pokreće GC.

Primjer održava key dostupnim do Reference.reachabilityFence(key) kako rezultat ne bi ovisio o GC-u. Prikazuje zamjenu vrijednosti i razliku između toga da get(key) vraća null i toga da je ključ prisutan.

Primjeri

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

Rezultat

null
draft
ready
true
true
1
null
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori