Desmitificando los puntos suspensivos en las firmas de métodos

Pregunta:

En la documentación de App Engine, el withRecipientJids la firma del método incluye puntos suspensivos (JID...). ¿Para qué sirve esta notación de tres puntos?

Respuesta:

Esos tres puntos representan varargs de Java (argumentos de longitud variable). Los varargs le permiten pasar cualquier número de objetos de un tipo específico como argumentos del método.

En el método withRecipientJids, los varargs le permiten proporcionar un número variable de JID objetos como destinatarios. Esto significa que puede usar el método para enviar mensajes a múltiples destinatarios con diferentes longitudes.

Por ejemplo, las siguientes llamadas a funciones son válidas:

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

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

En la primera llamada, el método toma dos destinatarios. En la segunda convocatoria se necesitan cuatro destinatarios. Los varargs permiten que el método acepte cualquier número de objetos JID como argumentos.

Sintaxis de Varargs:

Los varargs se indican con tres puntos notación después del tipo de argumento, como se ve en:

public void myMethod(int... numbers)

Esta firma indica que el método myMethod puede tomar cualquier número de int argumentos.

Recursos adicionales:

Para obtener una explicación más detallada de Java varargs, consulte la documentación oficial:

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