CKTIS / Java
throws — uitzonderingen declareren
Het sleutelwoord throws in de declaratie van een methode of constructor geeft aan welke uitzonderingen uit de body kunnen ontsnappen. Het is vooral van belang voor gecontroleerde uitzonderingen: aanroepende code moet ze afhandelen of declareren dat ze verder kunnen worden doorgegeven.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
throws ExceptionType1, ExceptionType2throws is een gereserveerd sleutelwoord. De clausule staat na de parameterlijst van een methode of constructor, vóór de body of de puntkomma die de declaratie afsluit. Scheid de typen met komma’s; elk type moet een subtype van Throwable zijn. Typevariabelen met geschikte grenzen zijn ook toegestaan.
Als een gecontroleerde uitzondering uit de body kan ontsnappen, moet de declaratie het type of een supertype ervan vermelden. Aanroepende code moet zo’n uitzondering afvangen met try/catch of declareren in de eigen throws-clausule. Subtypen van RuntimeException en Error zijn ongecontroleerd: ze vermelden mag, maar hoeft niet.
Verwar throws niet met throw: het eerste declareert mogelijke doorgifte, terwijl het tweede daadwerkelijk een uitzondering gooit. Een throws-clausule gooit of handelt zelf niets af en garandeert niet dat er een uitzondering optreedt.
Bij het overschrijven van een methode (JLS §8.4.8.3) moet elk gedeclareerd type van een gecontroleerde uitzondering gelijk zijn aan of een subtype zijn van een type in de throws-clausule van de overschreven methode na typewissing. Anders treedt er een compilatiefout op. Als pas na typewissing aan die voorwaarde wordt voldaan, geeft de compiler een unchecked-waarschuwing. Zo kan een niet-generieke methode void run() throws Exception de methode <E extends Exception> void run() throws E overschrijven met die waarschuwing in plaats van een fout: door typewissing wordt E vervangen door Exception, maar vóór typewissing is Exception geen subtype van E.
In het voorbeeld gooit check(false) de gecontroleerde uitzondering Exception, die main opvangt en waarvan het bericht wordt afgedrukt. Het algemene type Exception houdt de demonstratie eenvoudig; gebruik in een echte API bij voorkeur specifieke typen die de mogelijke fouten beschrijven.
Voorbeelden
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());
}
}
}Resultaat
Invalid input
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- 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