Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources