Класс WeakHashMap<K,V>

Поддерживаются как нулевые значения, так и нулевой ключ. Этот класс обладает характеристиками производительности, аналогичными характеристикам класса 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.