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 :
- Ne jamais avaler une exception : un
catchvide fait disparaître l'erreur sans laisser de trace. Au minimum, journaliser. - 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. - Conserver la cause en enveloppant une exception technique :
new PaiementIndisponibleException("Service injoignable", e)gardeeaccessible viagetCause(), 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 (RuntimeExceptionbrute) ou un retournull.- Cause (constructeur avec cause)
Un constructeur de type
MonException(String message, Throwable cause)(hérité deThrowable) qui conserve l'exception technique d'origine tout en ajoutant un message métier. Récupérable avecgetCause(), affichée dans la pile sousCaused by.- initCause()
Méthode de
Throwablequi 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 renvoyernull. 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.
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.