CKTIS / Java
Cleaner — limpeza explícita e limpeza de último recurso
Cleaner regista uma ação de limpeza. Invoque-a explicitamente através de Cleanable.clean(); a execução automática é um mecanismo de último recurso.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Cleaner cleaner = Cleaner.create();
Cleaner.Cleanable cleanable = cleaner.register(owner, action);
cleanable.clean();Cleaner de java.lang.ref gere ações de limpeza. Cleaner.create() cria uma instância com uma thread daemon. Cleaner.register(owner, action) associa um objeto a uma ação Runnable e devolve um Cleaner.Cleanable.
Cleaner.Cleanable.clean() anula o registo da ação e invoca-a. A ação é executada, no máximo, uma vez, independentemente do número de chamadas a clean(). Prefira o fecho explícito, por exemplo através de AutoCloseable e try-with-resources.
Como último recurso, a limpeza automática ocorre após a notificação de que o objeto está acessível por referência fantasma; não dependa do momento em que ocorre nem da sua execução durante System.exit. A ação não pode manter uma referência para o proprietário: utilize uma classe aninhada estática em vez de uma lambda que capture this. As ações devem ser curtas, não bloqueantes e estar preparadas para serem executadas em simultâneo com outras ações.
Exemplos
import java.lang.ref.Cleaner;
public class CleanerDemo implements AutoCloseable {
private static final Cleaner CLEANER = Cleaner.create();
private static final class State implements Runnable {
@Override
public void run() {
System.out.println("Cleanup");
}
}
private final Cleaner.Cleanable cleanable =
CLEANER.register(this, new State());
@Override
public void close() {
cleanable.clean();
}
public static void main(String[] args) {
try (CleanerDemo demo = new CleanerDemo()) {
System.out.println("Working");
demo.close();
demo.close();
}
}
}
Resultado
Working Cleanup
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.