Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Proudy z kolekcí: stream(), parallelStream() a List::stream

Vytvářejte proudy z kolekcí, rozlišujte režim zpracování od pořadí prvků a pomocí `List::stream` převádějte vnořené seznamy na jeden plochý proud.

Verze: Java SE 21

Syntaxe

// 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 označuje metodu, zatímco Collection.stream() upřesňuje její podobu bez parametrů. Jde o výchozí metodu instance rozhraní java.util.Collection<E>, dostupnou od Javy 8. Volání collection.stream() vrátí sekvenční java.util.stream.Stream<E>, jehož zdrojem je kolekce. Proud není kopií kolekce.

Collection.parallelStream je další výchozí metoda instance bez parametrů, rovněž dostupná od Javy 8. Volání collection.parallelStream() vrátí proud, který může být paralelní: výchozí implementace vrací paralelní proud, ale jiná smí vrátit sekvenční. Nepředpokládejte zrychlení. Seznam má dané pořadí průchodu prvky bez ohledu na režim zpracování. toList() toto pořadí zachová, pokud je u proudu definováno, a vrátí neměnitelný seznam. V paralelním režimu forEach() toto pořadí nezaručuje; chcete-li ho dodržet, použijte forEachOrdered().

List dědí stream() z Collection. List::stream je nevázaný odkaz na tuto metodu instance, nikoli statické volání. V flatMap(List::stream) se metoda stream() volá nad každým vnitřním seznamem, stejně jako v flatMap(list -> list.stream()). flatMap spojí prvky vnitřních proudů do jednoho plochého proudu.

Mezilehlé operace jako flatMap a filter se vyhodnocují odloženě: zpracování spustí až koncová operace, například toList(). Po koncové operaci tentýž proud znovu nepoužívejte; pro nový řetězec operací si z kolekce vyžádejte nový proud. Během zpracování neměňte zdroj, který není určený pro souběžné změny, a v lambda výrazech se vyhněte změnám sdíleného stavu.

Příklady

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);
    }
}

Výsledek

[4, 2]
[4, 2]

Oba řetězce spojí prvky seznamů do jednoho proudu, ponechají sudá čísla a zachovají jejich pořadí. Na obou řádcích se očekává `[4, 2]`; výstup neukazuje počet použitých vláken.

Související lekce

  • Java · Lekce 63 · Základní · Verze: 2
  • Java · Lekce 64 · Základní · Verze: 2
  • Java · Lekce 65 · Základní · Verze: 2
  • Java · Lekce 66 · Základní · Verze: 2
  • Java · Lekce 67 · Základní · Verze: 2
  • Java · Lekce 41 · Středně pokročilá · Verze: 2
  • Java · Lekce 42 · Středně pokročilá · Verze: 2
  • Java · Lekce 43 · Středně pokročilá · Verze: 2
  • Java · Lekce 44 · Středně pokročilá · Verze: 2
  • Java · Lekce 45 · Středně pokročilá · Verze: 2
  • Java · Lekce 57 · Středně pokročilá · Verze: 2

Zdroje