Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Leggere le eccezioni soppresse con getSuppressed()

Usa `getSuppressed()` per leggere le eccezioni secondarie registrate su un’eccezione principale, ad esempio quando falliscono sia il blocco `try` sia la chiusura automatica della risorsa.

Versione: Java SE 21

Sintassi

public final Throwable[] getSuppressed()

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

Throwable.getSuppressed() è un metodo di istanza senza argomenti di java.lang.Throwable, disponibile da Java 7. Chiamalo sull’eccezione intercettata per ottenere un array Throwable[] con le eccezioni soppresse registrate direttamente su quell’oggetto.

Un’istruzione try-with-resources chiude automaticamente la risorsa. Se il blocco try e close() lanciano due oggetti eccezione distinti, l’eccezione del blocco resta quella principale. L’eccezione di chiusura viene registrata su quella principale come soppressa, se la soppressione è abilitata. Se entrambi lanciano la stessa istanza di Throwable, la chiamata generata a addSuppressed() tenta di aggiungere l’eccezione al proprio elenco di eccezioni soppresse e lancia invece una IllegalArgumentException. Se il blocco termina normalmente e solo close() lancia un’eccezione, quella di chiusura è l’eccezione principale.

Se non sono state registrate eccezioni soppresse o la soppressione è disabilitata per quell’oggetto, il metodo restituisce un array vuoto, mai null. Il metodo è thread-safe: sostituire gli elementi nell’array restituito non cambia i risultati delle chiamate successive.

Non confondere questo risultato con quello di getCause(), che restituisce la causa oppure null se è assente o sconosciuta. Un’eccezione può avere sia una causa sia eccezioni soppresse.

Esempi

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());
            }
        }
    }
}

Risultato

Primary: work failed
Suppressed: close failed

Il blocco `catch` intercetta `work failed`. Il ciclo legge una sola eccezione soppressa, `close failed`, quindi il programma stampa entrambi i messaggi.

Lezioni correlate

  • Java · Lezione 52 · Base · Versione: 2

Fonti