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

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

Fontes