Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes