Класс WeakHashMap<K,V>

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

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

Этот класс предназначен в первую очередь для использования с объектами ключей, чьи методы equals проверяют тождественность объектов с использованием оператора ==. После удаления такого ключа его нельзя воссоздать, поэтому невозможно выполнить поиск этого ключа в WeakHashMap в более позднее время и быть удивленным, что его запись была удалена. Этот класс будет работать прекрасно с объектами ключей, чьи методы equals не основаны на тождественности объектов, таких как экземпляры String. Однако с такими воссоздаваемыми объектами ключей автоматическое удаление записей WeakHashMap, ключи которых были удалены, может оказаться запутанным.

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

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

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

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

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

Этот класс является частью Java Collections Framework.