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

CKTIS / Java

try-with-resources — cierre automático de recursos

La instrucción try-with-resources llama automáticamente a close() en los recursos AutoCloseable. Define durante cuánto tiempo se usan y cómo se gestionan las excepciones de cierre.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

try (Resource r = expression) {
    // use r
}

En try (Resource r = ...), Resource designa el tipo declarado del recurso, que debe ser un subtipo de AutoCloseable. El propio tipo AutoCloseable cumple este requisito. Los puntos suspensivos ... representan una expresión de inicialización. Al salir del bloque, incluso mediante return o una excepción, Java llama a close() en el recurso si no es null.

Separa los recursos con punto y coma. La inicialización se realiza de izquierda a derecha y el cierre, en orden inverso. Si falla una inicialización, se cierran los recursos inicializados previamente. Si falla un close(), no se omiten los demás intentos de cierre.

Una variable declarada en la cabecera es implícitamente final. También puedes usar try (r) si la variable existente se ha asignado previamente y es final o efectivamente final, es decir, no se vuelve a asignar.

Si el bloque lanza una excepción, esta pasa a ser la excepción principal. Si close() lanza un objeto de excepción distinto, addSuppressed() lo registra como excepción suprimida, accesible mediante getSuppressed(), solo si la supresión está habilitada en la excepción principal. Si está deshabilitada, la excepción de cierre distinta no se registra. Si close() lanza el mismo objeto de excepción que el bloque, addSuppressed() rechaza el intento de añadir la excepción a sí misma y lanza IllegalArgumentException, incluso si la supresión está deshabilitada. Esa IllegalArgumentException puede propagarse en lugar de la excepción original. Si no hay una excepción anterior, la primera excepción de cierre pasa a ser la principal. Las cláusulas opcionales catch y finally se ejecutan después de los intentos de cierre; catch también puede gestionar errores de inicialización y 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 a = new Resource("A");
             Resource b = new Resource("B")) {
            System.out.println("work");
        }
    }
}

Resultado

work
close B
close A

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