CKTIS / Java
AutoCloseable.close(): cierre automático de recursos
`close()` libera los recursos de un objeto. Una sentencia try-with-resources lo llama automáticamente, pero la interfaz no exige que una llamada repetida carezca de efecto.
Versión: Java SE 21
Sintaxis
void close() throws Exception;
// In a class implementing AutoCloseable, when closing needs no checked exception:
@Override
public void close() { /* release the resource */ }
// With an already initialized final or effectively final resource variable:
try (resource) {
// use the resource
}AutoCloseable.close es el método sin argumentos de la interfaz java.lang.AutoCloseable. No devuelve ningún valor (void): cierra el objeto y libera los recursos que este gestiona. La declaración throws Exception permite lanzar una excepción comprobada si falla el cierre. La implementación puede declarar un tipo de excepción más específico o no declarar ninguna excepción comprobada. En una llamada manual a través de una referencia de tipo AutoCloseable, hay que capturar o declarar Exception, aunque la implementación concreta no la declare.
Una sentencia try-with-resources invoca close() en los recursos inicializados correctamente que no sean null, en orden inverso al de inicialización. Esto ocurre tanto si el bloque termina normalmente como si lanza una excepción. Si el bloque y close() lanzan instancias distintas de Throwable, la excepción del bloque sigue siendo la principal. Si la supresión está habilitada en esa excepción, la del cierre se adjunta como excepción suprimida y se puede consultar con getSuppressed(). Si el bloque y close() lanzan exactamente la misma instancia de Throwable, la llamada implícita a addSuppressed() intenta adjuntar la excepción a sí misma como excepción suprimida. El método lanza entonces una IllegalArgumentException, que se propaga en lugar de la excepción original. Si el bloque termina normalmente, una excepción del cierre puede propagarse.
Aquí, la idempotencia significa que llamar a close() sobre un recurso ya cerrado no tiene ningún efecto adicional. AutoCloseable lo recomienda, pero no lo exige. En cambio, java.io.Closeable extiende AutoCloseable, exige que una llamada tras el cierre no tenga efecto y declara IOException en vez de Exception. En el ejemplo, MemoryBuffer aporta la idempotencia: el primer cierre elimina la referencia al array y las llamadas siguientes terminan de inmediato. Eliminar la referencia no fuerza la recuperación inmediata de la memoria.
Ejemplos
public class Main {
private static final class MemoryBuffer implements AutoCloseable {
private int[] data = {42};
int read() {
if (data == null) {
throw new IllegalStateException("Buffer is closed");
}
return data[0];
}
@Override
public void close() {
if (data == null) {
return;
}
data = null;
System.out.println("Buffer closed");
}
}
public static void main(String[] args) {
MemoryBuffer buffer = new MemoryBuffer();
try (buffer) {
System.out.println("Value: " + buffer.read());
}
buffer.close();
System.out.println("Done");
}
}Resultado
Value: 42 Buffer closed Done
Como no se reasigna `buffer`, la variable es efectivamente final y puede usarse en `try (buffer)`. El cierre automático imprime `Buffer closed`; la llamada manual posterior a `buffer.close()` no hace nada.
Lecciones relacionadas
- Java · Lección 31 · Intermedio · Versión: 2