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

CKTIS / Java

AutoCloseable.close(): cierre explícito y automático de recursos

`AutoCloseable.close()` libera un recurso. Puedes llamar al método sobre el objeto o dejar que `try-with-resources` lo invoque al salir del bloque.

Versión: Java SE 21

Sintaxis

void close() throws Exception;

resource.close();

try (AutoCloseable resource = acquireResource()) {
    // Use the resource here.
} catch (Exception e) {
    // Handle the exception.
}

En Java SE 21, AutoCloseable.close y AutoCloseable.close() nombran el mismo método de instancia de java.lang.AutoCloseable. No recibe argumentos ni devuelve ningún valor (void). Para liberar un recurso de forma explícita, llama al método sobre el objeto: resource.close().

Usa try-with-resources cuando un recurso deba cerrarse al salir de un bloque. Java intenta cerrar los recursos que se inicializaron correctamente y no son null en orden inverso al de inicialización, incluso si el bloque lanza una excepción o falla la inicialización de un recurso posterior. No cierres manualmente un recurso que vaya a cerrar la misma sentencia: AutoCloseable no garantiza la idempotencia. En cambio, java.io.Closeable.close() no tiene efecto sobre un recurso ya cerrado.

La interfaz declara throws Exception, pero una implementación puede declarar una excepción comprobada más específica o no declarar ninguna. Para las llamadas explícitas y automáticas, captura o declara las excepciones comprobadas según el tipo del recurso en tiempo de compilación. Si tanto el bloque como el cierre lanzan una excepción, la del bloque normalmente queda como principal. La excepción del cierre solo puede registrarse como suprimida y recuperarse mediante getSuppressed() si la supresión está habilitada en la excepción principal. Si no hay una excepción previa, se propaga la del cierre.

Ejemplos

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class Main {
    private static final class Subscription implements AutoCloseable {
        private final List<Subscription> active;
        private final boolean failOnClose;

        Subscription(List<Subscription> active, boolean failOnClose) {
            this.active = active;
            this.failOnClose = failOnClose;
            active.add(this);
        }

        @Override
        public void close() throws IOException {
            if (active.remove(this) && failOnClose) {
                throw new IOException("simulated close failure");
            }
        }
    }

    public static void main(String[] args) {
        List<Subscription> active = new ArrayList<>();

        try (Subscription temporary = new Subscription(active, true)) {
            Subscription manual = new Subscription(active, false);
            System.out.println("Active before manual close: " + active.size());
            manual.close();
            System.out.println("Active after manual close: " + active.size());
        } catch (IOException e) {
            System.out.println("Caught: " + e.getMessage());
        }

        System.out.println("Active after try: " + active.size());
    }
}

Resultado

Active before manual close: 2
Active after manual close: 1
Caught: simulated close failure
Active after try: 0

`Subscription` es una clase del ejemplo, no parte de la API estándar. `manual.close()` elimina una sola suscripción. El cierre automático elimina la suscripción temporal y luego lanza una `IOException` simulada que captura el bloque `catch`.

Lecciones relacionadas

  • Java · Lección 47 · Avanzado · Versión: 2
  • Java · Lección 52 · Básico · Versión: 2

Fuentes