Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Throwable : message, cause et exceptions supprimées

java.lang.Throwable est à la base de la hiérarchie des exceptions et des erreurs. Distinguez son message, sa cause et ses exceptions supprimées.

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

Syntaxe

String getMessage();
Throwable getCause();
final Throwable[] getSuppressed();

java.lang.Throwable est la classe de base de Exception et de Error. Ses objets représentent des problèmes qui peuvent être lancés avec throw et interceptés avec catch.

Throwable.getMessage() renvoie un message de type String, qui peut être null. Throwable.getCause() renvoie la cause sous la forme d’un Throwable, ou null si elle est absente ou inconnue. Vérifiez qu’elle n’est pas null avant d’appeler des méthodes sur la cause.

Throwable.getSuppressed() renvoie un Throwable[], vide si aucune exception n’a été supprimée ou si la suppression est désactivée. Une cause explique l’origine d’un échec ; une exception supprimée décrit un échec distinct, par exemple lors de la fermeture d’une ressource avec try-with-resources. Un même objet peut contenir ces deux types d’informations.

Exemples

public class Main {
    public static void main(String[] args) {
        Throwable cause = new IllegalArgumentException("invalid input");
        Throwable failure = new Exception("operation failed", cause);
        failure.addSuppressed(new Exception("cleanup failed"));

        System.out.println(failure.getMessage());
        System.out.println(failure.getCause().getMessage());
        for (Throwable suppressed : failure.getSuppressed()) {
            System.out.println(suppressed.getMessage());
        }
    }
}

Résultat

operation failed
invalid input
cleanup failed

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources