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.