Desmistificando as reticências nas assinaturas de métodos

Pergunta:

Na documentação do App Engine, o withRecipientJids a assinatura do método inclui reticências (JID...). Para que serve essa notação de três pontos?

Resposta:

Esses três pontos representam varargs Java (argumentos de comprimento variável). Varargs permitem que você passe qualquer número de objetos de um tipo específico como argumentos de método.

No método withRecipientJids, os varargs permitem que você forneça um número variável de JID objetos como destinatários. Isso significa que você pode usar o método para enviar mensagens para vários destinatários com comprimentos variados.

Por exemplo, as seguintes chamadas de função são válidas:

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

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

Na primeira chamada, o método leva dois destinatários. Na segunda chamada, são necessários quatro destinatários. Os varargs permitem que o método aceite qualquer número de objetos JID como argumentos.

Sintaxe dos Varargs:

Varargs são denotados pelos três pontos notação após o tipo de argumento, como visto em:

public void myMethod(int... numbers)

Esta assinatura indica que o método myMethod pode receber qualquer número de argumentos int.

Recursos adicionais:

Para uma explicação mais detalhada dos varargs Java, consulte a documentação oficial:

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