CKTIS / Java
Optional.filter: referência prática
Optional.filter: referência prática: Optional.filter(predicate) devolve um Optional que descreve o valor presente se satisfizer o predicado, um Optional vazio caso contrário, e mantém vazio um recetor vazio.
Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxe
Optional.filter(...)Optional.filter(predicate) devolve um Optional que descreve o valor presente se satisfizer o predicado, um Optional vazio caso contrário, e mantém vazio um recetor vazio.
Usa filter para conservar um valor opcional apenas quando cumpre uma condição do domínio, sem ramificar manualmente com isPresent.
O predicado não é executado num recetor vazio, portanto não coloques nele efeitos laterais obrigatórios; as suas exceções propagam-se.
Um argumento predicate null causa NullPointerException; o valor presente aceite não é copiado nem transformado.
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 {
var value = java.util.Optional.of("Java").filter(text -> text.length() > 3);
System.out.println(value.orElse("missing"));
}
}
Resultado
Java
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.