CKTIS / Java
ReferenceQueue — recevoir des objets de référence
ReferenceQueue permet de récupérer des objets de référence enregistrés après leur ajout par le ramasse-miettes ou par un appel explicite à enqueue(). Découvrez la différence entre poll(), non bloquant, et les variantes bloquantes de remove().
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
ReferenceQueue<T> queue = new ReferenceQueue<>();
Reference<? extends T> ready = queue.poll();
Reference<? extends T> next = queue.remove();
Reference<? extends T> timed = queue.remove(timeoutMillis);ReferenceQueue<T> du package java.lang.ref reçoit des objets de référence, et non les objets auxquels ils font référence. Une référence est enregistrée auprès d’une file lors de sa création. Le ramasse-miettes l’ajoute après avoir détecté le changement approprié dans l’accessibilité de son référent. L’enregistrement, à lui seul, ne maintient pas l’objet de référence en vie : l’application doit le garder accessible tant que la notification est nécessaire.
ReferenceQueue.poll() retire et renvoie une référence disponible, ou renvoie immédiatement null. ReferenceQueue.remove() attend indéfiniment un élément. La variante remove(long timeout) attend au plus le nombre de millisecondes indiqué et peut renvoyer null ; 0 signifie une attente indéfinie, et une valeur négative provoque IllegalArgumentException. Les deux variantes de remove peuvent lancer InterruptedException. Le délai ne garantit pas un comportement temps réel. Ces méthodes renvoient Reference<? extends T>.
L’exemple utilise une WeakReference dont le référent est null et un appel explicite à enqueue() ; il ne dépend donc pas du ramasse-miettes. enqueue() efface toujours la référence. Si elle a déjà été mise en file ou n’a jamais été enregistrée auprès d’une file, enqueue() renvoie false sans l’ajouter. Sinon, la méthode ajoute la référence à la file auprès de laquelle elle est enregistrée et renvoie true. clear() seul ne met pas la référence en file. Dans l’exemple, enqueue() renvoie true : l’appel suivant à remove() n’a donc pas à attendre le GC. Recevoir une référence de la file ne prouve pas, à lui seul, que la mémoire de son référent a été récupérée.
Exemples
import java.lang.ref.ReferenceQueue;
import java.lang.ref.WeakReference;
public class ReferenceQueueDemo {
public static void main(String[] args) throws InterruptedException {
ReferenceQueue<Object> queue = new ReferenceQueue<>();
WeakReference<Object> ref = new WeakReference<>(null, queue);
System.out.println(queue.poll() == null);
System.out.println(ref.enqueue());
System.out.println(queue.remove() == ref);
System.out.println(queue.poll() == null);
}
}Résultat
true true true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.