Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

WeakHashMap — mapa s šibkimi ključi

WeakHashMap hrani ključe prek šibkih referenc: sama mapa jih ne zaščiti pred garbage collection. Spoznajte put, get, containsKey, containsValue in size ter razliko med manjkajočim vnosom in vrednostjo null.

Različica: 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> je zgoščevalna mapa s šibkimi ključi. Šibka referenca ne prepreči, da garbage collector (GC) sprosti objekt. Mapa lahko zato izgubi vnos, ko je njegov ključ zbran; čas odstranitve ni determinističen.

WeakHashMap.put(key, value) doda ali zamenja vrednost in vrne prejšnjo vrednost ali null (vnosa ni ali pa je bila prejšnja vrednost null). WeakHashMap.get(key) vrne vrednost ali null. WeakHashMap.containsKey(key) preveri, ali vnos obstaja, in razlikuje med odsotnostjo vnosa ter preslikavo na null; WeakHashMap.containsValue(value) preveri, ali je vrednost prisotna. WeakHashMap.size() vrne trenutni posnetek števila vnosov, ki se lahko zmanjša brez izrecnih sprememb.

Dovoljena sta ključ null in vrednosti null. Iskanje upošteva equals in hashCode, ne le identitete objektov. Vrednosti se hranijo z močnimi referencami: njihove neposredne ali posredne reference na ključe lahko preprečijo njihovo sprostitev. Mapa ni sinhronizirana; sinhronizacija ne prepreči odstranjevanja, ki ga povzroči GC.

Primer ohranja key dosegljiv do Reference.reachabilityFence(key), zato rezultat ni odvisen od GC. Prikazuje zamenjavo vrednosti in razliko med tem, da get(key) vrne null, ter tem, da je ključ prisoten.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri