Startseite / Streams / Stream.mapMulti()
Streams Fortgeschritten

Stream.mapMulti()

Null oder mehr Elemente pro Eingabe ausgeben, ohne Zwischen-Streams zu erstellen.

Code-Vergleich
✕ Java 8 
stream.flatMap(order ->
    order.items().stream()
        .map(item -> new OrderItem(
            order.id(), item)
        )
);
✓ Java 16+ 
stream.<OrderItem>mapMulti(
    (order, downstream) -> {
        for (var item : order.items())
            downstream.accept(
                new OrderItem(order.id(), item));
    }
);
Problem mit diesem Code entdeckt? Sag uns Bescheid.
Warum der moderne Weg gewinnt
⚡

Weniger Allokationen

Kein Zwischen-Stream pro Element erstellt.

🎯

Imperativer Stil

Schleifen und Bedingungen direkt verwenden.

📐

Flexibel

Null, eins oder viele Elemente mit voller Kontrolle ausgeben.

Alter Ansatz
flatMap + List
Moderner Ansatz
mapMulti()
Seit JDK
16
Schwierigkeitsgrad
Fortgeschritten
JDK-Unterstützung
Stream.mapMulti()
Verfügbar

Weitgehend verfügbar seit JDK 16 (März 2021)

Wie es funktioniert

mapMulti() ist eine imperative Alternative zu flatMap, die das Erstellen von Zwischen-Stream-Objekten für jedes Element vermeidet. Es ist effizienter, wenn die Abbildung eine kleine Anzahl von Elementen erzeugt.

Zugehörige Dokumentation
Stream.mapMulti() ↗
Verwandte Muster
Streams Fortgeschritten

Stream.iterate() with predicate

Java 8
Stream.iterate(1, n -> n * 2)
    .limit(10)
    .forEach(System.out::println);
// can't stop at a condition
Java 9+
Stream.iterate(
    1,
    n -> n < 1000,
    n -> n * 2
).forEach(IO::println);
// stops when n >= 1000
Hover für Modernes ➜
JDK 9+ →
Streams Einsteiger

Stream.ofNullable()

Java 8
Stream<String> s = val != null
    ? Stream.of(val)
    : Stream.empty();
Java 9+
Stream<String> s =
    Stream.ofNullable(val);
Hover für Modernes ➜
JDK 9+ →
Streams Experte

Stream gatherers

Java 8
// Sliding window: manual implementation
List<List<T>> windows = new ArrayList<>();
for (int i = 0; i <= list.size()-3; i++) {
    windows.add(
        list.subList(i, i + 3));
}
Java 24+
var windows = stream
    .gather(
        Gatherers.windowSliding(3)
    )
    .toList();
Hover für Modernes ➜
JDK 24+ →
Teilen 𝕏 🦋 in ⬡