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.