ما هي Stream API؟

Question

ما هي Stream API؟

Accepted Answer

تمكّن **Stream API** (Java 8+) من معالجة **ذات طراز وظيفي** للمجموعات — التصفية والتحويل والتجميع عبر سلسلة من العمليات، معبّرة بشكل تصريحي (*ماذا* تفعل) بدلاً من الحلقات الصريحة (*كيف*). ## الأسلوب الإجرائي مقابل Stream ```java // ❌ imperative — explicit loop, mutable accumulator List result = new ArrayList<>(); for (Person p : people) { if (p.getAge() >= 18) { result.add(p.getName().toUpperCase()); } } // ✅ stream — declarative pipeline, reads like a description of the transformation List result = people.stream() .filter(p -> p.getAge() >= 18) // keep adults .map(p -> p.getName().toUpperCase()) // extract + transform names .collect(Collectors.toList()); // gather into a list ``` إصدار stream يعبر عن النية بوضوح كسلسلة من العمليات، بدون حلقة يدوية أو مراكم. ## بنية خط الأنابيب ```text Source → Intermediate operations (lazy) → Terminal operation (triggers execution) ``` ```java stream() // source .filter(...) .map(...) // intermediate — lazy, return a new stream, chainable .collect(...) // terminal — produces a result, RUNS the pipeline ``` العمليات **الوسيطة** (filter, map, sorted, distinct) هي **كسولة** — تبني خط الأنابيب لكن لا تنفذ إلا عندما تُطلق عملية **نهائية** (collect, forEach, reduce, count) على ذلك. ## العمليات الشائعة ```java list.stream() .filter(x -> x > 0) // keep matching .map(x -> x * 2) // transform each .sorted() // sort .distinct() // remove duplicates .limit(10) // take first 10 .collect(Collectors.toList()); // aggregations int sum = nums.stream().mapToInt(Integer::intValue).sum(); long count = list.stream().filter(...).count(); Optional first = people.stream().filter(...).findFirst(); boolean any = list.stream().anyMatch(x -> x > 100); // grouping (very powerful) Map> byCity = people.stream().collect(Collectors.groupingBy(Person::getCity)); ``` ## reduce — الطي إلى قيمة واحدة ```java int total = nums.stream().reduce(0, (a, b) -> a + b); // sum via reduction ``` ## الـ streams المتوازية ```java list.parallelStream().filter(...).collect(...); // process across multiple cores // ⚠️ use only for large data + independent/stateless operations; measure first ``` ## لماذا يهم غيّرت Stream API طريقة معالجة Java للبيانات — استبدال الحلقات المملة والخطأ مع خطوط أنابيب موجزة وقابلة للقراءة وتصريحية للتصفية والتحويل والفرز والتجميع والتجميع. يتم استخدامها بكثرة في Java الحديثة لمعالجة البيانات، مما يجعل نية الكود أوضح، وتندمج مع lambdas ومراجع الطرق للأسلوب الوظيفي. فهم نموذج الوسيطة الكسولة / النهائية المتحمسة والعمليات الشائعة (filter/map/collect/reduce/groupingBy) وخيار الـ streams المتوازية (مع تحذيراتها) أمر أساسي لكتابة Java حديثة حسب الأسلوب. الـ streams هي زيادة في الإنتاجية وموضوع متكرر في المقابلات، مما يعكس الطلاقة في ممارسات Java الحالية.