CKTIS / Java
RuntimeException(Throwable): envolver uma causa de exceção
O construtor RuntimeException(Throwable) cria uma exceção não verificada, preserva a causa original e obtém dela a mensagem.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new RuntimeException(Throwable cause)RuntimeException(Throwable) cria uma exceção que envolve a causa fornecida. RuntimeException é uma exceção não verificada: o compilador não exige que seja capturada nem declarada em throws. Usar apenas new não lança a exceção criada; para isso, usa-se throw.
getCause() devolve o objeto fornecido e a mensagem é definida como (cause==null ? null : cause.toString()), não apenas como cause.getMessage(). Um valor null significa que a causa está ausente ou é desconhecida; nesse caso, a mensagem também é null.
O envolvimento preserva a cadeia de causas para diagnóstico. Não a substitua apenas pelo texto do erro se quiser manter a exceção original. Para acrescentar o seu próprio contexto, use RuntimeException(String message, Throwable cause); esta sobrecarga não inclui automaticamente a mensagem da causa.
A expressão new RuntimeException(null) é ambígua, porque existem sobrecargas que aceitam String e Throwable. Use new RuntimeException((Throwable) null) para selecionar este construtor. Depois de o chamar, não pode redefinir a causa através de initCause(), mesmo que tenha fornecido null.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.