CKTIS / Java
RuntimeException(Throwable): envolver una causa de excepción
El constructor RuntimeException(Throwable) crea una excepción no comprobada, conserva la causa original y obtiene de ella el mensaje.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
new RuntimeException(Throwable cause)RuntimeException(Throwable) crea una excepción que envuelve la causa proporcionada. RuntimeException es una excepción no comprobada: el compilador no exige que se capture ni que se declare en throws. Usar new por sí solo no lanza la excepción creada; para ello se usa throw.
getCause() devuelve el objeto proporcionado, y el mensaje se establece como (cause==null ? null : cause.toString()), no simplemente como cause.getMessage(). Un valor null significa que la causa no existe o es desconocida; en ese caso, el mensaje también es null.
El envoltorio conserva la cadena de causas para facilitar el diagnóstico. No la sustituyas únicamente por el texto del error si quieres conservar la excepción original. Para añadir tu propio contexto, usa RuntimeException(String message, Throwable cause); esa sobrecarga no incluye automáticamente el mensaje de la causa.
La expresión new RuntimeException(null) es ambigua porque existen sobrecargas que aceptan String y Throwable. Usa new RuntimeException((Throwable) null) para seleccionar este constructor. Después de llamarlo, no puedes restablecer la causa mediante initCause(), aunque hayas proporcionado null.
Ejemplos
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);
}
}Resultado
java.lang.Exception: Input unavailable true true true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.