Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Dohvaćanje potisnutih iznimki metodom getSuppressed()

Metodom `getSuppressed()` dohvati dodatne iznimke zabilježene uz glavnu iznimku, primjerice kada i blok `try` i automatsko zatvaranje resursa završe iznimkom.

Verzija: Java SE 21

Sintaksa

public final Throwable[] getSuppressed()

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

Throwable.getSuppressed() instancijska je metoda klase java.lang.Throwable koja ne prima argumente i dostupna je od Jave 7. Pozovi je na uhvaćenoj iznimci. Vratit će polje Throwable[] s potisnutim iznimkama zabilježenima izravno uz taj objekt.

Naredba try-with-resources automatski zatvara resurs. Ako blok try i close() bace iznimke koje su različiti objekti, iznimka iz bloka ostaje glavna. Iznimka pri zatvaranju bilježi se uz nju kao potisnuta ako je potiskivanje omogućeno. Ako oba bace istu instancu klase Throwable, generirani poziv metode addSuppressed() pokuša dodati iznimku na njezin vlastiti popis potisnutih iznimki i umjesto toga baci IllegalArgumentException. Ako blok završi normalno i samo close() baci iznimku, iznimka pri zatvaranju postaje glavna.

Ako nema zabilježenih potisnutih iznimki ili je potiskivanje za taj objekt onemogućeno, metoda vraća prazno polje, nikada null. Metodu može sigurno pozivati više dretvi. Zamjena elemenata u vraćenom polju ne mijenja rezultate kasnijih poziva.

Nemoj brkati taj rezultat s rezultatom metode getCause(), koja vraća uzrok ili null ako uzrok ne postoji ili nije poznat. Iznimka može imati i uzrok i potisnute iznimke.

Primjeri

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

Rezultat

Primary: work failed
Suppressed: close failed

Blok `catch` hvata `work failed`. Petlja dohvaća jednu potisnutu iznimku, `close failed`, pa program ispisuje obje poruke.

Povezane lekcije

  • Java · Lekcija 52 · Osnovno · Verzija: 2

Izvori