CKTIS / Java
throws — deklarowanie wyjątków
Słowo kluczowe throws w deklaracji metody lub konstruktora określa typy wyjątków, które mogą opuścić jego ciało. Jest szczególnie ważne dla wyjątków kontrolowanych: kod wywołujący musi je obsłużyć albo zadeklarować ich dalsze przekazanie.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
throws ExceptionType1, ExceptionType2throws jest zastrzeżonym słowem kluczowym. Klauzulę umieszcza się po liście parametrów metody lub konstruktora, przed ciałem albo kończącym deklarację średnikiem. Typy rozdziela się przecinkami; każdy musi być podtypem Throwable. Dozwolone są także zmienne typowe o odpowiednim ograniczeniu.
Jeżeli wyjątek kontrolowany może opuścić ciało, deklaracja musi wymieniać jego typ albo nadtyp. Kod wywołujący musi przechwycić taki wyjątek przez try/catch lub zadeklarować go we własnej klauzuli throws. Podtypy RuntimeException i Error są niekontrolowane: można je wymienić, ale nie jest to wymagane.
Nie myl throws z throw: pierwsze deklaruje możliwość przekazania wyjątku, drugie faktycznie go zgłasza. Samo throws niczego nie zgłasza ani nie obsługuje i nie gwarantuje wystąpienia wyjątku.
Przy przesłanianiu metody (JLS §8.4.8.3) każdy deklarowany typ wyjątku kontrolowanego musi być wymieniony w klauzuli throws metody przesłanianej po wymazaniu typów albo być podtypem jednego z wymienionych tam typów. W przeciwnym razie występuje błąd kompilacji. Jeżeli warunek jest spełniony dopiero po wymazaniu typów, kompilator zgłasza ostrzeżenie typu unchecked. Na przykład niegeneryczna metoda void run() throws Exception może przesłonić <E extends Exception> void run() throws E z takim ostrzeżeniem, a nie błędem: E po wymazaniu typów staje się Exception, ale przed wymazaniem typów Exception nie jest podtypem E.
W przykładzie check(false) zgłasza kontrolowany wyjątek Exception, a main go przechwytuje i wypisuje komunikat. Ogólny typ Exception upraszcza demonstrację; w rzeczywistym API preferuj konkretne typy opisujące możliwe błędy.
Przykłady
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());
}
}
}Wynik
Invalid input
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- 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