WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Cleaner — explizite und ausfallsichere Bereinigung

Cleaner registriert eine Bereinigungsaktion. Rufen Sie sie explizit über Cleanable.clean() auf; die automatische Ausführung ist ein Mechanismus für den Notfall.

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

Syntax

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

Cleaner aus java.lang.ref verwaltet Bereinigungsaktionen. Cleaner.create() erstellt eine Instanz mit einem Daemon-Thread. Cleaner.register(owner, action) verknüpft ein Objekt mit einer Runnable-Aktion und gibt ein Cleaner.Cleanable zurück.

Cleaner.Cleanable.clean() hebt die Registrierung der Aktion auf und führt sie aus. Die Aktion wird höchstens einmal ausgeführt, unabhängig davon, wie oft clean() aufgerufen wird. Bevorzugen Sie explizites Schließen, zum Beispiel mit AutoCloseable und try-with-resources.

Die automatische Bereinigung erfolgt, nachdem eine Benachrichtigung eingegangen ist, dass das Objekt phantom-erreichbar ist. Verlassen Sie sich weder auf den Zeitpunkt noch auf eine Ausführung bei System.exit. Die Aktion darf keine Referenz auf ihren Besitzer enthalten: Verwenden Sie eine statische verschachtelte Klasse statt einer Lambda-Funktion, die this erfasst. Aktionen sollten kurz und nicht blockierend sein und darauf vorbereitet, gleichzeitig mit anderen Aktionen zu laufen.

Beispiele

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

Ergebnis

Working
Cleanup

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen