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.