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

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.

Fontes