CKTIS / Java
Cleaner — nettoyage explicite et de secours
Cleaner enregistre une action de nettoyage. Appelez-la explicitement avec Cleanable.clean() ; l’exécution automatique est un mécanisme de secours.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
Cleaner cleaner = Cleaner.create();
Cleaner.Cleanable cleanable = cleaner.register(owner, action);
cleanable.clean();Cleaner de java.lang.ref gère des actions de nettoyage. Cleaner.create() crée une instance dotée d’un thread démon. Cleaner.register(owner, action) associe un objet à une action Runnable et renvoie un Cleaner.Cleanable.
Cleaner.Cleanable.clean() désenregistre l’action et l’exécute. L’action s’exécute au plus une fois, quel que soit le nombre d’appels à clean(). Préférez une fermeture explicite, par exemple avec AutoCloseable et try-with-resources.
Le nettoyage automatique a lieu après la notification que l’objet est devenu accessible par référence fantôme ; ne comptez ni sur le moment de son exécution ni sur son exécution lors de System.exit. L’action ne doit pas conserver de référence vers son propriétaire : utilisez une classe imbriquée statique plutôt qu’une lambda qui capture this. Les actions doivent être courtes, non bloquantes et conçues pour pouvoir s’exécuter en parallèle avec d’autres actions.
Exemples
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();
}
}
}
Résultat
Working Cleanup
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.