بنية <SI-Namespace>::skeleton::<SI>Skeleton::<Method>Output

تجمع البنية جميع وسائط الخرج لدالة واجهة خدمة على جانب الخادم لنقلها إلى المستدعي. وعند تنفيذ دالة Skeleton، يُنشئ تنفيذ الخدمة بنية البيانات هذه، ويملأ سماتها بالنتائج المحسوبة، ثم يعيدها إلى طبقة الاتصال. بعد ذلك تقوم البرمجية الوسيطة (Middleware) بتسلسل المعاملات المتضمنة ونقل حزمة الاستجابة إلى الـ Proxy المستدعي. ونظراً لعدم وجود متطلبات مواصفات صريحة مخزنة في الـ Payload، يُفترض أن تتطابق أنواع العناصر مباشرة مع أنواع بيانات معاملات الخرج المنمذجة في واجهة الخدمة. سؤال Q-55d242e98cd76967 (مفتوح)

المزيد ›

السياق

تُعد بنية ++C المسماة <SI-Namespace>::skeleton::<SI>Skeleton::<Method>Output جزءاً مُولَّداً من قسم الخدمة في الموديول com لـ AUTOSAR Adaptive Platform (الإصدار R25-11). وضمن واجهة الخدمة، تجمع هذه البنية جميع وسائط الخرج (Out-Parameter) لدالة خدمة معرفة على جانب المزود. وتعمل البنية كطبقة وسيطة بين تنفيذ الخدمة الفعلي لمزود الخدمة وبرمجية الاتصال الوسيطة ara::com. ونظراً لأن توقيعات دوال ++C تدعم عادةً قيمة إرجاع واحدة فقط، فإن هذا النوع يوفر تجميعاً بيانياً منظماً لإعادة الدوال التي تحتوي على معاملات خرج متعددة بأمان نمطي إلى بيئة التشغيل المستدعية.

دورة الحياة

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

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

يتم المسار النموذجي عند استخدام <Method>Output في تسلسل تفاعل ثابت بين بيئة التشغيل، وتنفيذ دالة الـ Skeleton، وبنية الخرج. فبعد وصول استعلام الدالة، تمرر البرمجية الوسيطة الاستدعاء إلى فئة الـ Skeleton المنفذة. وينفذ منطق التطبيق المعالجة، ويُنشئ البنية <Method>Output ويملأ جميع معاملات الخرج. بعد ذلك، يُسلَّم المثيل إلى نظام التشغيل، الذي يقوم بعملية التسلسل ويرسل رسالة الاستجابة عبر الشبكة إلى الـ Proxy الطالب.

مخطط تسلسلي: مسار الاستدعاء والإرجاع عند استخدام بنية الخرج في الـ Skeleton. المصادر: لا توجد وثائق إثبات محددة في الـ Payload.

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

باعتبارها تجمع بيانات محضاً، لا تمتلك <Method>Output أي روتينات خاصة لمعالجة الأخطاء أو دوال حالة. وتنشأ الحالات الخاطئة بشكل أساسي عند الواجهات نتيجة للتهيئة غير المكتملة أو انتهاك الشروط المسبقة. وإذا أخفق التنفيذ من جانب التطبيق في ملء متغيرات الأعضاء الفردية بشكل صحيح قبل الإرجاع، فقد يتم تسلسل قيم غير مهيأة أو حالات فارغة (Null). وإذا فشل الحساب الفني لدالة الخدمة مسبقاً، فلن يُنقل مثيل <Method>Output صالح في مسار التحكم المعتاد؛ بل يبلّغ التنفيذ بدلاً من ذلك عن الخطأ الذي حدث عبر قنوات الأخطاء المخصصة لذلك في واجهة الخدمة. وإذا ظهرت أخطاء في تخصيص الذاكرة مع بنى البيانات الديناميكية ضمن وسائط الخرج، فيجب التقاطها داخل الدالة المستدعاة قبل التسليم إلى البرمجية الوسيطة.