Comprendre le Mot-Clé throws en Java : Exemples et Bonnes Pratiques

Mot-Clé throws en Java

Le mot-clé throws en Java permet de déclarer qu'une méthode peut lancer une ou plusieurs exceptions. En listant explicitement ces échecs potentiels, vous signalez aux appelants qu'ils doivent soit gérer l'exception, soit la propager davantage, gardant votre code clair et fiable.

Lorsque vous appelez une méthode de bibliothèque qui peut lancer une exception vérifiée, Java vous oblige à la traiter. Normalement, vous envelopperiez le code risqué dans un bloc try-catch :

import java.io.*;
class Fichier1 {
    public static void main(String[] args) {
        try {
            FileWriter fichier = new FileWriter("c:\\Data1.txt");
            fichier.write("Guru99");
            fichier.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Si vous omettez le try-catch, le compilateur rejettera le programme. Bien que gérer chaque exception individuellement puisse être verbeux, Java offre une alternative plus propre : déclarer l'exception dans la signature de la méthode en utilisant throws et laisser l'appelant décider comment la gérer.

Syntaxe de throws

public void nomMethode(Paramètres) throws Exception1, Exception2, … {
    …
}

Exemple de throws

Voici le même exemple d'écriture de fichier, mais la méthode main déclare qu'elle lance IOException au lieu de l'intercepter :

import java.io.*;
class Fichier1 {
    public static void main(String[] args) throws IOException {
        FileWriter fichier = new FileWriter("c:\\Data1.txt");
        fichier.write("Guru99");
        fichier.close();
    }
}

Avant d'exécuter ce code, créez un fichier vide nommé Data1.txt sur le lecteur C:\. Java offre deux façons de satisfaire l'exigence du compilateur selon laquelle les exceptions vérifiées doivent être traitées :

1. Envelopper le code risqué dans un bloc try-catch.
2. Déclarer la méthode avec throws et propager l'exception à l'appelant.

Le choix de la bonne approche dépend du contexte. Si la méthode fait partie d'une API publique, propager l'exception garde souvent la surface de l'API propre et force les appelants à gérer les échecs explicitement.

Throw vs Throws

throw	throws
Utilisé pour créer et lancer une nouvelle instance d'exception.	Utilisé dans une signature de méthode pour déclarer les exceptions que la méthode peut propager.
Ne peut lancer qu'une seule exception à la fois.	Peut lister plusieurs types d'exceptions séparés par des virgules.
Exemple :	Exemple :
throw new IOException("impossible d'ouvrir la connexion");	throws IOException, ArrayIndexOutOfBoundsException

Résumé

Le mot-clé throws est essentiel pour une propagation claire des exceptions en Java. Lorsqu'une méthode déclare throws, tout appelant doit gérer ou redéclarer l'exception, assurant que les conditions d'erreur ne sont jamais ignorées silencieusement.