Démystifier les points de suspension dans les signatures de méthodes

Question :

Dans la documentation App Engine, le withRecipientJids la signature de la méthode inclut des points de suspension (JID...). À quoi sert cette notation à trois points ?

Réponse :

Ces trois points représentent des varargs Java (arguments de longueur variable). Les varargs vous permettent de transmettre n'importe quel nombre d'objets d'un type spécifique comme arguments de méthode.

Dans la méthode withRecipientJids, les varargs vous permettent de fournir un nombre variable de JID objets en tant que destinataires. Cela signifie que vous pouvez utiliser la méthode pour envoyer des messages à plusieurs destinataires avec des longueurs variables.

Par exemple, les appels de fonction suivants sont tous deux valides :

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

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

Lors du premier appel, la méthode prend deux destinataires. Lors du deuxième appel, il faut quatre destinataires. Les varargs permettent à la méthode d'accepter n'importe quel nombre d'objets JID comme arguments.

Syntaxe des varargs :

Les varargs sont désignés par les trois points notation après le type d'argument, comme indiqué dans :

public void myMethod(int... numbers)

Cette signature indique que la méthode myMethod peut prendre n'importe quel nombre d'arguments int.

Ressources supplémentaires :

Pour une description plus détaillée explication des varargs Java, reportez-vous à la documentation officielle :

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