CKTIS / Java
Optional — um valor ou a sua ausência
Optional<T> representa um resultado que contém um valor ou está vazio. Aprenda a verificar a presença de um valor e a aceder-lhe com segurança.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Optional<T> result = Optional.ofNullable(value);
boolean present = result.isPresent();
if (result.isPresent()) {
T item = result.get();
}java.util.Optional<T> representa um valor diferente de null ou a sua ausência, principalmente como resultado de um método. A própria referência Optional não deve ser null.
Optional.of(value) rejeita null, lançando uma NullPointerException; Optional.ofNullable(value) converte null num resultado vazio. Optional.empty() cria um resultado vazio.
Optional.isPresent() devolve true quando existe um valor. Optional.get() devolve esse valor, mas lança uma NoSuchElementException se o resultado estiver vazio. O exemplo chama get() apenas depois de verificar a presença. A documentação prefere orElseThrow() a get() quando a ausência de um valor deve causar uma exceção.
Exemplos
import java.util.Optional;
public class Main {
public static void main(String[] args) {
Optional<String> name = Optional.of("Ada");
Optional<String> missing = Optional.empty();
System.out.println(name.isPresent());
if (name.isPresent()) {
System.out.println(name.get());
}
System.out.println(missing.isPresent());
}
}Resultado
true Ada false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.