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

CKTIS / Java

Optional.orElseThrow: referência prática

Optional.orElseThrow: referência prática: Optional.orElseThrow devolve o valor presente; sem argumentos lança NoSuchElementException quando vazio e com supplier lança a exceção fornecida.

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

Sintaxe

Optional.orElseThrow(...)

Optional.orElseThrow devolve o valor presente; sem argumentos lança NoSuchElementException quando vazio e com supplier lança a exceção fornecida.

Usa-o quando a ausência viola o contrato do método; supplier permite construir de forma lazy uma exceção de domínio, inclusive checked.

O supplier da exceção não é invocado se houver valor; não coloques nele trabalho necessário independentemente da ausência.

Para Optional vazio, supplier null causa NullPointerException; um supplier que produz null também termina em NullPointerException ao lançar.

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Exemplos

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

Resultado

NoSuchElementException

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Fontes