CKTIS / Java
throws — deklarovanie výnimiek
Kľúčové slovo throws v deklarácii metódy alebo konštruktora určuje typy výnimiek, ktoré môžu uniknúť z jeho tela. Je dôležité najmä pri kontrolovaných výnimkách: volajúci kód ich musí spracovať alebo deklarovať ich ďalšie šírenie.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
throws ExceptionType1, ExceptionType2throws je rezervované kľúčové slovo. Klauzula sa uvádza za zoznamom parametrov metódy alebo konštruktora, pred telom alebo bodkočiarkou ukončujúcou deklaráciu. Typy oddeľujte čiarkami; každý musí byť podtypom Throwable. Povolené sú aj typové premenné s vhodnými hranicami.
Ak môže z tela uniknúť kontrolovaná výnimka, deklarácia musí uvádzať jej typ alebo nadtyp. Volajúci kód musí takúto výnimku zachytiť pomocou try/catch alebo ju deklarovať vo vlastnej klauzule throws. Podtypy RuntimeException a Error sú nekontrolované: uviesť ich možno, ale nie je to povinné.
Nezamieňajte throws a throw: prvé deklaruje možné šírenie výnimky, zatiaľ čo druhé výnimku skutočne vyhodí. Klauzula throws sama nič nevyhadzuje ani nespracúva a nezaručuje, že výnimka nastane.
Pri prepisovaní metódy (JLS §8.4.8.3) sa každý deklarovaný typ kontrolovanej výnimky musí zhodovať s niektorým typom v klauzule throws prepisovanej metódy po vymazaní typov alebo byť jeho podtypom. Inak nastane chyba kompilácie. Ak je podmienka splnená až po vymazaní typov, kompilátor vydá upozornenie typu unchecked. Napríklad negenerická metóda void run() throws Exception môže prepísať <E extends Exception> void run() throws E s týmto upozornením namiesto chyby: E sa pri vymazaní typov nahradí typom Exception, ale pred vymazaním nie je Exception podtypom E.
V príklade check(false) vyhodí kontrolovanú výnimku Exception, ktorú main zachytí a vypíše jej správu. Všeobecný typ Exception zjednodušuje ukážku; v skutočnom API uprednostnite konkrétne typy opisujúce možné chyby.
Prí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ýsledok
Invalid input
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
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