Package org.wildfly.common.ref

Class WeakReference<T,A>

java.lang.Object
java.lang.ref.Reference<T>
java.lang.ref.WeakReference<T>
org.wildfly.common.ref.WeakReference<T,A>
Type Parameters:
T - the reference value type
A - the attachment type
All Implemented Interfaces:
Reference<T,A>
@Deprecated(forRemoval=true) public class WeakReference<T,A> extends WeakReference<T> implements Reference<T,A>
Deprecated, for removal: This API element is subject to removal in a future version.
Use WeakReference instead.
A reapable weak reference with an attachment. If a Reaper is given, then it will be used to asynchronously clean up the referent.
Author:
David M. Lloyd
See Also:

  • Nested Class Summary

    Nested classes/interfaces inherited from interface org.wildfly.common.ref.Reference

    Reference.Type

  • Constructor Summary

    Constructors
    Constructor
    Description
    WeakReference(T referent)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Construct a new instance.
    WeakReference(T referent, A attachment)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Construct a new instance.
    WeakReference(T referent, A attachment, ReferenceQueue<? super T> q)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Construct a new instance with an explicit reference queue.
    WeakReference(T referent, A attachment, Reaper<T,A> reaper)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Construct a new instance with a reaper.

  • Method Summary

    Modifier and Type
    Method
    Description
    A
    getAttachment()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Get the attachment, if any.
    Reaper<T,A>
    getReaper()
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    Reference.Type
    getType()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Get the type of the reference.
    String
    toString()
    Deprecated, for removal: This API element is subject to removal in a future version.
     

    Methods inherited from class java.lang.ref.Reference

    clear, clone, enqueue, get, isEnqueued, reachabilityFence, refersTo

    Methods inherited from class java.lang.Object

    equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

    Methods inherited from interface org.wildfly.common.ref.Reference

    clear, get

  • Constructor Details

    • WeakReference

      public WeakReference(T referent)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Construct a new instance.
      Parameters:
      referent - the referent

    • WeakReference

      public WeakReference(T referent, A attachment)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Construct a new instance.
      Parameters:
      referent - the referent
      attachment - the attachment

    • WeakReference

      public WeakReference(T referent, A attachment, ReferenceQueue<? super T> q)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Construct a new instance with an explicit reference queue.
      Parameters:
      referent - the referent
      attachment - the attachment
      q - the reference queue to use

    • WeakReference

      public WeakReference(T referent, A attachment, Reaper<T,A> reaper)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Construct a new instance with a reaper.
      Parameters:
      referent - the referent
      attachment - the attachment
      reaper - the reaper to use

  • Method Details

    • getAttachment

      public A getAttachment()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Reference
      Get the attachment, if any.
      Specified by:
      getAttachment in interface Reference<T,A>
      Returns:
      the attachment

    • getType

      public Reference.Type getType()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Reference
      Get the type of the reference.
      Specified by:
      getType in interface Reference<T,A>
      Returns:
      the type

    • getReaper

      public Reaper<T,A> getReaper()
      Deprecated, for removal: This API element is subject to removal in a future version.

    • toString

      public String toString()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Overrides:
      toString in class Object