CKTIS / Java
AutoCloseable — cierre de recursos
java.lang.AutoCloseable define un contrato para cerrar recursos mediante close(). Con try-with-resources, Java llama a este método al salir del bloque, también si se produce una excepción, y cierra varios recursos en orden inverso.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
public interface AutoCloseable {
void close() throws Exception;
}
try (Resource resource = new Resource()) {
// Use resource.
}java.lang.AutoCloseable es una interfaz para objetos que pueden contener recursos que haya que liberar, como los descriptores de archivos. Escribir implements AutoCloseable por sí solo no inicia el cierre: el objeto debe gestionarse con try-with-resources o cerrarse explícitamente.
AutoCloseable.close tiene la firma void close() throws Exception. La implementación debe ser public y puede declarar una excepción más específica o no declarar ninguna. A diferencia de java.io.Closeable, cuyo close() declara IOException, AutoCloseable no exige idempotencia: cerrar de nuevo puede tener efectos secundarios. Aun así, se recomienda la idempotencia.
try-with-resources cierra los recursos no nulos que se hayan inicializado correctamente en orden inverso al de su declaración, también al salir mediante return o por una excepción. Si tanto el bloque como close() lanzan una excepción, la llamada generada a addSuppressed intenta añadir la excepción del cierre a la excepción principal. Si ambos lanzan la misma instancia de Throwable, esa llamada lanza IllegalArgumentException, incluso si la supresión está desactivada. Si las instancias son distintas y la supresión está activada, el array que devuelve getSuppressed() en la excepción principal contiene la excepción del cierre. Si la supresión está desactivada, la excepción del cierre no se añade y getSuppressed() devuelve un array vacío.
El ejemplo simula dos recursos sin acceder a archivos ni a la red. Primero imprime work, seguido de close second y close first. La implementación de Resource.close() no declara excepciones, así que main no necesita gestionar una excepción comprobada de cierre.
Ejemplos
public class Main {
static final class Resource implements AutoCloseable {
private final String name;
Resource(String name) {
this.name = name;
}
@Override
public void close() {
System.out.println("close " + name);
}
}
public static void main(String[] args) {
try (Resource first = new Resource("first");
Resource second = new Resource("second")) {
System.out.println("work");
}
}
}Resultado
work close second close first
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.