الرئيسية / Streams / Stream.mapMulti()
Streams متوسط

Stream.mapMulti()

أصدر صفراً أو أكثر من العناصر لكل إدخال دون إنشاء Streams وسيطة.

مقارنة الكود
✕ 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));
    }
);
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
⚡

تخصيص أقل

لا Stream وسيطة تُنشأ لكل عنصر.

🎯

أسلوب إمراطي

استخدم الحلقات والشروط مباشرةً.

📐

مرن

أصدر صفراً أو واحداً أو عناصر كثيرة بتحكم كامل.

الأسلوب القديم
flatMap + List
الأسلوب الحديث
mapMulti()
منذ JDK
16
الصعوبة
متوسط
دعم JDK
Stream.mapMulti()
متاح

متاح على نطاق واسع منذ JDK 16 (مارس 2021)

كيف يعمل

mapMulti() بديل إمراطي لـ flatMap يتجنّب إنشاء كائنات Stream وسيطة لكل عنصر. أكثر كفاءةً عندما ينتج التعيين عدداً صغيراً من العناصر.

توثيق ذو صلة
Stream.mapMulti() ↗
أنماط ذات صلة
Streams متوسط

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
مرر للرؤية الحديث ←
JDK 9+ →
Streams مبتدئ

Stream.ofNullable()

Java 8
Stream<String> s = val != null
    ? Stream.of(val)
    : Stream.empty();
Java 9+
Stream<String> s =
    Stream.ofNullable(val);
مرر للرؤية الحديث ←
JDK 9+ →
Streams متقدم

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();
مرر للرؤية الحديث ←
JDK 24+ →
مشاركة 𝕏 🦋 in ⬡