Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Cleaner: limpieza explícita y de respaldo

Cleaner registra una acción de limpieza. Invócala explícitamente mediante Cleanable.clean(); la ejecución automática es un mecanismo de respaldo.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

Cleaner de java.lang.ref gestiona acciones de limpieza. Cleaner.create() crea una instancia con un hilo daemon. Cleaner.register(owner, action) asocia un objeto con una acción Runnable y devuelve un Cleaner.Cleanable.

Cleaner.Cleanable.clean() anula el registro de la acción y la invoca. La acción se ejecuta como máximo una vez, independientemente del número de llamadas a clean(). Es preferible cerrar explícitamente, por ejemplo mediante AutoCloseable y try-with-resources.

La limpieza automática se produce tras recibir la notificación de que el objeto es alcanzable solo por referencia fantasma; no dependas del momento en que se ejecute ni de que lo haga durante System.exit. La acción no debe conservar una referencia a su propietario: utiliza una clase anidada estática en lugar de una lambda que capture this. Las acciones deben ser breves, no bloqueantes y estar preparadas para ejecutarse en paralelo con otras acciones.

Ejemplos

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

Resultado

Working
Cleanup

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes