База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

WeakHashMap — карта със слаби ключове

WeakHashMap съхранява ключовете чрез слаби препратки: самата карта не ги защитава от събиране на отпадъци. Научете put, get, containsKey, containsValue и size, както и разликата между липсващ запис и стойност null.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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> е хеш-базирана карта със слаби ключове. Слабата препратка не пречи на garbage collector (GC) да освободи обект. Затова картата може да загуби запис, след като ключът му бъде събран; моментът на премахване не е детерминиран.

WeakHashMap.put(key, value) добавя или заменя стойност и връща предишната стойност или null (няма запис или предишната стойност е била null). WeakHashMap.get(key) връща стойността или null. WeakHashMap.containsKey(key) проверява дали има запис, като различава липсата му от съпоставяне с null; WeakHashMap.containsValue(value) проверява дали дадена стойност присъства. WeakHashMap.size() връща моментна бройка, която може да намалее без изрични промени.

Позволени са ключът null и стойности null. Търсенето отчита equals и hashCode, а не само идентичността на обектите. Стойностите се пазят със силни препратки: техни преки или косвени препратки към ключове могат да попречат на събирането им. Картата не е синхронизирана; синхронизацията не предотвратява премахване, предизвикано от GC.

Примерът поддържа key достижим до Reference.reachabilityFence(key), така че резултатът да не зависи от GC. Той показва замяна на стойност и разликата между това get(key) да върне null и ключът да присъства.

Примери

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

Резултат

null
draft
ready
true
true
1
null
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници