Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Branje potlačenih izjem z getSuppressed()

Z metodo `getSuppressed()` prebereš dodatne izjeme, zabeležene pri glavni izjemi, na primer ko spodletita tako izvajanje bloka `try` kot samodejno zapiranje vira.

Različica: Java SE 21

Sintaksa

public final Throwable[] getSuppressed()

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

Throwable.getSuppressed() je metoda primerka razreda java.lang.Throwable, ki ne sprejme argumentov in je na voljo od Jave 7. Pokliči jo na prestreženi izjemi. Vrne polje Throwable[] s potlačenimi izjemami, zabeleženimi neposredno pri tem objektu.

Stavek try-with-resources samodejno zapre vir. Če blok try in metoda close() sprožita izjemi, ki sta različna objekta, ostane izjema iz bloka glavna. Izjema pri zapiranju se pri njej zabeleži kot potlačena, če je potlačevanje omogočeno. Če oba sprožita isti primerek Throwable, generirani klic addSuppressed() poskusi dodati izjemo na njen lastni seznam potlačenih izjem in namesto tega sproži IllegalArgumentException. Če se blok konča normalno in izjemo sproži samo close(), je glavna izjema tista pri zapiranju.

Če ni zabeleženih potlačenih izjem ali je potlačevanje za ta objekt onemogočeno, metoda vrne prazno polje, nikoli null. Metodo lahko varno kliče več niti. Zamenjava elementov v vrnjenem polju ne spremeni rezultatov poznejših klicev.

Tega rezultata ne zamenjuj z rezultatom metode getCause(), ki vrne vzrok ali null, če vzroka ni ali ni znan. Izjema ima lahko hkrati vzrok in potlačene izjeme.

Primeri

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` prestreže `work failed`. Zanka prebere edino potlačeno izjemo, `close failed`, zato program izpiše obe sporočili.

Povezane lekcije

  • Java · Lekcija 52 · Osnovna · Različica: 2

Viri