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

CKTIS / Java

Reference.reachabilityFence — preservar a acessibilidade forte

Reference.reachabilityFence(ref) mantém um objeto fortemente acessível pelo menos até a chamada terminar. É útil quando a recuperação prematura poderia interferir com uma operação.

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

Sintaxe

public static void reachabilityFence(Object ref)

Reference.reachabilityFence(ref) de java.lang.ref.Reference, disponível desde Java 9, impede que o GC recupere o objeto referenciado pelo menos até a chamada terminar. Se o argumento for null, não tem efeito; a chamada não inicia o GC nem a finalização.

O âmbito de uma variável não determina o tempo de vida do objeto. A JVM pode considerar um objeto desnecessário depois da sua última utilização, mesmo durante a execução de um dos seus métodos, se os cálculos seguintes usarem valores de campos carregados anteriormente. Isto é relevante quando uma finalização prematura liberta um recurso externo ainda em utilização.

Coloque a chamada depois da operação protegida, normalmente em finally, para abranger também os percursos com exceções. Controla a acessibilidade; não é um bloqueio de exclusão mútua nem substitui o fecho explícito dos recursos.

O exemplo mostra esta localização e imprime 42. Não gere recursos externos, pelo que a barreira não é necessária para a sua correção; também não prova que tenha ocorrido ou sido evitada uma condição de corrida com o GC.

Exemplos

import java.lang.ref.Reference;

public class FenceDemo {
    private final int value = 42;

    int read() {
        try {
            int snapshot = value;
            return process(snapshot);
        } finally {
            Reference.reachabilityFence(this);
        }
    }

    private static int process(int snapshot) {
        return snapshot;
    }

    public static void main(String[] args) {
        System.out.println(new FenceDemo().read());
    }
}

Resultado

42

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