Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Throwable.getSuppressed() — eccezioni soppresse

Invoca `getSuppressed()` sull’eccezione principale per consultare le eccezioni associate, ad esempio un errore di chiusura di una risorsa dopo un errore nel blocco `try`.

Versione: Java SE 21

Sintassi

public final Throwable[] getSuppressed()

getSuppressed() è un metodo di istanza senza argomenti di java.lang.Throwable. Restituisce un array Throwable[] con le eccezioni soppresse associate direttamente all’oggetto su cui lo invochi. Se non ce ne sono o se la soppressione è disabilitata per quell’oggetto, restituisce un array vuoto, non null. Modificare l’array restituito non cambia l’elenco memorizzato.

Se il blocco try lancia un’eccezione e la chiamata automatica a close() ne lancia un’altra, il try con risorse propaga l’eccezione del blocco e, se la soppressione è abilitata, le associa quella di close(). Invoca getSuppressed() sull’eccezione principale intercettata, non su quella di close(): quest’ultima non sopprime se stessa.

Se il blocco termina normalmente e una sola chiusura lancia un’eccezione, questa viene propagata come eccezione principale. Le risorse si chiudono in ordine inverso rispetto all’inizializzazione. Se più chiusure lanciano eccezioni distinte dopo la conclusione normale del blocco, la prima in ordine di chiusura è quella principale e le altre le vengono associate se la soppressione è abilitata.

getCause() restituisce la causa dell’eccezione (o null), non un array di errori aggiuntivi. Lo stesso oggetto può avere sia una causa sia eccezioni soppresse.

Esempi

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

Risultato

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

Le prime tre righe mostrano l’eccezione principale e un’eccezione di `close()` a essa associata. L’ultima riga mostra che, in questo esempio, l’eccezione di `close()` non ha eccezioni soppresse proprie.

Lezioni correlate

  • Java · Lezione 31 · Intermedio · Versione: 2

Fonti