Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Cleaner — jawne i awaryjne sprzątanie

Cleaner rejestruje akcję sprzątającą. Wywołuj ją jawnie przez Cleanable.clean(); automatyczne wykonanie jest mechanizmem awaryjnym.

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

Składnia

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

Cleaner z java.lang.ref zarządza akcjami sprzątającymi. Cleaner.create() tworzy instancję z wątkiem demonicznym. Cleaner.register(owner, action) wiąże obiekt z akcją Runnable i zwraca Cleaner.Cleanable.

Cleaner.Cleanable.clean() wyrejestrowuje akcję i ją wywołuje. Akcja wykona się najwyżej raz, niezależnie od liczby wywołań clean(). Preferuj jawne zamykanie, np. przez AutoCloseable i try-with-resources.

Automatyczne sprzątanie następuje po powiadomieniu o osiągalności fantomowej obiektu; nie polegaj na terminie wykonania ani wykonaniu przy System.exit. Akcja nie może przechowywać referencji do właściciela: użyj statycznej klasy zagnieżdżonej zamiast lambdy przechwytującej this. Akcje powinny być krótkie, nieblokujące i przygotowane na współbieżność z innymi akcjami.

Przykłady

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

Wynik

Working
Cleanup

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła