Die Ellipse in Methodensignaturen entmystifizieren

Frage:

In der App Engine-Dokumentation wird das withRecipientJids[ Die Signatur der Methode &&&] enthält Auslassungspunkte (JID...). Welchem ​​Zweck dient diese Drei-Punkte-Notation?

Antwort:

Diese drei Punkte stellen Java-Varargs (Argumente variabler Länge) dar. Mit Varargs können Sie eine beliebige Anzahl von Objekten eines bestimmten Typs als Methodenargumente übergeben.

In der Methode

withRecipientJids können Sie mit den Varargs eine variable Anzahl von JIDs bereitstellen. ]-Objekte als Empfänger. Dies bedeutet, dass Sie mit der Methode Mitteilungen unterschiedlicher Länge an mehrere Empfänger senden können.

Zum Beispiel sind die folgenden Funktionsaufrufe beide gültig:

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

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

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

Im ersten Aufruf akzeptiert die Methode zwei Empfänger. Beim zweiten Anruf sind es vier Empfänger. Die Varargs ermöglichen es der Methode, eine beliebige Anzahl von

JID-Objekten als Argumente zu akzeptieren.

Varargs-Syntax:

Varargs werden durch den Dreipunkt gekennzeichnet Notation nach dem Argumenttyp, wie in:

public void myMethod(int...) zu sehen ist. Zahlen)

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

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

Diese Signatur gibt an, dass die Methode

myMethod eine beliebige Anzahl von int Argumenten annehmen kann.

Weitere Ressourcen:

Eine ausführlichere Erklärung von Java-Varargs finden Sie im offiziellen Dokumentation:

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