CKTIS / Java
RuntimeException(Throwable) : envelopper une cause d’exception
Le constructeur RuntimeException(Throwable) crée une exception non vérifiée, conserve la cause d’origine et en déduit le message.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
new RuntimeException(Throwable cause)RuntimeException(Throwable) crée une exception qui enveloppe la cause fournie. RuntimeException est une exception non vérifiée : le compilateur n’exige ni qu’elle soit interceptée ni qu’elle soit déclarée dans throws. À lui seul, new ne déclenche pas l’exception créée ; c’est le rôle de throw.
getCause() renvoie l’objet fourni, et le message est défini par (cause==null ? null : cause.toString()), et non par le seul cause.getMessage(). Une valeur null signifie que la cause est absente ou inconnue ; le message est alors également null.
L’enveloppement préserve la chaîne des causes pour faciliter le diagnostic. Ne la remplacez pas par le seul texte d’erreur si vous souhaitez conserver l’exception d’origine. Pour ajouter votre propre contexte, utilisez RuntimeException(String message, Throwable cause) ; cette surcharge n’inclut pas automatiquement le message de la cause.
L’expression new RuntimeException(null) est ambiguë, car il existe des surcharges qui acceptent String et Throwable. Utilisez new RuntimeException((Throwable) null) pour sélectionner ce constructeur. Après son appel, vous ne pouvez pas réinitialiser la cause avec initCause(), même si vous avez fourni null.
Exemples
public class Main {
public static void main(String[] args) {
Exception cause = new Exception("Input unavailable");
RuntimeException wrapped = new RuntimeException(cause);
System.out.println(wrapped.getMessage());
System.out.println(wrapped.getCause() == cause);
RuntimeException empty = new RuntimeException((Throwable) null);
System.out.println(empty.getMessage() == null);
System.out.println(empty.getCause() == null);
}
}Résultat
java.lang.Exception: Input unavailable true true true
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.