일급 컬렉션

일급 컬렉션

• 객체지향 생활체조 파트에서 언급된 단어
• 컬렉션(List, Set, Map 등) 필드를 하나만 포함하고, 이를 캡슐화한 클래스
• 단순히 컬렉션을 감싸는 것이 아니라, 컬렉션을 다루는 로직과 불변성을 보장한다
• 컬렉션을 직접 노출하는 문제를 방지하고, 도메인 로직을 응집력 있게 유지할 수 있다

⇒ Java의 객체지향 설계 향상

일급 컬렉션 적용 전

public class Student {
    private String name;
    private List<Integer> scores; // 컬렉션 노출

    public Student(String name, List<Integer> scores) {
        this.name = name;
        this.scores = scores;
    }

    public List<Integer> getScores() {
        return scores; // 컬렉션을 그대로 반환
    }

    public double getAverageScore() {
        return scores.stream().mapToInt(Integer::intValue).average().orElse(0);
    }
}

• getScores()를 통해 List<Integer>가 직접 반환되므로, 외부에서 변경이 가능하다
• 점수 관련 로직이 Student 클래스에 혼재되어 응집도가 떨어진다
• "학생"을 표현하는 객체 Student가 점수 관련 기능까지 책임진다 (단일 책임 원칙 위배)

리스트를 final로 만들면 변경 못하지 않을까?

private final List<Integer> scores;

final은 재할당만 금지할 뿐, List의 메서드는 여전히 사용할 수 있어서 결국 값을 변경할 수 있다.

(새로운 List를 scores에 넣을 순 없지만 List.add(), List.set()은 여전히 동작한다.)

⇒ 아예 List에 접근도 못하게 만들어버리자!

일급 컬렉션 Score 클래스

public class Scores {
    private final List<Integer> scores;

    public Scores(List<Integer> scores) {
        this.scores = List.copyOf(Objects.requireNonNull(scores)); // 불변 리스트 생성
    }

    public double getAverage() {
        return scores.stream().mapToInt(Integer::intValue).average().orElse(0);
    }

    public List<Integer> getTopScores(int threshold) {
        return scores.stream()
                .filter(score -> score >= threshold)
                .collect(Collectors.toList());
    }

    public List<Integer> getScores() {
        return Collections.unmodifiableList(scores); // 불변 리스트 반환
    }

    @Override
    public String toString() {
        return scores.toString();
    }
}

public class Student {
    private String name;
    private Scores scores; // 일급 컬렉션 사용

    public Student(String name, List<Integer> scores) {
        this.name = name;
        this.scores = new Scores(scores);
    }

    public double getAverageScore() {
        return scores.getAverage();
    }

    public List<Integer> getTopScores(int threshold) {
        return scores.getTopScores(threshold);
    }
}

• 불변성 유지, 컬렉션 캡슐화, 객체의 책임 분리가 가능해졌다
• 도메인 로직이 한 곳에 모여 응집도가 높아지고 유지보수가 쉬워졌다
• 불필요한 외부 수정 위험을 줄여 안전한 코드를 작성할 수 있다

⇒ 결론: 컬렉션을 직접 다루지 말고, 일급 컬렉션으로 활용하면 좋다!