CKTIS / Java
ReferenceQueue — receber objetos de referência
ReferenceQueue permite obter objetos de referência registados depois de estes serem adicionados pelo garbage collector ou por uma chamada explícita a enqueue(). Saiba distinguir poll(), que não bloqueia, das variantes bloqueantes de remove().
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
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> do pacote java.lang.ref recebe objetos de referência, não os objetos para os quais estes apontam. Uma referência é registada numa fila quando é criada. O garbage collector adiciona-a depois de detetar a alteração adequada na acessibilidade do objeto referenciado. O registo, por si só, não mantém o objeto de referência vivo: a aplicação tem de o manter acessível enquanto a notificação for necessária.
ReferenceQueue.poll() remove e devolve uma referência disponível ou devolve imediatamente null. ReferenceQueue.remove() espera indefinidamente por um elemento. A variante remove(long timeout) espera até ao número de milissegundos especificado e pode devolver null; 0 significa espera indefinida e um valor negativo provoca IllegalArgumentException. Ambas as variantes de remove podem lançar InterruptedException. O tempo limite não oferece garantias de tempo real. Estes métodos devolvem Reference<? extends T>.
O exemplo utiliza uma WeakReference com um objeto referenciado null e uma chamada explícita a enqueue(), pelo que não depende do garbage collector. enqueue() limpa sempre a referência. Se a referência já tiver sido inserida na fila ou nunca tiver sido registada numa fila, enqueue() devolve false sem a inserir. Caso contrário, adiciona-a à fila em que está registada e devolve true. clear() por si só não insere a referência na fila. No exemplo, enqueue() devolve true, pelo que a chamada seguinte a remove() não precisa de esperar pelo GC. Receber uma referência da fila não prova, por si só, que a memória do objeto referenciado tenha sido libertada.
Exemplos
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);
}
}Resultado
true true true true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.