TryRpc

تنفيذ دفعات من طلبات RPC.

تقوم هذه العملية بشكل غير متزامن بتنفيذ طلب RPC واحد أو مجموعة من الطلبات. يتم تحديد طلبات RPC بواسطة ثلاث معلمات رئيسية:

- "العنوان" (المضيف + المنفذ أو عنوان BNS للطلب) - "الطريقة" (اسم الطريقة للطلب) - "الطلب" (سلسلة أولية متسلسلة، أو متجه السلاسل، لوسيطة طلب RPC).

على سبيل المثال، إذا كان لديك خدمة RPC تعمل على المنفذ localhost:2345، وتم تكوين واجهتها باستخدام الإعلان الأولي التالي:

service MyService {
   rpc MyMethod(MyRequestProto) returns (MyResponseProto) {
   
 };
 }

، فقم باستدعاء هذه العملية مع الوسائط:

address = "localhost:2345"
 method = "MyService/MyMethod"
 

، موتر "الطلب" هو موتر سلسلة يمثل سلاسل `MyRequestProto` المتسلسلة؛ وسيكون لموتر سلسلة الإخراج `الاستجابة` نفس الشكل ويحتوي (عند الإكمال الناجح) على سلاسل `MyResponseProto` المتسلسلة المقابلة.

على سبيل المثال، لإرسال طلب واحد فارغ، `MyRequestProto`، قم باستدعاء هذه العملية باستخدام `request = ""`. لإرسال 5 طلبات فارغة متوازية ، اتصل بهذه العملية باستخدام `request = [""، ""، ""، ""، ""]`.

بشكل أكثر عمومية، يمكن للمرء إنشاء مجموعة من النماذج الأولية المتسلسلة `MyRequestProto` من موترات مجمعة عادية باستخدام عملية `encode_proto`، وتحويل الاستجابة للنماذج الأولية المتسلسلة `MyResponseProto` إلى موترات مجمعة باستخدام عملية `decode_proto`.

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

على عكس عملية `Rpc` القياسية، إذا فشل الاتصال أو قام العامل البعيد بإرجاع حالة خطأ، فإن هذه العملية لا تؤدي إلى إعادة الاستثناء. بدلاً من ذلك، يتم تعيين إدخال "رمز_الحالة" و"رسالة_الحالة" لاستدعاء RPC المقابل مع الخطأ الذي تم إرجاعه من استدعاء RPC. سيحتوي موتر "الاستجابة" على قيم استجابة صالحة لإدخالات الدفعة الصغيرة التي لم تفشل محاولات RPC الخاصة بها؛ سيكون لبقية الإدخالات سلاسل فارغة.