아이템 53. 가변인수는 신중히 사용하라. - ksw6169/effective-java GitHub Wiki

가변인수(varargs) 메소드

가변인수 메소드는 명시한 타입의 인수를 0개 이상 받을 수 있다.
가변인수 메소드를 호출하면 인수의 개수와 길이가 같은 배열을 만들어 인수들을 저장하고 가변인수 메소드에 건네준다.
가변인수는 인수 개수가 정해지지 않았을 때 아주 유용하다.
가변인수가 적용된 예로는 System.out.printf, 리플렉션 등이 있다.

public PrintStream printf(String format, Object ... args) {
    ...
}

public Method getMethod(String name, Class<?>... parameterTypes)
        throws NoSuchMethodException, SecurityException {
    ...
}

예제 - 최솟값을 찾는 메소드

다음은 최솟값을 찾는 메소드로 인수를 최소한 하나 이상 받아야 되기 때문에 인수를 0개만 받을 수 있도록 설계하는 건 좋지 않다.

static int min(int... args) {
    if (args.length == 0)
        throw new IllegalArgumentException("인수가 1개 이상 필요합니다.");

    int min = args[0];

    for (int i = 1; i < args.length; i++) {
        if (args[i] < min) {
            min = args[i];
        }
    }

    return min;
}

위 코드의 문제점

인수를 0개만 넣어 호출하면 런타임에 실패한다. (IllegalArgumentException 발생)
가변인수에 대한 유효성 검사를 명시적으로 해야 한다.
min의 초깃값을 Integer.MAX_VALUE로 설정하지 않고는 for-each 문도 사용할 수 없다. (사용할 수는 있으나 첫 번째 요소부터 반복을 하게 되므로 비효율적이다.)

해결책 - 매개변수가 1개 이상 필요하다면 매개변수를 하나 더 추가하라.

가변인수에는 인수를 0개만 넣어도 되므로 매개변수가 최소 1개 이상 필요하다면 매개변수를 하나 더 받도록 하면 된다.
즉, 첫 번째로는 평범한 매개변수를 받고, 가변인수는 두 번째로 받으면 앞의 문제가 말끔히 사라진다.

static int min(int firstArg, int... remainingArgs) {
    int min = firstArg;

    for (int arg : remainingArgs) {
        if (arg < min) {
            min = arg;
        }
    }

    return min;
}

성능에 민감하다면 점층적 생성자 패턴을 이용하라.

성능에 민감한 상황이라면 가변인수가 걸림돌이 될 수 있다.
가변인수 메소드는 호출될 때마다 배열을 새로 하나 할당하고 초기화하기 때문이다.
따라서 가변인수의 유연성이 필요하면서 성능을 개선시키고 싶다면 점층적 생성자 패턴을 사용하자.
예를 들어 해당 메소드 호출의 95%가 인수를 3개 이하로 사용한다고 가정하면 다음처럼 인수가 0개인 것부터 4개인 것까지, 총 5개를 다중 정의해서 제공하는 것이다. (이러한 상황에 점층적 생성자 패턴이 성능을 최적화시켜줄 수 있다.)

public void foo() { }
public void foo(int a1) { }
public void foo(int a1, int a2) { }
public void foo(int a1, int a2, int a3) { }

// 위에서 언급했던 상황대로라면 메소드 호출 중 단 5%만이 배열을 생성한다.
public void foo(int a1, int a2, int a3, int... rest) { }

EnumSet 의 정적 팩토리도 이 기법을 사용해 열거 타입 집합 생성 비용을 최소화하였다.

public static <E extends Enum<E>> EnumSet<E> of(E e) { }
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2) { }
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3) { }
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4) { }
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4, E e5) { }
public static <E extends Enum<E>> EnumSet<E> of(E first, E... rest) { }

참고 자료

Effective Java 3/E