Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Flux issus de collections : stream(), parallelStream() et List::stream

Créez des flux à partir de collections, distinguez le mode d’exécution de l’ordre des éléments et aplatissez des listes imbriquées avec `List::stream`.

Version : 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 désigne la méthode et Collection.stream() précise sa forme sans paramètre. C’est une méthode d’instance par défaut de java.util.Collection<E>, disponible depuis Java 8. L’appel collection.stream() renvoie un java.util.stream.Stream<E> séquentiel dont la collection est la source. Le flux n’est pas une copie de la collection.

Collection.parallelStream est une autre méthode d’instance par défaut sans paramètre, disponible elle aussi depuis Java 8. L’appel collection.parallelStream() renvoie un flux éventuellement parallèle : l’implémentation par défaut renvoie un flux parallèle, mais une autre peut renvoyer un flux séquentiel. Ne supposez pas que le traitement sera plus rapide. Une liste a un ordre de parcours, quel que soit le mode d’exécution. toList() conserve cet ordre s’il est défini pour le flux et renvoie une liste non modifiable. En mode parallèle, forEach() ne garantit pas cet ordre ; utilisez forEachOrdered() si vous en avez besoin.

List hérite de stream() de Collection. List::stream est une référence non liée à cette méthode d’instance, et non un appel statique. Dans flatMap(List::stream), stream() est appelée sur chaque liste interne, comme dans flatMap(list -> list.stream()). flatMap rassemble les éléments des flux internes en un seul flux à plat.

Les opérations intermédiaires comme flatMap et filter sont évaluées à la demande : une opération terminale telle que toList() déclenche le traitement. Ne réutilisez pas un flux après une opération terminale ; créez un nouveau flux à partir de la collection pour une nouvelle chaîne de traitement. Ne modifiez pas une source qui n’est pas conçue pour les modifications concurrentes pendant le traitement et évitez de modifier un état partagé dans les lambdas.

Exemples

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

Résultat

[4, 2]
[4, 2]

Les deux chaînes aplatissent les listes, gardent les nombres pairs et conservent leur ordre. Les deux lignes attendues sont `[4, 2]` ; ce résultat n’indique pas le nombre de threads utilisés.

Leçons associées

  • Java · Leçon 63 · Débutant · Version : 2
  • Java · Leçon 64 · Débutant · Version : 2
  • Java · Leçon 65 · Débutant · Version : 2
  • Java · Leçon 66 · Débutant · Version : 2
  • Java · Leçon 67 · Débutant · Version : 2
  • Java · Leçon 41 · Intermédiaire · Version : 2
  • Java · Leçon 42 · Intermédiaire · Version : 2
  • Java · Leçon 43 · Intermédiaire · Version : 2
  • Java · Leçon 44 · Intermédiaire · Version : 2
  • Java · Leçon 45 · Intermédiaire · Version : 2
  • Java · Leçon 57 · Intermédiaire · Version : 2

Sources