CKTIS / Java
throws — Ausnahmen deklarieren
Das Schlüsselwort throws in einer Methoden- oder Konstruktordeklaration gibt die Ausnahmetypen an, die den Methoden- oder Konstruktorrumpf verlassen können. Besonders bei geprüften Ausnahmen ist es wichtig: Aufrufender Code muss sie behandeln oder ihre Weitergabe deklarieren.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
throws ExceptionType1, ExceptionType2throws ist ein reserviertes Schlüsselwort. Die Klausel steht nach der Parameterliste einer Methode oder eines Konstruktors und vor dem Rumpf beziehungsweise dem Semikolon, das die Deklaration beendet. Typen werden durch Kommas getrennt; jeder muss ein Untertyp von Throwable sein. Typparameter mit passenden Schranken sind ebenfalls zulässig.
Kann eine geprüfte Ausnahme den Rumpf verlassen, muss die Deklaration ihren Typ oder einen Supertyp aufführen. Aufrufender Code muss eine solche Ausnahme mit try/catch abfangen oder sie in seiner eigenen throws-Klausel deklarieren. Untertypen von RuntimeException und Error sind ungeprüft: Sie dürfen aufgeführt werden, müssen es aber nicht.
Verwechsle throws nicht mit throw: Ersteres deklariert eine mögliche Weitergabe, Letzteres löst tatsächlich eine Ausnahme aus. Eine throws-Klausel löst selbst nichts aus und behandelt auch nichts; sie garantiert nicht, dass eine Ausnahme auftritt.
Beim Überschreiben einer Methode (JLS §8.4.8.3) muss jeder deklarierte Typ einer geprüften Ausnahme mit einem Typ in der throws-Klausel der überschriebenen Methode nach der Typlöschung übereinstimmen oder ein Untertyp davon sein. Andernfalls tritt ein Kompilierungsfehler auf. Ist die Bedingung erst nach der Typlöschung erfüllt, gibt der Compiler eine Warnung vom Typ unchecked aus. So kann eine nicht generische Methode void run() throws Exception die Methode <E extends Exception> void run() throws E mit einer solchen Warnung statt eines Fehlers überschreiben: E wird bei der Typlöschung zu Exception, aber vor der Typlöschung ist Exception kein Untertyp von E.
Im Beispiel löst check(false) die geprüfte Ausnahme Exception aus, und main fängt sie ab und gibt ihre Meldung aus. Der allgemeine Typ Exception hält die Demonstration einfach; bevorzuge in einer realen API konkrete Typen, die die möglichen Fehler beschreiben.
Beispiele
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());
}
}
}Ergebnis
Invalid input
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- 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