メソッド署名の省略記号をわかりやすく説明する

質問:

App Engine ドキュメント内では、withRecipientJids メソッド シグネチャには省略記号 (JID...) が含まれます。この 3 つのドット表記はどのような目的に使用されますか?

答え:

これら 3 つのドットは Java varargs (可変長引数) を表します。可変引数を使用すると、特定の型の任意の数のオブジェクトをメソッド引数として渡すことができます。

withRecipientJids メソッドでは、可変引数を使用して JID の可変数を指定できます。 ] オブジェクトを受信者として指定します。これは、このメソッドを使用して、さまざまな長さで複数の受信者にメンサーゲンを送信できることを意味します。

たとえば、次の関数呼び出しはどちらも有効です。

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

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

最初の呼び出しでは、メソッドは 2 人の受信者を受け取ります。 2 回目の呼び出しでは、4 人の受信者が必要です。可変長引数を使用すると、メソッドは引数として任意の数の JID オブジェクトを受け入れることができます。

可変長引数 構文:

可変長引数は 3 つのドットで示されます。

public void myMethod(int... numbers)

このシグネチャは、myMethod メソッドが任意の数の int 引数を取ることができることを示します。

その他のリソース:

Java 可変長引数の詳細な説明については、公式を参照してください。ドキュメント:

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