Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

RuntimeException(Throwable): zabalení příčiny výjimky

Konstruktor RuntimeException(Throwable) vytváří nekontrolovanou výjimku, zachovává původní příčinu a odvozuje z ní zprávu.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

new RuntimeException(Throwable cause)

RuntimeException(Throwable) vytvoří výjimku, která zabalí zadanou příčinu. RuntimeException je nekontrolovaná výjimka: kompilátor nevyžaduje, aby byla zachycena nebo deklarována v throws. Samotné použití new vytvořenou výjimku nevyvolá; k tomu slouží throw.

getCause() vrací předaný objekt a zpráva se nastaví na (cause==null ? null : cause.toString()), nikoli pouze na cause.getMessage(). Hodnota null znamená, že příčina chybí nebo není známa; zpráva je pak také null.

Zabalení zachovává řetězec příčin pro diagnostiku. Pokud chcete zachovat původní výjimku, nenahrazujte jej pouze textem chyby. Vlastní kontext přidáte pomocí RuntimeException(String message, Throwable cause); tato přetížená varianta automaticky nepřipojuje zprávu příčiny.

Výraz new RuntimeException(null) je nejednoznačný, protože existují přetížené varianty přijímající String a Throwable. Tento konstruktor vyberete pomocí new RuntimeException((Throwable) null). Po jeho zavolání už nelze příčinu znovu nastavit pomocí initCause(), ani když jste předali null.

Příklady

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);
    }
}

Výsledek

java.lang.Exception: Input unavailable
true
true
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje