sample/java.lang.ref.WeakReference.txt

   1 *java.lang.ref.WeakReference* *WeakReference* Weak reference objects, which do n
   2
   3 public class WeakReference<T>
   4   extends    |java.lang.ref.Reference|
   5
   6 |java.lang.ref.WeakReference_Description|
   7 |java.lang.ref.WeakReference_Fields|
   8 |java.lang.ref.WeakReference_Constructors|
   9 |java.lang.ref.WeakReference_Methods|
  10
  11 ================================================================================
  12
  13 *java.lang.ref.WeakReference_Constructors*
  14 |java.lang.ref.WeakReference(T)|Creates a new weak reference that refers to the
  15 |java.lang.ref.WeakReference(T,ReferenceQueue<?superT>)|Creates a new weak refe
  16
  17 *java.lang.ref.WeakReference_Description*
  18
  19 Weak reference objects, which do not prevent their referents from being made
  20 finalizable, finalized, and then reclaimed. Weak references are most often used
  21 to implement canonicalizing mappings.
  22
  23 Suppose that the garbage collector determines at a certain point in time that
  24 an object is weakly reachable. At that time it will atomically clear all weak
  25 references to that object and all weak references to any other weakly-reachable
  26 objects from which that object is reachable through a chain of strong and soft
  27 references. At the same time it will declare all of the formerly
  28 weakly-reachable objects to be finalizable. At the same time or at some later
  29 time it will enqueue those newly-cleared weak references that are registered
  30 with reference queues.
  31
  32
  33
  34 *java.lang.ref.WeakReference(T)*
  35
  36 public WeakReference(T referent)
  37
  38 Creates a new weak reference that refers to the given object. The new reference
  39 is not registered with any queue.
  40
  41     referent - object the new weak reference will refer to
  42
  43 *java.lang.ref.WeakReference(T,ReferenceQueue<?superT>)*
  44
  45 public WeakReference(
  46   T referent,
  47   java.lang.ref.ReferenceQueue<? super T> q)
  48
  49 Creates a new weak reference that refers to the given object and is registered
  50 with the given queue.
  51
  52     referent - object the new weak reference will refer to
  53     q - the queue with which the reference is to be registered, or null if registration
  54        is not required
  55