Поддержка переменного числа аргументов (varargs) была добавлена в Java, начиная с версии JDK 5 (Java 5). До этого программисту приходилось либо перегружать методы для разного количества параметров, либо передавать массив аргументов вручную.

Иными словами - если у Вас возникает случай, что в метод может поступать неопределенное количество параметров, в том числе и разного типа, но метод должен быть только ОДИН - Varargs Ваш выбор 🤙

void foo(Object... data) { /*...*/ }

void foo(Object[] data) { /*...*/ }

public static void printStrings(String... words) {
    for (String w : words) {
        System.out.print(w + " ");
    }
    System.out.println();
}

// Вызовы:
printStrings("Alice", "Bob");
printStrings("one", "two", "three");

При этом внутри words будет String[] со всеми переданными значениями

public static void printAll(Object... args) {
    for (Object o : args) {
        System.out.print(o + " ");
    }
    System.out.println();
}

// Вызов:
printAll("Hello", 123, true, new User("Tom"));

Приведение типов и автопакетирование

Метод void m(Object... args) под капотом видит args как Object[]. Если вы ожидаете внутри определённый тип, будьте осторожны с приведением, иначе может возникнуть ClassCastException. Попытка привести Object[] к String[] при неправильном использовании varargs приведёт к ошибке времени выполнения.

Ещё один нюанс – работа с примитивными типами и их обёртками: varargs не применяет автопакетирование к массивам примитивов. То есть если вы ожидаете набор чисел, стоит использовать Integer... вместо int..., иначе передача int[] в параметр типа Object... будет воспринята как единичный объект int[], а не как набор чисел.

Конфликт с перегрузкой методов

Перегрузка методов вместе с varargs может привести к неоднозначности. Так, если объявлены оба метода fun(int... a) и fun(boolean... b), то вызов fun() без аргументов компилятор посчитает неразрешимым, ведь он не может однозначно выбрать, какую версию вызывать.

Аналогично, комбинация fun(int... a) и fun(int n, int... a) приводит к конфликту при вызове fun(1), потому что компилятор не знает, вызвать ли первый метод с одним элементом или второй метод с фиксированным первым параметром. Такие неоднозначности приводят к ошибкам компиляции. Чтобы этого избежать, не перегружайте методы только за счёт varargs: лучше дать методам разные имена или явно менять количество параметров.