Java Steam

Java 的 Stream 是 Java 8 引入的一個強大工具，可以讓你更簡潔地操作集合資料（像 List, Set 等），類似 Python 的串列推導式或函數式操作。

以下是 Java Stream 最常見的操作整理（附範例）：

🔹 基本結構

List<Integer> list = Arrays.asList(1, 2, 3, 4, 5);
list.stream()
    .filter(x -> x % 2 == 0)
    .map(x -> x * 10)
    .forEach(System.out::println);

✅ 常見操作總表（分類 + 範例）

🔸 1. 建立 Stream

Stream.of(1, 2, 3);
Arrays.asList(1, 2, 3).stream();
IntStream.range(1, 5);  // 1, 2, 3, 4

---

🔸 2. filter：過濾元素

list.stream().filter(x -> x > 3);

---

🔸 3. map：轉換元素

list.stream().map(x -> x * 2);

---

🔸 4. forEach：對每個元素做事（終端操作）

list.stream().forEach(System.out::println);

---

🔸 5. collect：收集成 List / Set / Map

collect() 是 終端操作，用於把 Stream 的元素彙整成集合、字串或其他結果。它搭配 Collectors 工具類使用，能做各種聚合。以下整理常見且實用的模式。

基礎收集

用法	說明	範例
Collectors.toList()	收集到 List	list.stream().collect(Collectors.toList())
Collectors.toSet()	收集到 Set (去重)	list.stream().collect(Collectors.toSet())
Collectors.toCollection(...)	自訂集合型別	list.stream().collect(Collectors.toCollection(LinkedList::new))

更多計巧

字串連接

用法	說明
Collectors.joining()	直接連接所有元素字串
Collectors.joining(", ")	以分隔符連接
Collectors.joining(", ", "[", "]")	加前後綴

List<String> names = Arrays.asList("A","B","C");
String s = names.stream().collect(Collectors.joining(", ", "[", "]"));
// 輸出 [A, B, C]

這些都是 Collectors 裡面專門做統計運算的收集器，用於 stream.collect(...) 來一次得到數量、總和、平均等結果。以下逐一解釋並附範例：

---

統計

1. Collectors.summingInt(x -> x)

計算整數總和。x -> x 代表取元素本身，如果是物件可改成 p -> p.getAge()。

List<Integer> list = new ArrayList<>(List.of(3, 5 ,7));
int sum = list.stream().collect(Collectors.summingInt(x -> x));
System.out.println(sum);     // 15 (3+5+7)

1. Collectors.averagingInt(x -> x)

計算平均值，結果型別為 Double。

double avg = list.stream().collect(Collectors.averagingInt(x -> x));
System.out.println(avg);     // 5.0

3. Collectors.summarizingInt(x -> x)

一次取得所有統計資訊，結果型別為 IntSummaryStatistics。

IntSummaryStatistics stats =
    list.stream().collect(Collectors.summarizingInt(x -> x));
System.out.println(stats.getCount());   // 3
System.out.println(stats.getSum());     // 15
System.out.println(stats.getMin());     // 3
System.out.println(stats.getAverage()); // 5.0
System.out.println(stats.getMax());     // 7

分組

用法	說明
Collectors.groupingBy(keyFn)	依 key 分組，value 是 List
Collectors.groupingBy(keyFn, counting())	分組後計數
Collectors.groupingBy(keyFn, mapping(valueFn, toSet()))	分組後轉換並收集

Map<Integer, List<String>> byLength =
    names.stream().collect(Collectors.groupingBy(String::length));

Map<Integer, Long> countByLength =
    names.stream().collect(Collectors.groupingBy(String::length, Collectors.counting()));

分區 (二分法)

partitioningBy(predicate) 將元素分為 true 與 false 兩群：

Map<Boolean, List<Integer>> partition =
    list.stream().collect(Collectors.partitioningBy(x -> x % 2 == 0));

結果例：

true  -> [偶數...]
false -> [奇數...]

轉換成 Map

用法	說明
toMap(keyFn, valueFn)	轉成 Map
toMap(keyFn, valueFn, mergeFn)	key 重複時自訂合併規則
toMap(keyFn, valueFn, mergeFn, mapSupplier)	指定 Map 類型

Map<String, Integer> map =
    list.stream().collect(Collectors.toMap(Object::toString, x -> x));

Map<String, Integer> map = list.stream()
    .collect(Collectors.toMap(
        x -> "key" + x,
        x -> x * x
    ));

連鎖操作

collectingAndThen(downstream, finisher) 收集後再做一次轉換：

List<String> unmodifiable =
    list.stream().collect(Collectors.collectingAndThen(Collectors.toList(),
                                                       Collections::unmodifiableList));

自訂歸納邏輯

可傳入三參數版本 collect(supplier, accumulator, combiner) 不靠 Collectors，完全自訂收集過程：

Set<Integer> set = list.stream()
    .collect(HashSet::new, Set::add, Set::addAll);

• supplier：建立容器
• accumulator：累積單個元素
• combiner：合併部分結果（平行流時用）

記憶法

• 集合 → toList, toSet, toCollection
• 字串 → joining
• 統計 → counting, summingInt, averagingInt, summarizingInt
• 分組/分區 → groupingBy, partitio心ningBy
• Map → toMap
• 後處理 → collectingAndThen

🔸 6. reduce：歸納（加總、乘積、累積）

a(累積值) b(當前元素)

int sum = list.stream().reduce(0, (a, b) -> a + b);

🔸 7. sorted：排序（可加比較器）

對List做排序

list.stream().sorted();
list.stream().sorted(Comparator.reverseOrder());

對Map做排序

map.entrySet().stream()
   .sorted(Map.Entry.comparingByKey())
   .forEach(System.out::println);

// 反排序
map.entrySet().stream()
   .sorted(Map.Entry.comparingByKey(Comparator.reverseOrder()))
   .forEach(System.out::println);

// key 主排序，value 同時相同時才比
map.entrySet().stream()
   .sorted(
       Comparator.comparing(Map.Entry::getKey)      // 先比 key
                 .thenComparing(Map.Entry::getValue) // tie-break 比 value
   )
   .forEach(System.out::println);

// value 主排序，value 相同時才比 key
map.entrySet().stream()
   .sorted(
       Comparator.comparing(Map.Entry::getValue)    // 先比 value
                 .thenComparing(Map.Entry::getKey)  // tie-break 比 key
   )
   .forEach(System.out::println);

// 若要降序，可在主排序加 .reversed()：
Comparator.comparing(Map.Entry::getValue, Comparator.reverseOrder())
          .thenComparing(Map.Entry::getKey)

---

🔸 8. distinct：去重

list.stream().distinct();

---

🔸 9. limit / skip：取前幾個 / 跳過前幾個

list.stream().limit(3); // 取前三個
list.stream().skip(2);  // 跳過前兩個

---

🔸 10. anyMatch / allMatch / noneMatch：條件判斷

list.stream().anyMatch(x -> x > 3);    // 是否有任何一個 > 3 回傳 true
list.stream().allMatch(x -> x > 0);    // 是否全部都 > 0 回傳 true
list.stream().noneMatch(x -> x < 0);   // 是否沒有 < 0 的 回傳 true

---

🔸 11. findFirst / findAny：取得第一個 / 任意一個

Optional<Integer> first = list.stream().findFirst();
Optional<Integer> any = list.stream().findAny();

---

🔸 12. count：統計數量

long count = list.stream().filter(x -> x % 2 == 0).count();

---

📌 小提醒

• Stream 只能使用一次（終端操作後就不能再用）
• Stream 不會改變原本的集合（除非你手動處理）

Contributors

lucashsu95

Changelog

Last edited 24 days ago

View full history

0f947a1-增加SEO封面圖

5a3e2c8-fix: 擴充 Java Stream 操作部分，提供詳細的範例和解釋

1276575-新增關於資料類型、輸入方法和相等性比較的全面 Java 教學