- java.lang.Object
-
- java.lang.ref.Reference<T>
-
- Direct Known Subclasses:
- PhantomReference, SoftReference, WeakReference
public abstract class Reference<T> extends Object
Abstract base class for reference objects. This class defines the operations common to all reference objects. Because reference objects are implemented in close cooperation with the garbage collector, this class may not be subclassed directly.- Since:
- 1.2
-
-
Method Summary
Methods Modifier and Type Method and Description void
clear()
Clears this reference object.boolean
enqueue()
Adds this reference object to the queue with which it is registered, if any.T
get()
Returns this reference object's referent.boolean
isEnqueued()
Tells whether or not this reference object has been enqueued, either by the program or by the garbage collector.
-
-
-
Method Detail
-
get
public T get()
Returns this reference object's referent. If this reference object has been cleared, either by the program or by the garbage collector, then this method returnsnull
.- Returns:
- The object to which this reference refers, or
null
if this reference object has been cleared
-
clear
public void clear()
Clears this reference object. Invoking this method will not cause this object to be enqueued.This method is invoked only by Java code; when the garbage collector clears references it does so directly, without invoking this method.
-
isEnqueued
public boolean isEnqueued()
Tells whether or not this reference object has been enqueued, either by the program or by the garbage collector. If this reference object was not registered with a queue when it was created, then this method will always returnfalse
.- Returns:
true
if and only if this reference object has been enqueued
-
enqueue
public boolean enqueue()
Adds this reference object to the queue with which it is registered, if any.This method is invoked only by Java code; when the garbage collector enqueues references it does so directly, without invoking this method.
- Returns:
true
if this reference object was successfully enqueued;false
if it was already enqueued or if it was not registered with a queue when it was created
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/lang/ref/reference.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.