CKTIS / Java
throws — deklariranje iznimki
Ključna riječ throws u deklaraciji metode ili konstruktora određuje vrste iznimki koje mogu izaći iz njegova tijela. Posebno je važna za provjeravane iznimke: pozivajući kod mora ih obraditi ili deklarirati da se mogu dalje proslijediti.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
throws ExceptionType1, ExceptionType2throws je rezervirana ključna riječ. Klauzula se navodi nakon popisa parametara metode ili konstruktora, a prije tijela ili točke-zareza koja završava deklaraciju. Vrste odvojite zarezima; svaka mora biti podvrsta Throwable. Dopuštene su i varijable tipa s odgovarajućim ograničenjima.
Ako provjeravana iznimka može izaći iz tijela, deklaracija mora navesti njezinu vrstu ili nadtip. Pozivajući kod mora uhvatiti takvu iznimku pomoću try/catch ili je deklarirati u vlastitoj klauzuli throws. Podvrste RuntimeException i Error nisu provjeravane: dopušteno ih je navesti, ali to nije obvezno.
Nemojte zamijeniti throws i throw: prvo deklarira mogućnost daljnjeg prosljeđivanja, a drugo stvarno baca iznimku. Klauzula throws sama ništa ne baca niti obrađuje i ne jamči da će se iznimka pojaviti.
Pri nadjačavanju metode (JLS §8.4.8.3) svaki deklarirani tip provjeravane iznimke mora se podudarati s nekim tipom u klauzuli throws nadjačane metode nakon brisanja tipova ili biti njegov podtip. U suprotnom nastaje pogreška pri prevođenju. Ako je uvjet ispunjen tek nakon brisanja tipova, prevoditelj izdaje upozorenje vrste unchecked. Primjerice, negenerička metoda void run() throws Exception može nadjačati <E extends Exception> void run() throws E uz takvo upozorenje umjesto pogreške: E se pri brisanju tipova zamjenjuje tipom Exception, ali prije brisanja Exception nije podtip od E.
U primjeru check(false) baca provjeravanu iznimku Exception, a main je hvata i ispisuje njezinu poruku. Opća vrsta Exception pojednostavljuje prikaz; u stvarnom API-ju prednost dajte konkretnim vrstama koje opisuju moguće pogreške.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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