CKTIS / Java
Získání potlačených výjimek pomocí getSuppressed()
Metodou `getSuppressed()` získáš vedlejší výjimky zaznamenané u hlavní výjimky, například když selže jak kód v bloku `try`, tak automatické zavření prostředku.
Verze: Java SE 21
Syntaxe
public final Throwable[] getSuppressed()
// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();Throwable.getSuppressed() je instanční metoda třídy java.lang.Throwable, která nepřijímá žádné argumenty a je dostupná od Javy 7. Zavolej ji u zachycené výjimky. Vrátí pole Throwable[] s potlačenými výjimkami zaznamenanými přímo u tohoto objektu.
Příkaz try-with-resources zavírá prostředek automaticky. Pokud blok try a metoda close() vyvolají výjimky, které jsou různými objekty, výjimka z bloku zůstane hlavní. Výjimka ze zavírání se u ní zaznamená jako potlačená, pokud je potlačování povoleno. Pokud oba vyvolají tutéž instanci Throwable, vygenerované volání addSuppressed() se pokusí přidat výjimku do jejího vlastního seznamu potlačených výjimek a místo toho vyvolá IllegalArgumentException. Pokud blok skončí normálně a výjimku vyvolá pouze close(), je hlavní výjimkou ta ze zavírání.
Pokud nejsou zaznamenány žádné potlačené výjimky nebo je pro daný objekt potlačování vypnuté, metoda vrátí prázdné pole, nikdy null. Metodu lze bezpečně volat z více vláken. Nahrazení prvků vráceného pole nezmění výsledky dalších volání.
Nezaměňuj tento výsledek s výsledkem getCause(). Tato metoda vrátí příčinu nebo null, pokud příčina neexistuje nebo není známá. Výjimka může mít současně příčinu i potlačené výjimky.
Pří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ýsledek
Primary: work failed Suppressed: close failed
Blok `catch` zachytí `work failed`. Smyčka načte jedinou potlačenou výjimku `close failed`, takže program vypíše obě zprávy.
Související lekce
- Java · Lekce 52 · Základní · Verze: 2