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

CKTIS / Java

Reference: get(), clear() e reachabilityFence()

Reference disponibiliza operações sobre objetos de referência. Aprenda a obter o referente, limpar uma referência e manter a acessibilidade forte em Java SE 21.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

T value = ref.get();
ref.clear();
Reference.reachabilityFence(owner);

java.lang.ref.Reference<T> é a classe base abstrata dos objetos de referência; utilize subclasses como WeakReference, em vez de a estender diretamente.

Numa WeakReference, Reference.get (ref.get()) devolve uma referência forte para o referente se este ainda estiver disponível, ou null caso contrário. Em Java SE 21, PhantomReference.get() devolve sempre null, mesmo antes de a referência ser limpa. Reference.clear (ref.clear()) limpa a referência sem a adicionar a uma fila.

Reference.reachabilityFence(owner) mantém owner fortemente acessível pelo menos até ao fim da chamada; não desencadeia o GC. Coloque-a depois das operações protegidas, num bloco finally, para abranger também as exceções. Passe o referente, não o objeto Reference; passar null não tem efeito.

Exemplos

import java.lang.ref.Reference;
import java.lang.ref.WeakReference;

public class ReferenceDemo {
    public static void main(String[] args) {
        Object owner = new Object();
        Reference<Object> ref = new WeakReference<>(owner);
        try {
            System.out.println(ref.get() == owner);
            ref.clear();
            System.out.println(ref.get() == null);
        } finally {
            Reference.reachabilityFence(owner);
        }
    }
}

Resultado

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