Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

throws — deklarování výjimek

Klíčové slovo throws v deklaraci metody nebo konstruktoru určuje typy výjimek, které mohou uniknout z jeho těla. Je důležité zejména u kontrolovaných výjimek: volající kód je musí ošetřit nebo deklarovat jejich další předání.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

throws ExceptionType1, ExceptionType2

throws je vyhrazené klíčové slovo. Klauzule se uvádí za seznamem parametrů metody nebo konstruktoru, před tělem nebo středníkem ukončujícím deklaraci. Typy oddělujte čárkami; každý musí být podtypem Throwable. Povoleny jsou také typové proměnné s odpovídajícími mezemi.

Pokud může z těla uniknout kontrolovaná výjimka, deklarace musí uvádět její typ nebo nadtyp. Volající kód musí takovou výjimku zachytit pomocí try/catch nebo ji deklarovat ve vlastní klauzuli throws. Podtypy RuntimeException a Error jsou nekontrolované: uvést je lze, ale není to povinné.

Nezaměňujte throws a throw: první deklaruje možné předání výjimky, zatímco druhé výjimku skutečně vyhodí. Klauzule throws sama nic nevyhazuje ani neošetřuje a nezaručuje, že výjimka nastane.

Při přepisování metody (JLS §8.4.8.3) musí být každý deklarovaný typ kontrolované výjimky po vymazání typů uveden v klauzuli throws přepisované metody nebo být podtypem některého z typů, které v ní po vymazání zůstaly. Jinak nastane chyba kompilace. Pokud je podmínka splněna až po vymazání typů, překladač vydá varování typu unchecked. Například negenerická metoda void run() throws Exception může přepsat <E extends Exception> void run() throws E s tímto varováním namísto chyby: E se při vymazání typů nahradí typem Exception, ale před vymazáním není Exception podtypem E.

V příkladu check(false) vyhodí kontrolovanou výjimku Exception, kterou main zachytí a vypíše její zprávu. Obecný typ Exception zjednodušuje ukázku; ve skutečném API dávejte přednost konkrétním typům popisujícím možné chyby.

Příklady

public class ThrowsDemo {
    static void check(boolean valid) throws Exception {
        if (!valid) {
            throw new Exception("Invalid input");
        }
    }

    public static void main(String[] args) {
        try {
            check(false);
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }
    }
}

Výsledek

Invalid input

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje