Module java.base
Package java.lang.ref

Class Reference<T>

    • Method Detail

      • clear

        public void clear()
        Make the referent null. This does not force the reference object to be enqueued.
      • enqueue

        public boolean enqueue()
        Force the reference object to be enqueued if it has been associated with a queue.
        Returns:
        true if Reference is enqueued, false otherwise.
      • get

        public T get()
        Return the referent of the reference object.
        Returns:
        the referent to which reference refers, or null if object has been cleared.
      • isEnqueued

        public boolean isEnqueued()
        Return whether the reference object has been enqueued.
        Returns:
        true if Reference has been enqueued, false otherwise.
      • reachabilityFence

        public static void reachabilityFence​(Object ref)
        Used to keep the referenced object strongly reachable so that it is not reclaimable by garbage collection.
        Parameters:
        ref - reference of the object.
        Since:
        1.9
      • clone

        protected Object clone()
                        throws CloneNotSupportedException
        This method will always throw CloneNotSupportedException. A clone of this instance will not be returned since a Reference cannot be cloned. Workaround is to create a new Reference.
        Overrides:
        clone in class Object
        Returns:
        Object a shallow copy of this object.
        Throws:
        CloneNotSupportedException - always since a Reference cannot be cloned
        Since:
        11