Formations — 1 037 leçons en français

Accueil › Java › Concevoir ses exceptions

Concevoir ses exceptions

Les exceptionsdebutant

Une bonne exception métier remplace une exception technique brute ou un null ambigu par quelque chose d'explicite :

public class StockInsuffisantException extends RuntimeException {

    private final String codeProduit;
    private final int quantiteDemandee;

    public StockInsuffisantException(String codeProduit, int quantiteDemandee) {
        super("Stock insuffisant pour " + codeProduit + " (demandé : " + quantiteDemandee + ")");
        this.codeProduit = codeProduit;
        this.quantiteDemandee = quantiteDemandee;
    }
}

Trois règles à respecter systématiquement :

  1. Ne jamais avaler une exception : un catch vide fait disparaître l'erreur sans laisser de trace. Au minimum, journaliser.
  2. Ne pas utiliser les exceptions pour un contrôle de flux normal : si l'absence de résultat ou un refus est un cas courant et attendu (ex. panier vide), préférer Optional, un objet résultat, ou une validation en amont.
  3. Conserver la cause en enveloppant une exception technique : new PaiementIndisponibleException("Service injoignable", e) garde e accessible via getCause(), sans perdre l'information d'origine.

Le choix vérifiée/non vérifiée dépend du contexte : vérifiée si l'appelant a une vraie action corrective à faire et doit y penser ; non vérifiée si la plupart des appelants ne peuvent rien faire d'autre que la laisser remonter.

Les termes à connaître

Exception métier

Exception propre au domaine de l'application (ex. StockInsuffisantException), qui porte un message et parfois des données utiles à celui qui l'attrape, plutôt qu'une exception technique générique (RuntimeException brute) ou un retour null.

Cause (constructeur avec cause)

Un constructeur de type MonException(String message, Throwable cause) (hérité de Throwable) qui conserve l'exception technique d'origine tout en ajoutant un message métier. Récupérable avec getCause(), affichée dans la pile sous Caused by.

initCause()

Méthode de Throwable qui attache une cause après la construction, utile quand le constructeur choisi ne l'accepte pas directement. Ne peut être appelée qu'une seule fois par exception.

Catch vide

Bloc catch (Exception e) { } qui n'affiche rien, ne journalise rien, ne relance rien : l'erreur disparaît silencieusement. Un des pièges les plus coûteux à déboguer en production.

@throws

Balise Javadoc qui documente qu'une méthode publique peut lever tel type d'exception, et dans quelles conditions. Fait partie du contrat de l'API, au même titre que les paramètres et la valeur de retour.

Optional

Type (java.util.Optional<T>) qui représente explicitement l'absence possible d'une valeur, sans lever d'exception ni renvoyer null. Adapté quand l'absence est un cas normal, pas une erreur.

Coût d'une exception

Créer une exception capture la pile d'appels (fillInStackTrace()), une opération relativement coûteuse comparée à un simple retour de valeur. Négligeable pour un cas d'erreur réel et occasionnel ; problématique si des exceptions sont levées en masse dans un chemin d'exécution normal et fréquent.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.