CKTIS / Java
Optional.get(): obter um valor de Optional
`Optional.get()` devolve o valor contido quando este está presente. Uma chamada num `Optional` vazio lança `NoSuchElementException`.
Versão: Java SE 21
Sintaxe
public T get()
T value = optional.get();Optional.get identifica o método get da classe java.util.Optional<T>. Optional.get() identifica o mesmo método sem argumentos. A chamada é feita numa instância, por exemplo optional.get(), e não na classe. O método está disponível desde o Java 8. T é o tipo do valor contido.
Se existir um valor, get() devolve-o sem alterar o conteúdo do Optional. Se o Optional estiver vazio, get() não devolve null: lança a exceção não verificada java.util.NoSuchElementException. Não chames get() às cegas: se isPresent() devolver true na mesma instância, existe um valor.
Se a ausência for normal, usa orElse(valorAlternativo) para devolver um valor alternativo ou ifPresent(acao) para executar uma ação só quando houver valor. Se a ausência tiver de ser tratada como erro, a documentação do Java SE 21 recomenda orElseThrow() sem argumentos, disponível desde o Java 10. Também lança NoSuchElementException; a sobrecarga que recebe um fornecedor permite escolher a exceção.
Exemplos
import java.util.NoSuchElementException;
import java.util.Optional;
public class OptionalGetDemo {
public static void main(String[] args) {
Optional<String> present = Optional.of("Ada");
Optional<String> empty = Optional.empty();
System.out.println(present.get());
try {
System.out.println(empty.get());
} catch (NoSuchElementException e) {
System.out.println("NoSuchElementException");
}
System.out.println(empty.orElse("Guest"));
}
}Resultado
Ada NoSuchElementException Guest
A primeira chamada a `get()` devolve `Ada`. A segunda lança propositadamente uma exceção, que o programa interceta para mostrar que `orElse("Guest")` devolve `Guest` em alternativa.
Lições relacionadas
- Java · Lição 66 · Básico · Versão: 2
- Java · Lição 47 · Intermédio · Versão: 2