WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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, ExceptionType2

throws 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