نطاق أسماء <SI-Namespace>::proxy::methods

يوفر فضاء الأسماء <SI-Namespace>::proxy::methods الفئات من جانب الوكيل (proxy) لاستدعاءات توابع ServiceInterface في الوحدة com لـ AUTOSAR Adaptive Platform. بالنسبة لكل ClientServerOperation، واعتمادًا على سمة النموذج التعريفي (metamodel attribute) ClientServerOperation.fireAndForget، يتم إنشاء مثيل إما للفئة <Method> للاستدعاءات العادية أو <FnFMethod> للاستدعاءات أحادية الاتجاه. وبينما تدعم التوابع العادية قيم الإرجاع ورسائل الخطأ من جانب الخادم، لا تعالج توابع Fire-and-Forget رسائل الاستجابة بحكم طبيعتها. ويُرجح أن تكون دورة حياة كائنات التوابع مرتبطة ارتباطًا مباشرًا بوجود مثيل الوكيل الأعلى. سؤال (مفتوح)

المزيد ›

السياق

يمثل فضاء الأسماء <SI-Namespace>::proxy::methods ضمن الوحدة com لـ AUTOSAR Adaptive Platform فئات الواجهات الخاصة بالتوابع لوكلاء الخدمة (service proxies). ويتم تعيين كل ClientServerOperation منمذج في ServiceInterface إلى فئة تابع مطابقة اعتمادًا على خصائص تكوينه. ويتضمن فضاء الأسماء أساسًا نموذجين للفئات: <Method> للعمليات ذات سلوك الاستجابة، و<FnFMethod> لما يُعرف بعمليات Fire-and-Forget.

تتمثل المسؤولية الأساسية لهذه الفئات في استقبال استدعاءات التوابع من تطبيق عميل، وتجهيز معلمات التمرير لأجل النقل، ومعالجة الاتصال مع طبقة البرمجيات الوسيطة الأساسية. وشركاء التفاعل هم، من جانب جهة الاستدعاء، مكونات العميل الخاصة بالتطبيق، ومن جانب الوساطة، فئة الوكيل الأعلى لفضاء الأسماء <SI-Namespace>::proxy، والتي تُجمّع مثيلات التوابع.

يعتمد التمييز بين الفئتين على سمة النموذج التعريفي ClientServerOperation.fireAndForget:

• يتم إنشاء <Method> للعمليات التي تم تكوين ClientServerOperation.fireAndForget == FALSE لها. ويُفترض أن يغلف مثيل هذه الفئة الاستدعاء غير المتزامن لإحدى الخدمات، ويقدم النتيجة أو أي أخطاء تطبيقية محتملة عبر نوع نتيجة مستقبلي. سؤال Q-75c8a4495ee9c1cb (مفتوح)
• يتم إنشاء <FnFMethod> عند تكوين ClientServerOperation.fireAndForget == TRUE. ويُرجح أن يكون تابع هذه الفئة منفذًا كاستدعاء أحادي الاتجاه لا يتوقع أي استجابة من الخادم ولا يقدم أي قيمة إرجاع لجهة الاستدعاء. سؤال Q-1f9698a27137b73d (مفتوح)

دورة الحياة

يرتبط إنشاء فئات التوابع المعرفة في فضاء الأسماء هذا وتدميرها ارتباطًا وثيقًا بالوكيل الأعلى. ويُرجح أن تكون دورة حياة كائنات التوابع مقترنة بدورة حياة مثيل الوكيل الحاوي في فضاء الأسماء <SI-Namespace>::proxy. سؤال Q-ec1ef4d1ebc90d5a (مفتوح) وعند إنشاء مثيل كائن الوكيل، تتم تهيئة المثيلات المقابلة من <Method> و<FnFMethod> كأعضاء، وتكون متاحة فورًا للتطبيق لإجراء الاستدعاءات.

فيما يتعلق بالحالة الداخلية، تمتلك كائنات التوابع بعد تهيئتها جاهزية دائمة للاستدعاء ما دام مثيل الوكيل يظل صالحًا. ولا تؤثر انتقالات الحالة للاستدعاءات الفردية على مثيل التابع نفسه، بل على سياقات الاستدعاء الفردية. وفي حالة الوصول المتزامن من خيوط متعددة لتطبيق العميل، يجب ضمان إمكانية بدء الاستدعاءات المتوازية لنفس مثيل التابع بأمان خيطي (thread-safe). ويتم التدمير ضمنيًا عند مغادرة نطاق الصلاحية أو عند التدمير الصريح لمثيل الوكيل، مع تنظيف موارد الاتصال المفتوحة.

مسار الاستخدام

يتبع المسار النموذجي لاستخدام فئات التوابع بواسطة تطبيق عميل تسلسلًا محددًا:

1. توفير الوكيل: ينشئ التطبيق مثيلًا مهيأً لوكيل الخدمة من فضاء الأسماء <SI-Namespace>::proxy أو يحصل عليه.
2. الوصول إلى التابع: يتم استدعاء العملية المطلوبة عبر أعضاء التوابع لمثيل الوكيل، والتي تنشئ مثيلات الفئات <Method> أو <FnFMethod>.
3. تنفيذ عملية عادية: عند استدعاء مثيل لـ <Method>، يمرر العميل معلمات الإدخال المطلوبة. ويطلق الاستدعاء عملية النقل إلى النظام الهدف. ويتيح كائن الإرجاع للتطبيق انتظار وصول النتيجة أو متابعة العمل بشكل غير متزامن.
4. تنفيذ عملية Fire-and-Forget: عند استدعاء مثيل لـ <FnFMethod>، يتم تمرير المعلمات وإرسالها فورًا لإعادة توجيهها إلى طبقة النقل. ويعود التابع مباشرة بعد التمرير إلى جهة الاستدعاء.
5. معالجة النتيجة: في استدعاءات التوابع العادية، يُقيّم العميل النتيجة المقدمة ويتحقق مما إذا كانت العملية قد اكتملت بنجاح.

سيناريوهات الأخطاء

تختلف معالجة الأخطاء اختلافًا جوهريًا بين نوعي التوابع: ففي العمليات العادية عبر <Method>، يمكن أن تحدث أخطاء طبقة النقل وكذلك أخطاء تطبيق محددة ومحفوظة في تعريف الواجهة. ونظرًا لتكوين ClientServerOperation.fireAndForget == FALSE، تتم إعادة رسائل الاستجابة متضمنة رسائل الخطأ المحتملة من الخادم إلى الوكيل. ويمكن لتطبيق العميل تقييم هذه الأخطاء عبر كائن الإرجاع الخاص بالاستدعاء وبدء إجراءات المعالجة المناسبة.

على النقيض من ذلك، فإن تصميم <FnFMethod> من خلال ClientServerOperation.fireAndForget == TRUE يستبعد بحكم طبيعته تلقي جهة الاستدعاء أي إشعار بأخطاء جانب الخادم. فالأخطاء التي تحدث على الخادم أثناء معالجة العملية لا يمكن إرسالها إلى الوكيل. وتقتصر الشروط المسبقة واللاحقة على جانب الاستدعاء المحلي: إذ تتطلب الشروط المسبقة قيم معلمات صالحة وبنية تحتية للاتصال جاهزة للعمل. وإذا حدث خطأ محلي أثناء الإرسال، فيمكن الإشارة إليه مباشرة عند استدعاء التابع، بينما تظل أخطاء التنفيذ من جانب الخادم غير ملحوظة لجهة الاستدعاء.