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

CKTIS / Java

Fluxos de coleções: stream(), parallelStream() e List::stream

Cria fluxos a partir de coleções, distingue o modo de execução da ordem dos elementos e usa `List::stream` para achatar listas aninhadas.

Versão: Java SE 21

Sintaxe

// Default instance methods declared by java.util.Collection<E>
default Stream<E> stream()
default Stream<E> parallelStream()

// Calls on a Collection<E> instance
collection.stream()
collection.parallelStream()

// Unbound instance method reference for a Stream<List<E>> named lists
lists.flatMap(List::stream)
// Equivalent lambda: lists.flatMap(list -> list.stream())

Collection.stream designa o método e Collection.stream() indica a sua forma sem parâmetros. É um método de instância predefinido de java.util.Collection<E>, disponível desde Java 8. A chamada collection.stream() devolve um java.util.stream.Stream<E> sequencial cuja origem é a coleção. O fluxo não é uma cópia da coleção.

Collection.parallelStream é outro método de instância predefinido sem parâmetros, também disponível desde Java 8. A chamada collection.parallelStream() devolve um fluxo possivelmente paralelo: a implementação predefinida devolve um fluxo paralelo, mas outra pode devolver um sequencial. Não partas do princípio de que será mais rápido. Uma lista tem uma ordem de percurso, independentemente do modo de execução. toList() preserva essa ordem se estiver definida para o fluxo e devolve uma lista não modificável. Em modo paralelo, forEach() não garante essa ordem; usa forEachOrdered() se precisares dela.

List herda stream() de Collection. List::stream é uma referência a esse método de instância sem estar associada a um objeto específico, não uma chamada estática. Em flatMap(List::stream), chama-se stream() sobre cada lista interna, tal como em flatMap(list -> list.stream()). flatMap reúne os elementos dos fluxos internos num único fluxo plano.

As operações intermédias, como flatMap e filter, são avaliadas de forma diferida: uma operação terminal, como toList(), inicia o processamento. Não reutilizes um fluxo após uma operação terminal; obtém um novo fluxo da coleção para outra cadeia de operações. Não alteres uma origem que não admita modificações concorrentes enquanto a cadeia está em execução e evita alterar estado partilhado nas expressões lambda.

Exemplos

import java.util.Collection;
import java.util.List;

public class CollectionStreamsDemo {
    public static void main(String[] args) {
        Collection<List<Integer>> groups = List.of(List.of(3, 4), List.of(2, 1));

        List<Integer> sequential = groups.stream()
                .flatMap(List::stream)
                .filter(n -> n % 2 == 0)
                .toList();

        List<Integer> possiblyParallel = groups.parallelStream()
                .flatMap(List::stream)
                .filter(n -> n % 2 == 0)
                .toList();

        System.out.println(sequential);
        System.out.println(possiblyParallel);
    }
}

Resultado

[4, 2]
[4, 2]

As duas cadeias achatam as listas, mantêm os números pares e preservam a sua ordem. Espera-se `[4, 2]` nas duas linhas; o resultado não mostra quantas threads foram usadas.

Lições relacionadas

  • Java · Lição 63 · Básico · Versão: 2
  • Java · Lição 64 · Básico · Versão: 2
  • Java · Lição 65 · Básico · Versão: 2
  • Java · Lição 66 · Básico · Versão: 2
  • Java · Lição 67 · Básico · Versão: 2
  • Java · Lição 41 · Intermédio · Versão: 2
  • Java · Lição 42 · Intermédio · Versão: 2
  • Java · Lição 43 · Intermédio · Versão: 2
  • Java · Lição 44 · Intermédio · Versão: 2
  • Java · Lição 45 · Intermédio · Versão: 2
  • Java · Lição 57 · Intermédio · Versão: 2

Fontes