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