Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Získanie potlačených výnimiek pomocou getSuppressed()

Metódou `getSuppressed()` získaš vedľajšie výnimky zaznamenané pri hlavnej výnimke, napríklad keď zlyhá kód v bloku `try` aj automatické zatvorenie prostriedku.

Verzia: Java SE 21

Syntax

public final Throwable[] getSuppressed()

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

Throwable.getSuppressed() je inštančná metóda triedy java.lang.Throwable, ktorá neprijíma žiadne argumenty a je dostupná od Javy 7. Zavolaj ju na zachytenej výnimke. Vráti pole Throwable[] s potlačenými výnimkami zaznamenanými priamo pri tomto objekte.

Príkaz try-with-resources zatvára prostriedok automaticky. Ak blok try a metóda close() vyvolajú výnimky, ktoré sú rôznymi objektmi, výnimka z bloku zostane hlavná. Výnimka zo zatvárania sa pri nej zaznamená ako potlačená, ak je potláčanie povolené. Ak blok aj metóda vyvolajú tú istú inštanciu Throwable, vygenerované volanie addSuppressed() sa pokúsi pridať výnimku do jej vlastného zoznamu potlačených výnimiek a namiesto toho vyvolá IllegalArgumentException. Ak sa blok skončí normálne a výnimku vyvolá iba close(), hlavnou výnimkou je tá zo zatvárania.

Ak nie sú zaznamenané žiadne potlačené výnimky alebo je pre daný objekt potláčanie vypnuté, metóda vráti prázdne pole, nikdy null. Metódu možno bezpečne volať z viacerých vlákien. Nahradenie prvkov vráteného poľa nezmení výsledky ďalších volaní.

Nezamieňaj tento výsledok s výsledkom getCause(). Táto metóda vráti príčinu alebo null, ak príčina neexistuje alebo nie je známa. Výnimka môže mať zároveň príčinu aj potlačené výnimky.

Príklady

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

Výsledok

Primary: work failed
Suppressed: close failed

Blok `catch` zachytí `work failed`. Cyklus načíta jedinú potlačenú výnimku `close failed`, takže program vypíše obe správy.

Súvisiace lekcie

  • Java · Lekcia 52 · Základná · Verzia: 2

Zdroje