compact1, compact2, compact3

java.util

Класс WeakHashMap <K, V>

java.lang. Объект

java.util. AbstractMap<K, V>

java.util. WeakHashMap <K, V>

Введите Параметры:

K - тип ключей сохраняется этой картой

V - тип отображенных значений

Все Реализованные Интерфейсы:

Карта <K, V>

public class WeakHashMap<K,V>
extends AbstractMap<K,V>
implements Map<K,V>

Хэш-таблица базируемая реализация интерфейса Map, со слабыми ключами. Запись в WeakHashMap будет автоматически удалена, когда его ключ больше не будет при нормальном использовании. Более точно присутствие отображения для данного ключа не будет препятствовать тому, чтобы ключ был отброшен сборщиком "мусора", то есть, сделан finalizable, завершенный, и затем исправлен. Когда ключ был отброшен, его запись эффективно удаляется из карты, таким образом, этот class ведет себя несколько по-другому от других реализаций Map.

Поддерживаются оба нулевых значения и нулевой ключ. Этот class имеет показатели производительности, подобные таковым из HashMap class, и имеет те же самые параметры эффективности начальной емкости и коэффициента загрузки.

Как большинство классов набора, не синхронизируется этот class. Синхронизируемый WeakHashMap может быть создан, используя Collections.synchronizedMap метод.

Этот class предназначается прежде всего для использования с ключевыми объектами, методы equals которых тестируют на объектные идентификационные данные, используя оператор ==. Как только такой ключ отбрасывается, он никогда не может воссоздаваться, таким образом, невозможно сделать поиск того ключа в WeakHashMap в некоторое более позднее время и быть удивленным, что его запись была удалена. Этот class будет работать отлично с ключевыми объектами, методы equals которых не основаны на объектных идентификационных данных, таковы как экземпляры String. С такими recreatable ключевыми объектами, однако, автоматическое удаление записей WeakHashMap, ключи которых были отброшены, может оказаться, сбивает с толку.

Поведение WeakHashMap, class зависит частично от действий сборщика "мусора", таким образом, несколько знакомые (хотя не требуемый) инварианты Map не содержат для этого class. Поскольку сборщик "мусора" может отбросить ключи в любое время, WeakHashMap может вести себя, как если бы неизвестный поток тихо удаляет записи. В частности даже если Вы синхронизируетесь на экземпляре WeakHashMap и не вызываете ни один из его мутаторных методов, для метода size возможно возвратить меньшие значения в течение долгого времени, для метода isEmpty, чтобы возвратить false и затем true, для метода containsKey, чтобы возвратить true и более поздний false для данного ключа, для метода get, чтобы возвратить значение для данного ключевого, но более позднего возврата null, для метода put, чтобы возвратить null и метод remove, чтобы возвратить false для ключа, который ранее, казалось, был в карте, и для последовательных исследований набора ключей, набора значения, и набора записи, чтобы привести к последовательно меньшим числам элементов.

Каждый ключевой объект в WeakHashMap сохранен косвенно как референт слабой ссылки. Поэтому ключ будет автоматически удален только после того, как слабые ссылки на него, и внутри и снаружи карты, были очищены сборщиком "мусора".

Примечание реализации: объекты значения в WeakHashMap сохранены обычными ссылками strong. Таким образом забота должна быть проявлена, чтобы гарантировать, что объекты значения строго не обращаются к их собственным ключам, ни один прямо или косвенно, так как это будет препятствовать тому, чтобы ключи были отброшены. Отметьте, что объект значения может обратиться косвенно к его ключу через WeakHashMap непосредственно; то есть, объект значения может строго обратиться к некоторому другому ключевому объекту, объект присваиваемого значения которого, поочередно, строго обращается к ключу первого объекта значения. Если значения в карте не полагаются на карту, содержащую ссылки strong на них, один способ иметь дело с этим состоит в том, чтобы обернуть значения непосредственно в пределах WeakReferences перед вставкой, как в: m.put(key, new WeakReference(value)), и затем разворачивающий на каждый get.

iterators, возвращенные методом iterator наборов, возвращенных всеми "методами представления набора этого class", являются сбоем быстро: если карта структурно изменяется когда-либо после того, как iterator создается, всегда кроме через собственный метод remove iterator, iterator бросит a ConcurrentModificationException. Таким образом, перед лицом параллельной модификации, iterator перестал работать быстро и чисто, вместо того, чтобы рискнуть произвольным, недетерминированным поведением в неопределенное время в будущем.

Отметьте, что поведение сбоя быстро iterator не может быть гарантировано, как, вообще говоря, невозможно сделать любые трудные гарантии в присутствии несинхронизируемой параллельной модификации. Перестаньте работать быстро iterators бросают ConcurrentModificationException на основе максимальных усилий. Поэтому, было бы неправильно записать программу, которая зависела от этого исключения для его правильности: поведение сбоя быстро iterators должно использоваться только, чтобы обнаружить ошибки.

Этот class является элементом Платформы Наборов Java.

С тех пор:

1.2

См. Также:

HashMap, WeakReference

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от class java.util. AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Сводка конструктора

Конструкторы

Конструктор и Описание
WeakHashMap() Создает новый, пустой WeakHashMap с емкостью начальной буквы значения по умолчанию (16) и коэффициент загрузки (0.75).
WeakHashMap(int initialCapacity) Создает новый, пустой WeakHashMap с данной начальной емкостью и коэффициентом загрузки значения по умолчанию (0.75).
WeakHashMap(int initialCapacity, float loadFactor) Создает новый, пустой WeakHashMap с данной начальной емкостью и данным коэффициентом загрузки.
WeakHashMap(Map<? extends K,? extends V> m) Создает новый WeakHashMap с теми же самыми отображениями как указанная карта.

Сводка метода

Модификатор и Тип	Метод и Описание
void	clear() Удаляет все отображения из этой карты.
boolean	containsKey(Object key) true возвратов, если эта карта содержит отображение для указанного ключа.
boolean	containsValue(Object value) true возвратов, если эта карта отображает один или более ключей на указанное значение.
Set<Map.Entry<K,V>>	entrySet() Возвраты a Set представление отображений содержится в этой карте.
V	get(Object key) Возвращает значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа.
boolean	isEmpty() true возвратов, если эта карта не содержит отображений значения ключа.
Set<K>	keySet() Возвраты a Set представление ключей содержится в этой карте.
V	put(K key, V value) Связывает указанное значение с указанным ключом в этой карте.
void	putAll(Map<? extends K,? extends V> m) Копии все отображения от указанной карты до этой карты.
V	remove(Object key) Удаляет отображение для ключа из этой слабой карты хеша, если это присутствует.
int	size() Возвращает число отображений значения ключа в этой карте.
Collection<V>	values() Возвраты a Collection представление значений содержится в этой карте.

Методы, наследованные от class java.util. AbstractMap

clone, equals, hashCode, toString

Методы, наследованные от class java.lang. Объект

finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.util. Карта

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Деталь конструктора

WeakHashMap

public WeakHashMap(int initialCapacity,
                   float loadFactor)

Создает новый, пустой WeakHashMap с данной начальной емкостью и данным коэффициентом загрузки.

Параметры:

initialCapacity - Начальная емкость WeakHashMap

loadFactor - Коэффициент загрузки WeakHashMap

Броски:

IllegalArgumentException - если начальная емкость отрицательна, или если коэффициент загрузки неположителен.

WeakHashMap

public WeakHashMap(int initialCapacity)

Создает новый, пустой WeakHashMap с данной начальной емкостью и коэффициентом загрузки значения по умолчанию (0.75).

Параметры:

initialCapacity - Начальная емкость WeakHashMap

Броски:

IllegalArgumentException - если начальная емкость отрицательна

WeakHashMap

public WeakHashMap()

Создает новый, пустой WeakHashMap с емкостью начальной буквы значения по умолчанию (16) и коэффициент загрузки (0.75).

WeakHashMap

public WeakHashMap(Map<? extends K,? extends V> m)

Создает новый WeakHashMap с теми же самыми отображениями как указанная карта. WeakHashMap создается с коэффициентом загрузки значения по умолчанию (0.75) и начальной емкостью, достаточной, чтобы содержать отображения в указанной карте.

Параметры:

m - карта, отображения которой должны быть помещены в эту карту

Броски:

NullPointerException - если указанная карта является нулем

С тех пор:

1.3

Деталь метода

размер

public int size()

Возвращает число отображений значения ключа в этой карте. Этот результат является снимком, и, возможно, не отражает необработанные записи, которые будут удалены прежде затем предпринятый доступ, потому что на них больше не ссылаются.

Определенный:

size в интерфейсе Map<K,V>

Переопределения:

size в class AbstractMap<K,V>

Возвраты:

число отображений значения ключа в этой карте

isEmpty

public boolean isEmpty()

true возвратов, если эта карта не содержит отображений значения ключа. Этот результат является снимком, и, возможно, не отражает необработанные записи, которые будут удалены прежде затем предпринятый доступ, потому что на них больше не ссылаются.

Определенный:

isEmpty в интерфейсе Map<K,V>

Переопределения:

isEmpty в class AbstractMap<K,V>

Возвраты:

true, если эта карта не содержит отображений значения ключа

добраться

public V get(Object key)

Возвращает значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа.

Более формально, если эта карта содержит отображение от ключа k к значению v так, что (key==null ? k==null : key.equals(k)), тогда этот метод возвраты v; иначе это возвращается null. (Может быть самое большее одно такое отображение.)

Возвращаемое значение null не обязательно указывает, что карта не содержит отображения для ключа; также возможно, что карта явно отображает ключ на null. containsKey работа может использоваться, чтобы отличить эти два случая.

Определенный:

get в интерфейсе Map<K,V>

Переопределения:

get в class AbstractMap<K,V>

Параметры:

key - ключ, присваиваемое значение которого должно быть возвращено

Возвраты:

значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа

См. Также:

put(Object, Object)

containsKey

public boolean containsKey(Object key)

true возвратов, если эта карта содержит отображение для указанного ключа.

Определенный:

containsKey в интерфейсе Map<K,V>

Переопределения:

containsKey в class AbstractMap<K,V>

Параметры:

key - Ключ, присутствие которого в этой карте должно быть протестировано

Возвраты:

true, если есть отображение для key; false иначе

поместить

public V put(K key,
             V value)

Связывает указанное значение с указанным ключом в этой карте. Если карта, ранее содержавшая отображение для этого ключа, старое значение заменяется.

Определенный:

put в интерфейсе Map<K,V>

Переопределения:

put в class AbstractMap<K,V>

Параметры:

key - ключ, с которым должно быть связано указанное значение.

value - значение, которое будет связано с указанным ключом.

Возвраты:

предыдущее значение, связанное с key, или null, если не было никакого отображения для key. (Возврат null может также указать что карта ранее связанный null с key.)

putAll

public void putAll(Map<? extends K,? extends V> m)

Копии все отображения от указанной карты до этой карты. Эти отображения заменят любые отображения, которые эта карта имела для любого из ключей в настоящий момент в указанной карте.

Определенный:

putAll в интерфейсе Map<K,V>

Переопределения:

putAll в class AbstractMap<K,V>

Параметры:

m - отображения, которые будут сохранены в этой карте.

Броски:

NullPointerException - если указанная карта является нулем.

удалить

public V remove(Object key)

Удаляет отображение для ключа из этой слабой карты хеша, если это присутствует. Более формально, если эта карта содержит отображение от ключа k, чтобы оценить v так, что (key==null ? k==null : key.equals(k)), то отображение удаляется. (Карта может содержать самое большее одно такое отображение.)

Возвращает значение который эта карта, ранее связанная ключ, или null если карта, содержавшая никакое отображение для ключа. Возвращаемое значение null не обязательно указывает что карта, содержавшая никакое отображение для ключа; также возможно что карта, явно отображенная ключ на null.

Карта не будет содержать отображение для указанного ключа, как только вызов возвращается.

Определенный:

remove в интерфейсе Map<K,V>

Переопределения:

remove в class AbstractMap<K,V>

Параметры:

key - ключ, отображение которого должно быть удалено из карты

Возвраты:

предыдущее значение, связанное с key, или null, если не было никакого отображения для key

очистить

public void clear()

Удаляет все отображения из этой карты. Карта будет пуста после этого вызова возвраты.

Определенный:

clear в интерфейсе Map<K,V>

Переопределения:

clear в class AbstractMap<K,V>

containsValue

public boolean containsValue(Object value)

true возвратов, если эта карта отображает один или более ключей на указанное значение.

Определенный:

containsValue в интерфейсе Map<K,V>

Переопределения:

containsValue в class AbstractMap<K,V>

Параметры:

value - оцените, чье присутствие в этой карте должно быть протестировано

Возвраты:

true, если эта карта отображает один или более ключей на указанное значение

набор ключей

public Set<K> keySet()

Возвраты a Set представление ключей содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме посредством собственной работы remove iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и операции clear. Это не поддерживает операции addAll или add.

Определенный:

keySet в интерфейсе Map<K,V>

Переопределения:

keySet в class AbstractMap<K,V>

Возвраты:

представление набора ключей содержится в этой карте

значения

public Collection<V> values()

Возвраты a Collection представление значений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме посредством собственной работы remove iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Collection.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.

Определенный:

values в интерфейсе Map<K,V>

Переопределения:

values в class AbstractMap<K,V>

Возвраты:

представление набора значений содержится в этой карте

entrySet

public Set<Map.Entry<K,V>> entrySet()

Возвраты a Set представление отображений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме посредством собственной работы remove iterator, или посредством работы setValue на записи карты, возвращенной iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.

Определенный:

entrySet в интерфейсе Map<K,V>

Определенный:

entrySet в class AbstractMap<K,V>

Возвраты:

представление набора отображений содержится в этой карте