Java | for文 vs Stream API + 実務パターン集（図解ビジュアル版）

「for文フロー + Streamフロー + 実務パターン集」を 矢印・アイコン・カラー付きで一目で理解できる形 にします。

┌───────────────┐
│      データ入力            │
│  List<Employee>           │
└───────────────┘
          │
          ▼
────────── フロー分岐 ──────────
        ┌───────────────┐
        │     for文                 │
        │ 命令的に順番に             │
        │ 処理を記述                 │
        └───────────────┘
          │
          ▼
   ┌─────────────────┐
   │ if (条件) → add              │  ← 条件フィルタ + 変換
   │ result.add(...)              │
   └─────────────────┘
          │
          ▼
┌───────────────────┐
│      結果 result                 │
│ ["ALICE","CHARLIE"]              │
└───────────────────┘
          │
          ▼
        ┌───────────────┐
        │    Stream API            │
        │ 宣言的に処理を             │
        │ チェーンで表現             │
        └───────────────┘
          │
          ▼
┌───────────────────────────────┐
│ employees.stream()                                    │
│      .filter(e -> e.age > 30)                         │ ← 条件抽出
│      .map(Employee::getName)                          │ ← 変換
│      .map(String::toUpperCase)                        │
│      .collect(toList())                               │ ← 結果格納
└───────────────────────────────┘
          │
          ▼
┌───────────────────────┐
│ 結果 filteredStream                     │
│ ["ALICE","CHARLIE"]                     │
└───────────────────────┘

──────────── 実務でよく使うパターン ────────────

1️⃣ filter        → 条件抽出
2️⃣ map           → データ変換
3️⃣ sorted        → 並び替え
4️⃣ mapToInt      → 数値集計(sum/avg/max/min)
5️⃣ groupingBy    → グループ集計
6️⃣ count         → 件数確認
7️⃣ findFirst/Any → 先頭/任意1件取得
8️⃣ distinct      → 重複排除
9️⃣ flatMap       → ネストフラット化

──────────── フローの考え方 ────────────
データ入力
      │
      ▼
中間操作(filter/map/sorted/flatMap)
      │
      ▼
末端操作(toList/count/forEach)
      │
      ▼
結果（リスト・集計・出力）

──────────── 初心者向けコツ ────────────
1. 中間操作は遅延実行
2. 末端操作で初めて処理が実行される
3. 副作用は末端で最小限
4. チェーンで順序を揃えると可読性アップ

ビジュアル強化ポイント

• 矢印でデータの流れを表現
• for文とStream APIを横並び比較
• 中間操作と末端操作を色分け（例：filter/map/flatMap=青、collect/count/forEach=緑）
• パターン集をアイコン付きリスト（集計→電卓、グループ→箱、重複排除→消しゴムなど）

💡 この図解を使えば、初心者でも：

• for文とStream APIの違い
• 中間操作と末端操作のフロー
• 実務でよく使う9つのパターン
• 遅延実行・副作用・集計・グループ化

を一目で理解できます。