Quel est l'ellipse (...) pour dans cette signature de méthode?

Question

Dans la documentation d'App Engine, à quoi sert l'ellipse (JID...) dans cette signature de méthode?

public MessageBuilder withRecipientJids(JID... recipientJids)

Quel est le rôle de ces trois points?

Answer 1

Il s'agit de Java varargs. Ils vous permettent de passer un nombre quelconque d'objets d'un type spécifique (dans ce cas, ils sont de type JID).

Dans votre exemple, les appels de fonction suivants seraient valides :

MessageBuilder msgBuilder; //Il devrait probablement y avoir un appel à un constructeur ici ;)
MessageBuilder msgBuilder2;
msgBuilder.withRecipientJids(jid1, jid2);
msgBuilder2.withRecipientJids(jid1, jid2, jid78_a, someOtherJid);

En savoir plus ici : http://java.sun.com/j2se/1.5.0/docs/guide/language/varargs.html

Answer 2

La façon d'utiliser l'ellipsis ou les varargs à l'intérieur de la méthode est comme s'il s'agissait d'un tableau :

public void PrintWithEllipsis(String...setOfStrings) {
    for (String s : setOfStrings)
        System.out.println(s);
}

Cette méthode peut être appelée comme suit :

obj.PrintWithEllipsis(); // ne rien imprimer
obj.PrintWithEllipsis("premier"); // imprime "premier"
obj.PrintWithEllipsis("premier", "deuxième"); // imprime "premier\ndeuxième"

À l'intérieur de PrintWithEllipsis, le type de setOfStrings est un tableau de String. Vous pourriez donc faciliter le travail du compilateur en passant un tableau :

String[] argsVar = {"premier", "deuxième"};
obj.PrintWithEllipsis(argsVar);

Pour les méthodes avec varargs, un paramètre de séquence est traité comme étant un tableau du même type. Donc si deux signatures diffèrent seulement en ce sens que l'une déclare une séquence et l'autre un tableau, comme dans cet exemple :

void process(String[] s){}
void process(String...s){}

alors une erreur de compilation se produit.

Source : La spécification du langage de programmation Java, où le terme technique est variable arity parameter plutôt que le terme courant varargs.

Answer 3

La notation à trois points (...) est en fait empruntée aux mathématiques, et cela signifie "...et ainsi de suite".

Quant à son utilisation en Java, elle représente varargs, ce qui signifie que n'importe quel nombre d'arguments peut être ajouté à l'appel de méthode. Les seules limitations sont que le varargs doit être à la fin de la signature de méthode et qu'il ne peut y en avoir qu'un par méthode.

Answer 4

Voici des varargs qui sont utilisés pour créer une méthode qui reçoit un nombre quelconque d'arguments.

Par exemple, la méthode PrintStream.printf l'utilise, puisque vous ne savez pas combien d'arguments vous utiliserez.

Ils ne peuvent être utilisés qu'en dernière position des arguments.

varargs a été ajouté dans Java 1.5

Answer 5

Cela signifie que la méthode accepte un nombre variable d'arguments ("varargs") de type JID. Dans la méthode, recipientJids est présenté.

Cela est pratique dans les cas où vous avez une méthode qui peut éventuellement gérer plus d'un argument de manière naturelle, et vous permet d'écrire des appels pouvant passer un, deux ou trois paramètres à la même méthode, sans avoir la laideur de créer un tableau à la volée.

Cela permet également des idiomes tels que sprintf en C; voir par exemple String.format().