CKTIS / Java
throws — deklariranje izjem
Ključna beseda throws v deklaraciji metode ali konstruktorja določa vrste izjem, ki lahko uidejo iz njegovega telesa. Pomembna je zlasti pri preverjenih izjemah: koda, ki metodo kliče, jih mora obravnavati ali deklarirati, da se lahko širijo naprej.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
throws ExceptionType1, ExceptionType2throws je rezervirana ključna beseda. Klavzula stoji za seznamom parametrov metode ali konstruktorja, pred telesom ali podpičjem, ki konča deklaracijo. Vrste ločite z vejicami; vsaka mora biti podvrsta Throwable. Dovoljene so tudi tipske spremenljivke z ustreznimi mejami.
Če lahko preverjena izjema uide iz telesa, mora deklaracija navesti njeno vrsto ali nadtip. Koda, ki metodo kliče, mora tako izjemo ujeti z try/catch ali jo deklarirati v svoji klavzuli throws. Podvrste RuntimeException in Error so nepreverjene: navesti jih je dovoljeno, ni pa obvezno.
Ne zamenjujte throws in throw: prvo deklarira možnost širjenja izjeme, drugo pa izjemo dejansko sproži. Klavzula throws sama ničesar ne sproži ali obravnava in ne zagotavlja, da bo do izjeme prišlo.
Pri prepisovanju metode (JLS §8.4.8.3) se mora vsak deklarirani tip preverjene izjeme ujemati s tipom v klavzuli throws prepisane metode po izbrisu tipov ali biti njegov podtip. Sicer pride do napake pri prevajanju. Če je pogoj izpolnjen šele po izbrisu tipov, prevajalnik izda opozorilo tipa unchecked. Na primer, negenerična metoda void run() throws Exception lahko prepiše <E extends Exception> void run() throws E s takim opozorilom namesto napake: E se pri izbrisu tipov nadomesti z Exception, pred izbrisom pa Exception ni podtip E.
V primeru check(false) sproži preverjeno izjemo Exception, ki jo main ujame in izpiše njeno sporočilo. Splošna vrsta Exception poenostavi prikaz; v pravem API-ju raje uporabite konkretne vrste, ki opisujejo možne napake.
Primeri
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());
}
}
}Rezultat
Invalid input
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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