إزالة الغموض عن علامات الحذف في توقيعات الطريقة

سؤال:

ضمن وثائق App Engine، مع RecipientJids يتضمن توقيع الطريقة علامة حذف (JID...). ما الغرض الذي يخدمه هذا الترميز ثلاثي النقاط؟

الإجابة:

تمثل هذه النقاط الثلاث Java varargs (وسائط متغيرة الطول). تسمح لك Varargs بتمرير أي عدد من الكائنات من نوع معين كوسيطات للأسلوب.

طريقة

withRecipientJids، تسمح لك varargs بتوفير عدد متغير من JID الكائنات كمستلمين. هذا يعني أنه يمكنك استخدام الطريقة لإرسال رسائل إلى عدة مستلمين بأطوال مختلفة.

على سبيل المثال، استدعاءات الوظائف التالية صالحة:

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);

في الاستدعاء الأول، تأخذ الطريقة مستلمين اثنين. وفي المكالمة الثانية، يستغرق الأمر أربعة مستلمين. تسمح varargs للطريقة بقبول أي عدد من كائنات

JID كوسيطات.

بناء جملة Varargs:

يُشار إلى Varargs بالنقاط الثلاث تدوين بعد نوع الوسيطة، كما هو موضح في:

public void myMethod(int... أرقام)

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

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

يشير هذا التوقيع إلى أن طريقة

myMethod يمكن أن تأخذ أي عدد من الوسائط int.

مزيد من الموارد:

للحصول على شرح أكثر تفصيلاً لـ Java varargs، راجع الوثائق الرسمية:

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