Раскрытие многоточия в сигнатурах методов

Вопрос:

В документации App Engine withRecipientJids сигнатура метода включает многоточие (JID...). Какой цели служит эта трехточечная запись?

Ответ:

Эти три точки представляют собой переменные аргументы Java (аргументы переменной длины). Переменные аргументы позволяют передавать любое количество объектов определенного типа в качестве аргументов метода.

В методе withRecipientJids переменные аргументы позволяют предоставлять переменное количество JID объекты в качестве получателей. Это означает, что вы можете использовать этот метод для отправки сообщений нескольким получателям различной длины.

Например, допустимы оба следующих вызова функций:

MessageBuilder msgBuilder = new MessageBuilder();
msgBuilder.withRecipientJids(jid1, jid2);

MessageBuilder msgBuilder2 = new MessageBuilder();
msgBuilder2.withRecipientJids(jid1, jid2, jid78_a, someOtherJid);

При первом вызове метод принимает двух получателей. Во втором вызове требуется четыре получателя. Переменные аргументы позволяют методу принимать любое количество объектов JID в качестве аргументов.

Переменные аргументы Синтаксис:

Переменные аргументы обозначаются тремя точками обозначение после типа аргумента, как показано в:

public void myMethod(int... numbers)

Эта подпись указывает, что метод myMethod может принимать любое количество аргументов int.

Дополнительные ресурсы:

Более подробное объяснение переменных Java см. в официальном документация:

• [Java Varargs](https://docs.oracle.com/javase/tutorial/java/javaOO/arguments.html#variable)