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

CKTIS / Java

Optional.orElseThrow: référence pratique

Optional.orElseThrow: référence pratique: Optional.orElseThrow renvoie la valeur présente ; sans argument il lève NoSuchElementException à vide, avec supplier il lève l’exception fournie.

Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntaxe

Optional.orElseThrow(...)

Optional.orElseThrow renvoie la valeur présente ; sans argument il lève NoSuchElementException à vide, avec supplier il lève l’exception fournie.

Utilise-le lorsque l’absence viole le contrat de la méthode ; le supplier construit paresseusement une exception métier, même checked.

Le supplier d’exception n’est pas appelé si la valeur est présente ; n’y place donc pas un travail requis indépendamment de l’absence.

Pour un Optional vide, un supplier null provoque NullPointerException ; un supplier qui produit null mène aussi à NullPointerException lors du throw.

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Exemples

public class Main {
    public static void main(String[] args) throws Exception {
        try {
            java.util.Optional.empty().orElseThrow();
        } catch (java.util.NoSuchElementException error) {
            System.out.println(error.getClass().getSimpleName());
        }
    }
}

Résultat

NoSuchElementException

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Sources