揭秘方法签名中的省略号

问题：

在 App Engine 文档中，withRecipientJids 方法签名包含省略号 (JID...)。这个三点符号的作用是什么？

答案：

这三个点代表 Java varargs（可变长度参数）。可变参数允许您将任意数量的特定类型的对象作为方法参数传递。

在 withRecipientJids 方法中，可变参数允许您提供可变数量的 JID 对象作为接收者。这意味着您可以使用该方法将消息发送给多个不同长度的收件人。

例如，以下函数调用都是有效的：

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

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

在第一次调用中，该方法采用两个收件人。在第二次通话中，需要四位接收者。可变参数允许方法接受任意数量的 JID 对象作为参数。

可变参数语法：

可变参数由三点表示参数类型后面的符号，如：

public void myMethod(int... numbers)

此签名表明 myMethod 方法可以采用任意数量的 int 参数。

更多资源：

关于Java varargs更详细的解释，参考官方文档：

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