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.