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, ExceptionType2throws 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
- The Java Language Specification, Java SE 21, §3.9 Keywords
- The Java Language Specification, Java SE 21, §8.4.6 Method Throws
- The Java Language Specification, Java SE 21, §11.2 Compile-Time Checking of Exceptions
- The Java Language Specification, Java SE 21, §8.4.8.3 Requirements in Overriding and Hiding