java.lang.ref

Class ReferenceQueue<T>


  • public class ReferenceQueue<T>
    extends Object
    Reference queues, to which registered reference objects are appended by the garbage collector after the appropriate reachability changes are detected.
    Since:
    1.2
    • Constructor Summary

      Constructors 
      Constructor and Description
      ReferenceQueue()
      Constructs a new reference-object queue.

        

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      Reference<? extends T> poll()
      Polls this queue to see if a reference object is available.
      Reference<? extends T> remove()
      Removes the next reference object in this queue, blocking until one becomes available.
      Reference<? extends T> remove(long timeout)
      Removes the next reference object in this queue, blocking until either one becomes available or the given timeout period expires.

        

    • Constructor Detail

      • ReferenceQueue

        public ReferenceQueue()
        Constructs a new reference-object queue.
    • Method Detail

      • poll

        public Reference<? extends T> poll()
        Polls this queue to see if a reference object is available. If one is available without further delay then it is removed from the queue and returned. Otherwise this method immediately returns null.
        Returns:
        A reference object, if one was immediately available, otherwise null
      • remove

        public Reference<? extends T> remove(long timeout)
                                      throws IllegalArgumentException,
                                             InterruptedException
        Removes the next reference object in this queue, blocking until either one becomes available or the given timeout period expires.

        This method does not offer real-time guarantees: It schedules the timeout as if by invoking the Object.wait(long) method.

        Parameters:
        timeout - If positive, block for up to timeout milliseconds while waiting for a reference to be added to this queue. If zero, block indefinitely.
        Returns:
        A reference object, if one was available within the specified timeout period, otherwise null
        Throws:
        IllegalArgumentException - If the value of the timeout argument is negative
        InterruptedException - If the timeout wait is interrupted
      • remove

        public Reference<? extends T> remove()
                                      throws InterruptedException
        Removes the next reference object in this queue, blocking until one becomes available.
        Returns:
        A reference object, blocking until one becomes available
        Throws:
        InterruptedException - If the wait is interrupted

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Document créé le 30/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/lang/ref/ReferenceQueue.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, ReferenceQueue

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut