Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Cleaner — pulizia esplicita e di ripiego

Cleaner registra un’azione di pulizia. Invocala esplicitamente tramite Cleanable.clean(); l’esecuzione automatica è un meccanismo di ripiego.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

Cleaner cleaner = Cleaner.create();
Cleaner.Cleanable cleanable = cleaner.register(owner, action);
cleanable.clean();

Cleaner di java.lang.ref gestisce le azioni di pulizia. Cleaner.create() crea un’istanza con un thread demone. Cleaner.register(owner, action) associa un oggetto a un’azione Runnable e restituisce un Cleaner.Cleanable.

Cleaner.Cleanable.clean() annulla la registrazione dell’azione e la invoca. L’azione viene eseguita al massimo una volta, indipendentemente dal numero di chiamate a clean(). Preferisci la chiusura esplicita, ad esempio tramite AutoCloseable e try-with-resources.

La pulizia automatica avviene dopo la notifica che l’oggetto è raggiungibile tramite un riferimento fantasma; non fare affidamento né sui tempi né sull’esecuzione durante System.exit. L’azione non deve conservare un riferimento al proprietario: usa una classe annidata statica invece di una lambda che cattura this. Le azioni dovrebbero essere brevi, non bloccanti e preparate a essere eseguite contemporaneamente ad altre azioni.

Esempi

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();
        }
    }
}

Risultato

Working
Cleanup

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti