Service proxy method class, one for each ClientServerOperation ( ClientServerOperation.fireAndForget ==FALSE) defined in the ServiceInterface in the role method.
يتيح الاستدعاء غير المتزامن لطرق الخدمة ذات القيمة المُرجعة وفحص حالة End-to-End.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 90f1e995b658المصدرأسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يتيح الاستدعاء غير المتزامن لطرق الخدمة ذات القيمة المُرجعة وفحص حالة End-to-End.
تتيح فئة طريقة الوكيل <SI-Namespace>::proxy::methods::<Method> لتطبيقات العميل تنفيذ استدعاءات الطرق ذات القيمة المُرجعة لعمليات العميل-الخادم المحددة في ServiceInterface[SWS_CM_00196]. يتم الاستدعاء بشكل غير حاجب عبر operator()، والذي يُرجع على الفور ara::core::Future للاستعلام المرن عن النتيجة بشكل متزامن أو غير متزامن [SWS_CM_00196]. بالإضافة إلى ذلك، يتيح GetE2EStateMachineState() قراءة حالة الحماية لآلة حالة End-to-End المرتبطة [SWS_CM_00148]. ونظرًا لأن العمليات محددة على أنها آمنة من الاستثناءات، يتم الإبلاغ عن أخطاء النقل ووقت التشغيل عبر Future برموز خطأ قياسية.
السياق
تمثل الفئة <SI-Namespace>::proxy::methods::<Method> واجهة جانب العميل لاستدعاءات الطرق المتزامنة وغير المتزامنة ضمن إدارة الاتصال في AUTOSAR Adaptive. لكل عملية عميل-خادم معلنة في ServiceInterface ومُهيأ لها السمة ClientServerOperation.fireAndForget == FALSE، يُنشئ إطار عمل الاتصال فئة طريقة وكيل مخصصة واحدة بالضبط في دور طريقة. الفئة مُعلنة كـ final ومُضمنة عبر الترويسة #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"SWS Communication Management, ص. 39. ويعمل تطبيق العميل المستدعي وNetwork Binding كأطراف تفاعل مباشرة، حيث يقوم الأخير بإعادة توجيه نقل الطريقة إلى نسخة الخدمة البعيدة واستقبال استجابتها [SWS_CM_00196]. تقبل طريقة الوكيل معلمات الاستدعاء وتُغلّف المسار غير المتزامن عبر كائن ara::core::Future، والذي يستعلم العميل من خلاله عن اكتمال الاستدعاء ونتيجته.
دورة الحياة
يتم إنشاء نسخة <SI-Namespace>::proxy::methods::<Method> بالاقتران مع وكيل الخدمة الأصلي. تفسير: يُرجح أن تُنشأ فئة الطريقة وتُدمّر كجزء لا يتجزأ من كائن الوكيل المُولَّد مع هذا الكائن، ولهذا السبب لا يقوم المستخدم بتخصيص النسخة بشكل منفصل. سؤال Q-546c9b1bceedef6b (مفتوح) وفيما يتعلق بالتزامن، فإن استدعاء الطريقة عبر operator() مصمم ليكون غير حاجب؛ حيث تبدأ الدالة الإرسال وتعود فورًا إلى المستدعي [SWS_CM_00196]. وتُعد الحماية بآليات End-to-End (E2E) حالة مركزية للنسخة. عبر الطريقة GetE2EStateMachineState()، يمكن للتطبيق تحديد الحالة الحالية لآلة الحالة الخاصة بالطريقة (ara::com::e2e::SMState) [SWS_CM_00148]. يتم تحديد هذه الحالة بواسطة دالة الفحص الداخلية E2E_Check() التي تُنفَّذ أثناء معالجة الاستدعاء الأخير لـ operator()[SWS_CM_00148]، SWS Communication Management, ص. 55. تفسير: من المرجح أن يسري تحديث حالة آلة حالة E2E بشكل غير متزامن مع وصول رسالة الاستجابة وفحصها. سؤال Q-283a9927420e2952 (مفتوح)
مسار الاستخدام
يتضمن تسلسل الاستدعاء النموذجي بدء استدعاء الطريقة، والمزامنة على النتيجة، وفحص السلامة اللاحق:
بدء الاستدعاء: يستدعي تطبيق العميل كائن الدالة عبر operator() باستخدام معلمات الإدخال المُعلنة [SWS_CM_00196]، [SWS_CM_00191].
الرجوع الفوري: لا يحجب الاستدعاء خيط المعالجة الطالب، بل يُرجع على الفور كائنًا من النوع ara::core::Future<Output>[SWS_CM_00196].
الاستعلام عن النتيجة: يقرر المستدعي بشكل مستقل بين الانتظار المتزامن (على سبيل المثال عبر كائن Future) أو المراقبة غير المتزامنة لاكتمال الاستدعاء [SWS_CM_00196]. وعند الاكتمال بنجاح، يوفّر Future كائن Output الذي يحتوي على قيم الاستجابة [SWS_CM_00196]، [SWS_CM_99333].
فحص حالة حماية E2E: بعد اكتمال الاستدعاء، يمكن للتطبيق الاستعلام عن حالة آلة حالة E2E عبر GetE2EStateMachineState() لضمان صحة نقل البيانات [SWS_CM_00148].
مخطط التسلسل: المسار النموذجي لاستدعاء طريقة مع إرجاع غير متزامن عبر Future والاستعلام اللاحق عن حالة E2E. المصادر: [SWS_CM_00196]، [SWS_CM_00148].
سيناريوهات الأخطاء
تم تحديد العمليتين operator() وGetE2EStateMachineState() على أنهما آمنتان من الاستثناءات (exception safe) ومُعلنتان بـ noexcept[SWS_CM_00148]، [SWS_CM_00196]. لذلك، لا يتم الإبلاغ عن أخطاء الاتصال والتوفير عبر استثناءات C++، بل تُنقل عبر كائن ara::core::Future الناتج، والذي يُغلّف ara::core::FutureErrc أو رموز خطأ مقابلة في حالة حدوث خطأ [SWS_CM_00196]. تتضمن أسباب الأخطاء المحددة ما يلي:
CommunicationFailure: يُبلّغ Network Binding عن خطأ اتصال يمكن إصلاحه أو فشل اتصال مؤمن؛ وفي حالات انتهاء مهلة الاتصال، قد يؤدي ذلك إلى حالة غير مؤكدة على الخادم البعيد [SWS_CM_00196].
ComErrc::kServiceNotAvailable: لم يعد بالإمكان الوصول إلى نسخة الخدمة بعد توفيرها مسبقًا [SWS_CM_00196].
ComErrc::kUnknownApplicationError: تُبلّغ خدمة بعيدة عن خطأ تطبيقي غير مُهيأ [SWS_CM_00196].
ComE2EErrc::kUnspecifiedE2EError: تُبلّغ الخدمة البعيدة عن خطأ End-to-End غير محدد [SWS_CM_00196].
ComErrc::kMinimumSendIntervalViolationError: تم طلب الاستدعاء بمعدل أسرع مما يسمح به الفاصل الزمني الأدنى للإرسال minimumSendInterval المُهيأ لعنصر الواجهة [SWS_CM_00196].
انتهاك الصلاحيات (InsufficientPermissionsViolation): إذا كان المستدعي يفتقر إلى الصلاحيات المطلوبة، يتم رفض التنفيذ بواسطة Grant Enforcement [SWS_CM_00196].
وفقًا للمواصفة، تم تضمين دلالات التراجع (rollback_semantics) لأخطاء التطبيق والاتصال هذه [SWS_CM_00196].
يستند هذا الدليل حصريًا إلى متطلبات مواصفة AUTOSAR Adaptive الإصدار R25-11.
Returns the state of the specific method class, which was determined by the last run of E2E_Check() function invoked during the last call of operator()
Initiate a method call (ClientServerOperation. fireAndForget ==FALSE). The method call will return immediately. The caller’s selection of a synchronous or asynchronous behavior to get the method output is achieved by the use of the returned ara::core::Future object which is used to query for method completion and result including possible error.
Returns the state of the specific method class, which was determined by the last run of E2E_Check() function invoked during the last call of operator()
Initiate a method call (ClientServerOperation. fireAndForget ==FALSE). The method call will return immediately. The caller’s selection of a synchronous or asynchronous behavior to get the method output is achieved by the use of the returned ara::core::Future object which is used to query for method completion and result including possible error.
The network binding reported a recoverable communications error or a secure communication failure. In case of a communication timeout this could lead to an uncertain state on the remote server side.
ComErrc::kUnknownApplicationError
rollback_semantics A remote service returned an unconfigured application error.
ComErrc::kServiceNotAvailable
rollback_semantics Service is not available after being previously offered via Offer Service()
ComE2EErrc::kUnspecifiedE2EError
rollback_semantics A remote service returned an unspecified E2E error.
ComErrc::kMinimumSendIntervalViolationError
rollback_semantics Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني