📦 제네릭 메서드 vs 와일드카드, 언제 뭘 써야 할까?

📦

자바를 공부하면서 여태 제네릭과 와일드카드를 대충 감으로만 잡고 넘어가던 것들을 이번에 공부면서 개념을 탄탄하게 다질 수 있었다.

그런데 제네릭 메서드와 와일드카드 메서드를 각각 언제 쓰는 게 가장 베스트인지에 대한 궁금증이 생겼다.

이 두 방식의 차이와 선택 기준을 깔끔하게 정리해 보았다.

---

 

1. 예제 코드 살펴보기

상위 클래스인 Fruit와 이를 상속받는 Apple, Banana가 있고, 과일을 담는 FruitBox 클래스가 있다.

그리고 이 상자의 정보를 출력해 주는 FruitPrinter 클래스를 작성했다.

public class FruitPrinter {

    // V1: 제네릭 메서드 방식
    public static <T extends Fruit> void printV1(FruitBox<T> box) {
        box.showInfo();
    }

    // V2: 와일드카드 방식
    public static void printV2(FruitBox<? extends Fruit> box) {
        box.showInfo();
    }
}

그리고 이를 실행하는 테스트 코드는 다음과 같다.

public class FruitPrinterTest {

    public static void main(String[] args) {
        FruitBox<Apple> appleBox = new FruitBox<>();
        appleBox.in(new Apple("사과", 1000));

        FruitBox<Banana> bananaBox = new FruitBox<>();
        bananaBox.in(new Banana("바나나", 2000));

        FruitPrinter.printV1(appleBox); // 제네릭 방식
        FruitPrinter.printV2(appleBox); // 와일드카드 방식
    }
}

printV1과 printV2 모두 문제없이 잘 실행된다.

그런데 자바에서는 이처럼 단순히 전달받은 객체를 조회/출력하는 상황에서는

와일드카드 방식인 printV2를 사용하는 것이 더 권장되고 효율적이다. 왜 그럴까?

 

2. 왜 와일드카드가 더 선호될까?

결론부터 말하면 “코드의 간결함과 직관성” 때문이다.

1) 제네릭 메서드 (printV1)

public static <T extends Fruit> void printV1(FruitBox<T> box)

제네릭 메서드는 메서드 리턴 타입 앞부분에 이라는 타입 매개변수 선언부를 필수로 적어줘야 한다.

하지만 이 메서드는 전달받은 box 내부의 showInfo()만 호출하고 끝난다.

즉, 타입 T를 메서드 내부에서 따로 변수로 선언하거나 리턴값으로 재사용할 일이 전혀 없다.

결국 딱 한 번 쓰기 위해 타입 매개변수를 선언하는 불필요한 번거로움(Boilerplate)이 생기는 셈이다.

2) 와일드카드 메서드 (printV2)

public static void printV2(FruitBox<? extends Fruit> box)

반면 와일드카드는 타입 매개변수를 메서드 선언부에 따로 정의할 필요가 없다.

매개변수 위치에 곧바로 ? 를 넣어 작성한다.

이 코드가 의미하는 바는 아주 직관적이다.

“이 메서드는 특정 타입 T가 무엇인지 기억할 필요 없이 Fruit를 상속받은 과일을 담은 FruitBox이기만 하면 다 받아줄게!”

 

가독성도 좋아지고 문법도 훨씬 단순해진다.

3. 핵심 정리: 언제 무엇을 써야 할까?

공부하면서 정리한 나만의 기준은 아래와 같다.

📌 와일드카드를 써야 하는 상황

• 단순히 인자로 넘어온 객체를 조회하거나 사용(읽기)만 할 때
  • 예: printV2처럼 단순히 box.showInfo()를 호출하는 경우
• 타입 매개변수 T가 메서드 내부나 리턴 타입에서 재사용될 필요가 없을 때
• 코드를 짧고 직관적으로 유지하고 싶을 때

📌 제네릭 메서드를 써야 하는 상황

• 여러 매개변수 간의 타입 연계(관계)가 필요할 때

public static <T extends Fruit> void move(FruitBox<T> from, FruitBox<T> to)

위 코드처럼 from과 to가 반드시 동일한 과일 타입이어야 할 때는 제네릭 메서드를 써야 한다.

와일드카드를 쓰면 from은 사과 상자, to는 바나나 상자가 될 수도 있어서 타입 안전성이 깨진다.

• 메서드의 반환 타입이 입력 매개변수의 타입과 연관될 때

public static <T extends Fruit> T getFirstFruit(FruitBox<T> box)

 

       위 코드처럼 상자에서 과일을 꺼내서 그 과일의 타입 그대로 반환해야 한다면 T 선언이 필수적이다.

 

 

마무리

처음엔 와일드카드가 문법만 더 늘어난 느낌이었는데

타입 매개변수의 재사용성 여부와 매개변수 간의 타입 일치 필요성이라는 기준을 세우고 나니 명확해졌다!