CKTIS / Java
Cleaner — expliciete en terugvalopruiming
Cleaner registreert een opruimactie. Roep deze expliciet aan via Cleanable.clean(); automatische uitvoering is een terugvalmechanisme.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Cleaner cleaner = Cleaner.create();
Cleaner.Cleanable cleanable = cleaner.register(owner, action);
cleanable.clean();Cleaner uit java.lang.ref beheert opruimacties. Cleaner.create() maakt een instantie met een daemonthread. Cleaner.register(owner, action) koppelt een object aan een Runnable-actie en retourneert een Cleaner.Cleanable.
Cleaner.Cleanable.clean() verwijdert de registratie van de actie en roept deze aan. De actie wordt hoogstens één keer uitgevoerd, ongeacht het aantal aanroepen van clean(). Geef de voorkeur aan expliciet sluiten, bijvoorbeeld met AutoCloseable en try-with-resources.
Automatische opruiming vindt plaats nadat is gemeld dat het object phantom-reachable is; vertrouw niet op het tijdstip of op uitvoering tijdens System.exit. De actie mag geen verwijzing naar de eigenaar vasthouden: gebruik een statische geneste klasse in plaats van een lambda die this vastlegt. Acties moeten kort en niet-blokkerend zijn en voorbereid zijn om gelijktijdig met andere acties uit te voeren.
Voorbeelden
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();
}
}
}
Resultaat
Working Cleanup
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.