Dúvida em java.util.stream

Oii Luccas, tudo bem?

Vou te ajudar a entender melhor esses métodos do java.util.stream.

1. builder()

O método builder() é uma forma de criar uma Stream de maneira mais flexível e controlada. Ele retorna uma instância de Stream.Builder, que permite adicionar elementos à Stream antes de construí-la. É útil quando você precisa criar uma Stream dinamicamente.

Stream<String> stream = Stream.<String>builder()
    .add("elemento1")
    .add("elemento2")
    .add("elemento3")
    .build();

stream.forEach(System.out::println);

Neste exemplo, criamos uma Stream de String usando o builder(), adicionamos três elementos e depois a construímos com o método build(). Em seguida, imprimimos cada elemento da Stream.

2. findAny() e findFirst()

Ambos os métodos são usados para encontrar elementos em uma Stream, mas com diferenças sutis:

• findAny(): retorna um Optional descrevendo algum elemento da Stream. Ele é útil em operações paralelas, onde qualquer elemento pode ser retornado rapidamente.

• findFirst(): retorna um Optional descrevendo o primeiro elemento da Stream. É útil quando a ordem dos elementos é importante.

Optional Describing

Tanto findAny() quanto findFirst() retornam um Optional, que é uma classe contêiner que pode ou não conter um valor não nulo. Usar Optional ajuda a evitar o problema de NullPointerException.

List<String> lista = Arrays.asList("elemento1", "elemento2", "elemento3");

Optional<String> qualquerElemento = lista.stream().findAny();
qualquerElemento.ifPresent(System.out::println); // Pode imprimir qualquer elemento

Optional<String> primeiroElemento = lista.stream().findFirst();
primeiroElemento.ifPresent(System.out::println); // Sempre imprime "elemento1"

No exemplo acima, findAny() pode retornar qualquer elemento da lista, enquanto findFirst() sempre retorna o primeiro elemento.

Um abraço e bons estudos.