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

CKTIS / Java

Throwable.getSuppressed() — excepciones suprimidas

Llama a `getSuppressed()` sobre la excepción principal para consultar las excepciones adjuntas, como un fallo al cerrar un recurso después de un fallo en el bloque `try`.

Versión: Java SE 21

Sintaxis

public final Throwable[] getSuppressed()

getSuppressed() es un método de instancia sin argumentos de java.lang.Throwable. Devuelve un array Throwable[] con las excepciones suprimidas adjuntas directamente al objeto sobre el que se invoca. Si no hay ninguna o la supresión está desactivada para ese objeto, devuelve un array vacío, no null. Modificar el array devuelto no cambia la lista almacenada.

Si el bloque try lanza una excepción y la llamada automática a close() lanza otra distinta, el try con recursos propaga la excepción del bloque y, si la supresión está habilitada, le adjunta la de close(). Llama a getSuppressed() sobre la excepción principal capturada, no sobre la de close(): esta no se suprime a sí misma.

Si el bloque termina normalmente y solo un cierre lanza una excepción, esa excepción se propaga como principal. Los recursos se cierran en orden inverso al de su inicialización. Si varios cierres lanzan excepciones distintas tras la finalización normal del bloque, la primera en orden de cierre es la principal y las demás se le adjuntan si la supresión está habilitada.

getCause() devuelve la causa de la excepción (o null), no un array de fallos adicionales. Un mismo objeto puede tener tanto una causa como excepciones suprimidas.

Ejemplos

public class Main {
    public static void main(String[] args) {
        try (AutoCloseable resource = () -> {
            throw new IllegalStateException("close failed");
        }) {
            throw new IllegalStateException("body failed");
        } catch (Exception primary) {
            System.out.println("Primary: " + primary.getMessage());
            Throwable[] suppressed = primary.getSuppressed();
            System.out.println("Suppressed count: " + suppressed.length);
            for (Throwable secondary : suppressed) {
                System.out.println("Suppressed: " + secondary.getMessage());
                System.out.println("Its suppressed count: " + secondary.getSuppressed().length);
            }
        }
    }
}

Resultado

Primary: body failed
Suppressed count: 1
Suppressed: close failed
Its suppressed count: 0

Las tres primeras líneas muestran la excepción principal y una excepción adjunta de `close()`. La última línea muestra que la excepción de `close()` no tiene excepciones suprimidas propias en este ejemplo.

Lecciones relacionadas

  • Java · Lección 31 · Intermedio · Versión: 2

Fuentes