Класс 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.