Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes