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

CKTIS / Java

Consultar las excepciones suprimidas con getSuppressed()

Usa `getSuppressed()` para consultar las excepciones secundarias registradas en una excepción principal, por ejemplo, si fallan tanto el bloque `try` como el cierre automático de un recurso.

Versión: Java SE 21

Sintaxis

public final Throwable[] getSuppressed()

// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();

Throwable.getSuppressed() es un método de instancia sin argumentos de java.lang.Throwable, disponible desde Java 7. Llámalo sobre la excepción capturada para obtener un array Throwable[] con las excepciones suprimidas registradas directamente en ese objeto.

Una sentencia try-with-resources cierra el recurso de forma automática. Si el bloque try y close() lanzan objetos de excepción distintos, la del bloque sigue siendo la principal y la del cierre se registra en ella como suprimida si la supresión está habilitada. Si ambos lanzan la misma instancia de Throwable, la llamada generada a addSuppressed() intenta añadir la excepción a su propia lista de excepciones suprimidas y lanza en su lugar una IllegalArgumentException. Si el bloque termina normalmente y solo close() lanza una excepción, la del cierre es la principal.

Si no se registraron excepciones suprimidas o la supresión está deshabilitada para ese objeto, el método devuelve un array vacío, nunca null. El método es seguro para el uso concurrente: cambiar los elementos del array devuelto no altera los resultados de llamadas posteriores.

No confundas este resultado con el de getCause(), que devuelve la causa o null si no existe o se desconoce. Una excepción puede tener tanto una causa como excepciones suprimidas.

Ejemplos

import java.io.IOException;

public class Main {
    static class DemoResource implements AutoCloseable {
        @Override
        public void close() throws IOException {
            throw new IOException("close failed");
        }
    }

    public static void main(String[] args) {
        try (DemoResource resource = new DemoResource()) {
            throw new IOException("work failed");
        } catch (IOException failure) {
            System.out.println("Primary: " + failure.getMessage());
            for (Throwable suppressed : failure.getSuppressed()) {
                System.out.println("Suppressed: " + suppressed.getMessage());
            }
        }
    }
}

Resultado

Primary: work failed
Suppressed: close failed

El bloque `catch` captura `work failed`. El bucle lee una única excepción suprimida, `close failed`, por lo que el programa imprime ambos mensajes.

Lecciones relacionadas

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

Fuentes