استدعاء المعاملات

يتم استخدام استدعاء المعاملات لاستدعاء أمر مجموعة واحد أو أكثر على العقدة المستهدفة. وهو يشبه استدعاءات الإجراءات عن بُعد التي تم إجراؤها لأمر محدد في المجموعة.

وبطريقة مماثلة لكتابة المعاملات، يمكنك استدعاء المعاملات بالوقت والمعاملات غير المحددة بوقت. يُرجى الرجوع إلى قسم الإجراءات المحدَّدة زمنيًا وغير المحدّدة زمنيًا للحصول على مزيد من المعلومات عن المعاملات المحدَّدة زمنيًا.

معاملة استدعاء غير محددة الوقت

تسلسل عمليات لمعاملة استدعاء غير محدّدة بوقت
الشكل 1: معاملة الاستدعاء غير المحدّد بوقت

استدعاء إجراء الطلب

الاتجاه: بادئ التشغيل -> الهدف

على غرار "إجراء طلب القراءة" و"إجراء طلب الكتابة"، يوفّر البادئ الهدف في هذا الإجراء ما يلي:

  • طلبات استدعاء: قائمة بمسارات أوامر المجموعة، بالإضافة إلى وسيطات اختيارية للأوامر، تسمى حقول الأوامر.
  • طلب محدد زمنيًا: علامة تشير إلى ما إذا كان هذا الإجراء جزءًا من معاملة استدعاء محدد زمنيًا.
  • إيقاف الاستجابة: علامة تشير إلى ما إذا كان يجب إلغاء إجراء الاستجابة للاستدعاء
  • رقم تعريف التفاعل: عدد صحيح يُستخدم لمطابقة إجراء طلب الاستدعاء مع إجراء الاستجابة للاستدعاء.

استدعاء إجراء الاستجابة

الاتجاه: الهدف -> المُنشئ

بعد أن يتلقى "الهدف" إجراء طلب الاستدعاء، فإنه سينهي المعاملة بإجراء استجابة للاستدعاء يتضمن ما يلي:

  • استدعاءات الردود: قائمة باستجابات أو حالة الأوامر لكل طلب استدعاء تم إرساله.
  • معرّف التفاعل: عدد صحيح يُستخدم لمطابقة إجراء الاستجابة للاستدعاء مع إجراء طلب الاستدعاء.

قيود الاستدعاء غير المحددة زمنيًا

قد يكون إجراء طلب الاستدعاء عبارة عن بث جماعي، ولكن في هذه الحالة يجب ضبط علامة إيقاف الاستجابة. السبب المنطقي هو أنه بخلاف ذلك قد تمتلئ الشبكة بردود متزامنة من كل عضو في المجموعة.

لتفعيل هذا السلوك، قد يحتوي المسار المستخدَم في قائمة "طلبات الاستدعاء" على "مجموعات"، وقد يحتوي بدلاً من ذلك على أحرف بدل، ولكن على حقل "نقطة النهاية" فقط. علاوة على ذلك، إذا تم إرسال الإجراء بشكل جماعي، تنتهي هذه المعاملة بدون استجابة.

معاملات الاستدعاء المحددة زمنيًا

كما هي الحال مع معاملات الكتابة في وقت محدد، تبدأ أيضًا معاملات الاستدعاء بوقت محدّد بـ "إجراء الطلب المحدد بزمن".

تسلسل عمليات لمعاملة استدعاء محدد زمنيًا
الشكل 2: معاملة الاستدعاء بوقت محدّد

إجراء الطلب المحدد بزمن

الاتجاه: بادئ التشغيل -> الهدف

يبدأ البادئ المعاملة التي ترسل هذا الإجراء الذي يحتوي على:

  • المهلة: عدد المللي ثانية التي يمكن أن تظل هذه المعاملة مفتوحة. خلال هذه الفترة، يُعتبر الإجراء التالي الذي يرسله المُنشئ صالحًا.

بعد تلقّي "إجراء الطلب المحدّد بزمن"، يجب أن يوافق "الهدف" على "إجراء الطلب المحدّد بزمن" مع توفّر "استجابة حالة". عندما يتلقى المُنشئ إجراء الاستجابة للحالة والذي لا يبلّغ عن أي أخطاء، يرسل إجراء طلب استدعاء.

استدعاء إجراء الطلب

تمامًا كما هو موضّح سابقًا في إجراء طلب الاستدعاء.

استدعاء إجراء الاستجابة

تمامًا كما هو موضّح سابقًا في إجراء الاستجابة للاستدعاء.

قيود الاستدعاء المحددة زمنيًا

قد يتم استدعاء جميع أوامر الاستدعاء عند تفاعل محدد الوقت. لا يمكن استخدام إجراء "الطلب المحدّد بزمن" وإجراء طلب الاستدعاء وإجراء الردّ على الاستدعاء Unicastفقط، وبالتالي لا يمكن استخدامهما كتسجيل مجموعات في معاملات الاستدعاء بتوقيت زمني.

يتيح "إجراء طلب الاستدعاء" استخدام المسارات مع "مجموعات Google"، بالإضافة إلى أحرف البدل، إلا أنّ "إجراء الاستجابة للاستدعاء" لا يتيح استخدام أحرف البدل.