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

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.

Fuentes