CKTIS / Java
throws — déclarer des exceptions
Le mot-clé throws dans la déclaration d’une méthode ou d’un constructeur indique les types d’exception susceptibles de s’échapper de son corps. Il est particulièrement important pour les exceptions vérifiées : le code appelant doit les gérer ou déclarer qu’elles peuvent être propagées.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
throws ExceptionType1, ExceptionType2throws est un mot-clé réservé. La clause apparaît après la liste des paramètres d’une méthode ou d’un constructeur, avant le corps ou le point-virgule qui termine la déclaration. Séparez les types par des virgules ; chacun doit être un sous-type de Throwable. Les variables de type assorties de bornes appropriées sont également autorisées.
Si une exception vérifiée peut s’échapper du corps, la déclaration doit indiquer son type ou un supertype. Le code appelant doit intercepter cette exception avec try/catch ou la déclarer dans sa propre clause throws. Les sous-types de RuntimeException et de Error sont non vérifiés : il est permis de les indiquer, mais ce n’est pas obligatoire.
Ne confondez pas throws et throw : le premier déclare une propagation possible, tandis que le second déclenche effectivement une exception. Une clause throws ne déclenche ni ne traite quoi que ce soit et ne garantit pas qu’une exception se produira.
Lors de la redéfinition d’une méthode (JLS §8.4.8.3), chaque type d’exception vérifiée déclaré doit correspondre à un type de la clause throws de la méthode redéfinie après effacement des types, ou en être un sous-type. À défaut, la compilation échoue. Si la condition n’est remplie qu’après effacement, le compilateur émet un avertissement de type unchecked. Par exemple, une méthode non générique void run() throws Exception peut redéfinir <E extends Exception> void run() throws E avec cet avertissement plutôt qu’une erreur : E devient Exception après effacement, mais avant effacement, Exception n’est pas un sous-type de E.
Dans l’exemple, check(false) déclenche l’exception vérifiée Exception, que main intercepte et dont il affiche le message. Le type général Exception simplifie la démonstration ; dans une API réelle, préférez des types précis qui décrivent les échecs possibles.
Exemples
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());
}
}
}Résultat
Invalid input
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- 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