📌 자바 스트림(Stream) API 활용 정리

📅 날짜

2025년 3월 20일

📝 학습 내용

---

✅ 스트림(Stream) API란?

스트림(Stream) API는 자바의 컬렉션(List, Set, Map) 및 배열을 효율적으로 처리할 수 있도록 지원하는 기능이다.
다음과 같은 장점을 제공한다.

🎯 스트림(Stream) API의 주요 특징

1. 간결한 코드: 람다식과 함께 사용하여 코드 가독성을 높일 수 있다.
2. 데이터 변경 없이 처리: 기존 데이터를 변경하지 않고 새로운 데이터를 생성하는 방식.
3. 병렬 처리 지원: .parallelStream()을 사용하면 멀티코어 CPU에서 병렬 연산 가능.
4. 중간 연산과 최종 연산 구분: 데이터를 가공하고 최종적으로 결과를 얻는 연산을 구분할 수 있다.

---

1️⃣ flatMap() - 다차원 리스트를 단일 리스트로 변환 (C02FlatMap.java)

💡 중첩된 리스트의 요소를 펼쳐서 하나의 스트림으로 변환할 때 사용됨.

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class C02FlatMap {
    public static void main(String[] args) {
        // 중첩 리스트 생성
        List<List<Integer>> numbers = Arrays.asList(
            Arrays.asList(1, 2, 3),
            Arrays.asList(4, 5, 6),
            Arrays.asList(7, 8, 9)
        );

        // flatMap을 사용하여 리스트 평탄화
        List<Integer> list = numbers.stream()
                                    .flatMap(List::stream)
                                    .collect(Collectors.toList());

        System.out.println(numbers); // 원본 중첩 리스트 출력
        System.out.println(list);    // 평탄화된 리스트 출력
    }
}

🔹 출력 결과

[[1, 2, 3], [4, 5, 6], [7, 8, 9]]
[1, 2, 3, 4, 5, 6, 7, 8, 9]

---

2️⃣ distinct() - 중복 제거 (C03Distinct.java)

💡 리스트에서 중복된 요소를 제거하고 유일한 요소만 포함된 리스트를 반환함.

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class C03Distinct {
    public static void main(String[] args) {
        List<Integer> list = Arrays.asList(1, 2, 2, 3, 3, 3, 4, 5, 5);
        System.out.println("원본 리스트: " + list);

        // 중복 제거
        List<Integer> distinctedList = list.stream()
                                           .distinct()
                                           .collect(Collectors.toList());

        System.out.println("중복 제거 리스트: " + distinctedList);
    }
}

🔹 출력 결과

원본 리스트: [1, 2, 2, 3, 3, 3, 4, 5, 5]
중복 제거 리스트: [1, 2, 3, 4, 5]

---

3️⃣ sorted() - 정렬 (C04Sorted.java)

💡 리스트 요소를 오름차순으로 정렬할 때 사용됨.

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class C04Sorted {
    public static void main(String[] args) {
        List<Integer> numbers = Arrays.asList(5, 2, 8, 1, 4);

        // 정렬된 리스트 생성
        List<Integer> sortedNumbers = numbers.stream()
                                             .sorted()
                                             .collect(Collectors.toList());

        System.out.println("정렬된 리스트: " + sortedNumbers);
    }
}

🔹 출력 결과

정렬된 리스트: [1, 2, 4, 5, 8]

---

4️⃣ limit() - 특정 개수만 출력 (C05Limited.java)

💡 리스트의 처음 N개의 요소만 선택하여 새로운 리스트를 반환함.

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class C05Limited {
    public static void main(String[] args) {
        List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);

        // 처음 3개의 요소만 선택
        List<Integer> limitedNumbers = numbers.stream()
                                              .limit(3)
                                              .collect(Collectors.toList());

        System.out.println("제한된 리스트: " + limitedNumbers);
    }
}

🔹 출력 결과

제한된 리스트: [1, 2, 3]

---

5️⃣ skip() - 처음 N개 건너뛰기 (C06Skip.java)

💡 앞의 N개의 요소를 제외하고 나머지 요소만 리스트로 반환함.

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class C06Skip {
    public static void main(String[] args) {
        List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);

        // 처음 2개 요소 건너뛰기
        List<Integer> skippedNumbers = numbers.stream()
                                              .skip(2)
                                              .collect(Collectors.toList());

        System.out.println("건너뛴 리스트: " + skippedNumbers);
    }
}

🔹 출력 결과

건너뛴 리스트: [3, 4, 5]

---

6️⃣ 최종 연산 (C07최종연산.java)

💡 스트림에서 데이터를 가공한 후 최종적으로 결과를 출력하는 연산.

✅ 주요 최종 연산

메서드	설명
forEach()	각 요소를 순회하며 실행
collect()	결과를 컬렉션(List, Set)으로 변환
reduce()	모든 요소를 하나의 값으로 결합
min()	최소값 반환
max()	최대값 반환
count()	요소 개수 반환
anyMatch()	특정 조건을 만족하는 요소가 있는지 확인

import java.util.Arrays;
import java.util.List;
import java.util.Optional;
import java.util.Comparator;

public class C07최종연산 {
    public static void main(String[] args) {
        List<Integer> numbers = Arrays.asList(5, 2, 8, 1, 4);

        // 최소값
        Optional<Integer> minNumber = numbers.stream()
                                             .min(Comparator.naturalOrder());
        System.out.println("최소값: " + minNumber.orElse(0));

        // 최대값
        Optional<Integer> maxNumber = numbers.stream()
                                             .max(Comparator.naturalOrder());
        System.out.println("최대값: " + maxNumber.orElse(0));

        // 총 개수
        long count = numbers.stream().count();
        System.out.println("개수: " + count);
    }
}

---

🔥 정리

• flatMap() → 중첩 리스트를 단일 리스트로 변환
• distinct() → 중복 제거
• sorted() → 정렬
• limit() → 처음 N개 선택
• skip() → 처음 N개 제외
• 최종 연산 (min(), max(), count(), reduce()) 활용

---