0Pricing
Java Academy · Урок

Параметры переменной длины

Определяйте методы, принимающие списки аргументов переменной длины, и объединяйте их с массивами.

«Параметры переменной длины» — бесплатный урок Java Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Java Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Java Academy содержит 4 уроков всего.

Аргументы переменной длины

Аргументы переменной длины позволяют определять методы, принимающие любое количество аргументов одного типа; внутри метода они обрабатываются как массив.

Объявление аргументов переменной длины

Для параметра переменной длины используйте Type... name. Он должен быть последним параметром, и в методе может быть только один такой параметр.

static int sum(int... numbers) {
    int total = 0;
    for (int n : numbers) total += n;
    return total;
}

System.out.println(sum());           // 0 (empty array)
System.out.println(sum(1));          // 1
System.out.println(sum(1, 2, 3));    // 6
System.out.println(sum(1, 2, 3, 4)); // 10

// Can also pass an array
int[] arr = {5, 10, 15};
System.out.println(sum(arr));        // 30

Аргументы переменной длины внутри метода

Аргументы переменной длины — это синтаксический сахар. Компилятор преобразует вызов в создание массива непосредственно в месте вызова.

// Calling: sum(1, 2, 3)
// Compiler generates: sum(new int[]{1, 2, 3})

static void printAll(String label, String... items) {
    System.out.println(label + ":");
    for (String item : items) System.out.println("  - " + item);
}

printAll("Fruits", "Apple", "Banana", "Cherry");
// Fruits:
//   - Apple
//   - Banana
//   - Cherry

printAll("Empty"); // varargs is empty array

Обычные параметры и аргументы переменной длины

Параметр переменной длины должен быть последним. Перед ним можно указывать обычные параметры.

static double average(String label, double... values) {
    if (values.length == 0) return 0.0;
    double sum = 0;
    for (double v : values) sum += v;
    double avg = sum / values.length;
    System.out.printf("%s average: %.2f%n", label, avg);
    return avg;
}

average("Math scores", 92.0, 85.5, 78.0, 95.0);
// Math scores average: 87.62

average("Single value", 100.0);
// Single value average: 100.00

Аргументы переменной длины и обобщённые типы

Использование аргументов переменной длины с обобщёнными типами вызывает предупреждение о загрязнении кучи. Подавите его с помощью @SafeVarargs, если безопасность метода можно доказать.

import java.util.Arrays;
import java.util.List;

@SafeVarargs  // suppresses heap pollution warning
static <T> List<T> listOf(T... elements) {
    return Arrays.asList(elements); // safe: we don't store to the array
}

List<String> names = listOf("Alice", "Bob", "Charlie");
System.out.println(names); // [Alice, Bob, Charlie]

List<Integer> scores = listOf(95, 87, 73);
System.out.println(scores); // [95, 87, 73]

Аргументы переменной длины и перегрузка

Если у метода с аргументами переменной длины есть перегруженный вариант с точным совпадением, предпочтение отдаётся точному совпадению. Аргументы переменной длины используются в последнюю очередь.

static void log(String msg)         { System.out.println("1-arg: " + msg); }
static void log(String m1, String m2) { System.out.println("2-arg: " + m1 + ", " + m2); }
static void log(String... msgs)        { System.out.println("varargs: " + msgs.length); }

log("hello");          // 1-arg: hello
log("a", "b");         // 2-arg: a, b
log("a", "b", "c");   // varargs: 3
log();                  // varargs: 0

printf использует аргументы переменной длины

System.out.printf использует аргументы переменной длины — он принимает строку формата и любое количество аргументов любого типа.

// printf signature: printf(String format, Object... args)
System.out.printf("%s ordered %d items for $%.2f%n",
    "Alice", 3, 59.97);
// Alice ordered 3 items for $59.97

// String.format is also varargs
String msg = String.format("Error %d: %s", 404, "Not Found");
System.out.println(msg); // Error 404: Not Found

Создание средства журналирования с аргументами переменной длины

Реализация простого структурированного средства журналирования, принимающего пары «ключ–значение» с помощью аргументов переменной длины.

static void logEvent(String event, Object... keyValues) {
    if (keyValues.length % 2 != 0)
        throw new IllegalArgumentException("Key-value pairs required");
    StringBuilder sb = new StringBuilder(event);
    for (int i = 0; i < keyValues.length; i += 2)
        sb.append(" ").append(keyValues[i]).append("=").append(keyValues[i+1]);
    System.out.println(sb);
}

logEvent("user.login",  "userId", 42, "ip", "192.168.1.1", "success", true);
// user.login userId=42 ip=192.168.1.1 success=true

Особенности производительности

Каждый вызов с аргументами переменной длины создаёт новый массив в куче. Для часто вызываемых вспомогательных методов предоставляйте варианты с фиксированным количеством аргументов, чтобы избежать выделения памяти.

// Java's own EnumSet does this:
static <E extends Enum<E>> EnumSet<E> of(E e)              { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E e2)       { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3) { ... }
static <E extends Enum<E>> EnumSet<E> of(E e1, E... rest)  { ... }
// Avoids array creation for 1-3 args (most common case)

// Apply the same pattern to your own hot-path APIs:
static void report(String msg)             { log(new String[]{msg}); }
static void report(String m1, String m2)   { log(new String[]{m1, m2}); }
static void report(String... msgs)         { log(msgs); }

Аргументы переменной длины и пустое значение

Передача null методу с аргументами переменной длины неоднозначна: Java может интерпретировать это значение как пустой массив. Используйте явное приведение типа, чтобы избежать предупреждения.

static void printItems(String... items) {
    if (items == null) {
        System.out.println("null array passed");
        return;
    }
    for (String item : items)
        System.out.println(item != null ? item : "(null element)");
}

printItems((String[]) null); // null array passed
printItems(null, "valid");   // (null element), valid
printItems();                 // empty array (0 items)

Практика: вспомогательный метод форматирования строк

Безопасная обёртка для printf, возвращающая отформатированную строку и использующая аргументы переменной длины в стиле «строка формата — аргументы».

static String fmt(String pattern, Object... args) {
    try {
        return String.format(pattern, args);
    } catch (java.util.IllegalFormatException e) {
        return "[FORMAT ERROR: " + e.getMessage() + "]";
    }
}

System.out.println(fmt("User %s has %d orders", "Alice", 5));
// User Alice has 5 orders

System.out.println(fmt("Invalid %z format", "arg"));
// [FORMAT ERROR: Conversion = 'z' ...]

Быстрая проверка

Каков тип параметра переменной длины внутри тела метода?

Итоги: аргументы переменной длины

Ключевые выводы:

  • Аргументы переменной длины (Type... name) принимают 0 или больше аргументов, которые внутри метода представлены массивом
  • Такой параметр должен быть последним; в методе может быть только один параметр переменной длины
  • Вызывающий код может передавать отдельные значения или массив
  • Используйте @SafeVarargs, чтобы подавить предупреждения о загрязнении кучи для обобщённых аргументов переменной длины
  • Перегруженные методы с точным совпадением имеют приоритет перед вариантами с аргументами переменной длины
  • Для часто вызываемых методов предоставляйте варианты с фиксированным количеством аргументов, чтобы избежать создания массивов

Часто задаваемые вопросы

Урок «Параметры переменной длины» бесплатный?

Да — полный текст урока «Параметры переменной длины» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Java Academy, подпишись на CoddyKit PRO. Курс Java Academy содержит 4 уроков всего.

Чему я научусь в уроке «Параметры переменной длины»?

Определяйте методы, принимающие списки аргументов переменной длины, и объединяйте их с массивами. Ты практикуешь Java Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Java Academy?

Предыдущий опыт не требуется. Java Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «Параметры переменной длины»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Java Academy?

Да. Каждый урок Java Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Правила перегрузки методов
  2. Параметры переменной длины
  3. Статические поля и константы
  4. Вспомогательные классы и статические фабричные методы
← Назад к Java Academy