Class Overview
Weak reference objects, which do not prevent their referents from being
made finalizable, finalized, and then reclaimed. Weak references are most
often used to implement canonicalizing mappings.
Suppose that the garbage collector determines at a certain point in time
that an object is weakly
reachable. At that time it will atomically clear all weak references to
that object and all weak references to any other weakly-reachable objects
from which that object is reachable through a chain of strong and soft
references. At the same time it will declare all of the formerly
weakly-reachable objects to be finalizable. At the same time or at some
later time it will enqueue those newly-cleared weak references that are
registered with reference queues.
Summary
Public Constructors |
|
WeakReference(T referent)
Creates a new weak reference that refers to the given object.
|
|
WeakReference(T referent, ReferenceQueue<? super T> q)
Creates a new weak reference that refers to the given object and is
registered with the given queue.
|
[Expand]
Inherited Methods |
From class
java.lang.ref.Reference
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.
|
|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
final
void
|
wait(long timeout, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long timeout)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
|
Public Constructors
public
WeakReference
(T referent)
Creates a new weak reference that refers to the given object. The new
reference is not registered with any queue.
Parameters
referent
| object the new weak reference will refer to
|
public
WeakReference
(T referent, ReferenceQueue<? super T> q)
Creates a new weak reference that refers to the given object and is
registered with the given queue.
Parameters
referent
| object the new weak reference will refer to |
q
| the queue with which the reference is to be registered,
or null if registration is not required
|