Пакет java.lang.ref

Обеспечивает ссылочные классы объектов, которые поддерживают ограниченный уровень взаимодействия со сборщиком "мусора".

См.: Описание

Сводка класса

Класс	Описание
PhantomReference <T>	Фантомные ссылочные объекты, которые ставятся в очередь после коллектора, решают, что их референты могут иначе быть исправлены.
Ссылка <T>	Абстрактный class для ссылочных объектов.
ReferenceQueue <T>	Обнаруживаются ссылочные очереди, к которым зарегистрированные ссылочные объекты добавляются сборщиком "мусора" после соответствующих изменений достижимости.
SoftReference <T>	Мягкие ссылочные объекты, которые очищаются на усмотрение сборщика "мусора" в ответ на требование памяти.
WeakReference <T>	Объекты слабой ссылки, которые не препятствуют тому, чтобы их референты были сделаны finalizable, завершенным, и затем исправлены.

Пакет java.lang.ref Описание

Обеспечивает ссылочные классы объектов, которые поддерживают ограниченный уровень взаимодействия со сборщиком "мусора". Программа может использовать ссылочный объект поддержать ссылку на некоторый другой объект таким способом, которым последний объект может все еще быть исправлен коллектором. Программа может также расположить быть уведомленной некоторое время после того, как коллектор решил, что достижимость данного объекта изменилась.

Спецификация пакета

Ссылочный объект инкапсулирует ссылку на некоторый другой объект так, чтобы сама ссылка могла быть исследована и управляться как любой другой объект. Три типа ссылочных объектов обеспечиваются, каждый более слабый чем последнее: мягкий, слабый, и фантом. Каждый тип соответствует различному уровню достижимости, как определено ниже. Мягкие ссылки для того, чтобы реализовать чувствительные к памяти кэши, слабые ссылки для того, чтобы реализовать отображения канонизации, которые не предотвращают их ключи (или значения) от того, чтобы быть исправленным, и фантомные ссылки для того, чтобы запланировать pre-mortem действия уборки более гибким способом, чем возможно с механизмом завершения Java.

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

Уведомление

Программа может запросить быть уведомленной относительно изменений в достижимости объекта, регистрируя соответствующий ссылочный объект со ссылочной очередью в то время, когда ссылочный объект создается. Некоторое время после сборщика "мусора" решает, что достижимость референта изменилась на значение, соответствующее типу ссылки, это добавит ссылку на связанную очередь. В этой точке ссылка, как полагают, ставится в очередь. Программа может удалить ссылки из очереди или опрашивая или блокируя, пока ссылка не становится доступной. Ссылочные очереди реализуются ReferenceQueue class.

Отношение между зарегистрированным ссылочным объектом и его очередью является односторонним. Таким образом, очередь не отслеживает ссылки, которые регистрируются в ней. Если зарегистрированная ссылка станет недостижимой непосредственно, то она никогда не будет ставиться в очередь. Это - ответственность программы, используя ссылочные объекты гарантировать, что объекты остаются достижимыми столько, сколько программа интересуется их референтами.

В то время как некоторые программы будут хотеть выделять поток удалению ссылочных объектов от одной или более очередей и обработки их, это ни в коем случае не необходимо. Тактика, которая часто работает хорошо, должна исследовать ссылочную очередь в ходе выполнения некоторого другого справедливо частого действия. Например, хеш-таблица, которая использует слабые ссылки, чтобы реализовать слабые ключи, могла опросить свою ссылочную очередь каждый раз, когда к таблице получают доступ. Это то, как WeakHashMap Работы class. Поскольку ReferenceQueue.poll метод просто проверяет внутреннюю структуру данных, эта проверка добавит небольшие издержки к методам доступа хеш-таблицы.

Автоматически очищенные ссылки

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

Достижимость

Идя от самого сильного до самого слабого, разные уровни достижимости отражают жизненный цикл объекта. Они оперативно определяются следующим образом:

• Объект строго достижим, если он может быть достигнут некоторым потоком, не пересекая ссылочных объектов. Недавно создаваемый объект строго достижим потоком, который создал его.
• Объект мягко достижим, если это не строго достижимо, но может быть достигнуто, пересекая мягкую ссылку.
• Объект слабо достижим, если это не ни строго, ни мягко достижимо, но может быть достигнуто, пересекая слабую ссылку. Когда слабые ссылки на слабо достижимый объект очищаются, объект становится имеющим право на завершение.
• Объект является фантомом, достижимым, если это не ни строго, мягко, ни слабо достижимо, это было завершено, и некоторая фантомная ссылка обращается к этому.
• Наконец, объект недостижим, и поэтому имеет право на восстановление, когда это не достижимо любым из вышеупомянутых способов.

С тех пор:

1.2 For overviews, tutorials, examples, guides, and tool documentation, please see:

• ##### REFER TO NON-SPEC DOCUMENTATION HERE #####

-->