CKTIS / Java
RuntimeException(Throwable): een uitzonderingsoorzaak omwikkelen
De constructor RuntimeException(Throwable) maakt een ongecontroleerde uitzondering, bewaart de oorspronkelijke oorzaak en leidt daaruit het bericht af.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
new RuntimeException(Throwable cause)RuntimeException(Throwable) maakt een uitzondering die de opgegeven oorzaak omwikkelt. RuntimeException is ongecontroleerd: de compiler vereist niet dat je deze uitzondering opvangt of in throws declareert. Alleen new gebruiken gooit de gemaakte uitzondering niet; daarvoor dient throw.
getCause() retourneert het opgegeven object en het bericht wordt ingesteld op (cause==null ? null : cause.toString()), niet alleen op cause.getMessage(). De waarde null betekent dat de oorzaak ontbreekt of onbekend is; het bericht is dan ook null.
Het omwikkelen bewaart de oorzaakketen voor diagnose. Vervang die niet door alleen fouttekst als je de oorspronkelijke uitzondering wilt behouden. Gebruik RuntimeException(String message, Throwable cause) om je eigen context toe te voegen; deze overload voegt het bericht van de oorzaak niet automatisch toe.
De expressie new RuntimeException(null) is ambigu, omdat er overloads zijn die String en Throwable accepteren. Gebruik new RuntimeException((Throwable) null) om deze constructor te selecteren. Na de aanroep kun je de oorzaak niet opnieuw instellen met initCause(), zelfs niet als je null hebt opgegeven.
Voorbeelden
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);
}
}Resultaat
java.lang.Exception: Input unavailable true true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.