File Doc Category Size Date Package
WeakReference.java API Doc phoneME MR2 API (J2ME) 2779 Wed May 02 17:59:56 BST 2007 java.lang.ref

WeakReference

java.lang.Object
- java.lang.ref.Reference

public class WeakReference extends Reference

This class provides support for weak references. 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 the 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 weak references.

version: 12/19/01 (CLDC 1.1)
since: JDK1.2, CLDC 1.1

Fields Summary
private int
referent_index
Constructors Summary
public WeakReference(Object referent)
Creates a new weak reference that refers to the given object.
super(referent); initializeWeakReference(referent);
Methods Summary
public native void clear()
Clears this reference object.
private native void finalize()
public native java.lang.Object 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 returns null.
return
The object to which this reference refers, or null if this reference object has been cleared
private native void initializeWeakReference(java.lang.Object referent)