بنية ara::diag::DiagnosticSovdContentData

يعمل الهيكل ara::diag::DiagnosticSovdContentData كوعاء بيانات قياسي لتغليف محتويات التشخيص لخدمات SOVD في AUTOSAR Adaptive ([SWS_DM_02385]). وهو يحتفظ بالبيانات الصافية (Payload) في متجه عام من عناصر المحتوى ([SWS_DM_02386])، والتي يولد منها Diagnostic Management سمة SOVD المسماة parameters عند تقديم ردود العمليات والحالة. وبصفته كائن نقل قيمة بحتاً، لا يوفر الهيكل مزامنة خيوط داخلية، ولهذا السبب يجب تأمين التعديلات المتزامنة داخلياً ضمن التطبيق.

المزيد ›

السياق

يُعد هيكل البيانات ara::diag::DiagnosticSovdContentData جزءاً من وحدة التشخيص (diag) في AUTOSAR Adaptive Platform ومصرحاً عنه في الترويسة ara/diag/diagnostic_sovd_content_data.h (AUTOSAR_AP_SWS_Diagnostics §8.59 «Header: ara/diag/diagnostic_sovd_content_data.h»، [SWS_DM_02385]). ويعمل كحامل بيانات قياسي لتغليف محتويات التشخيص في تشخيص المركبات الموجه نحو الخدمات وفقاً لـ ASAM SOVD.

يتوسط الهيكل داخل المنصة بين خادم التشخيص (Diagnostic Management، DM) وموفري الخدمات لتطبيق Adaptive Application ([SWS_DM_01396]، [SWS_DM_02174]). وإذا قام عميل SOVD خارجي بإطلاق عملية أو استعلام عن الحالة، يفوض DM الاستدعاء إلى مكون البرمجيات المنفذ. ويتم تخزين بيانات الإخراج المُنشأة بواسطة التطبيق في حالة من DiagnosticSovdContentData ([SWS_DM_02386]). بعد ذلك، ينقل DM هذه المحتويات إلى نص استجابة SOVD، وتحديداً إلى السمة القياسية parameters ([SWS_DM_02176]، [SWS_DM_02181]).

مخطط السياق: تضمين DiagnosticSovdContentData في تبادل البيانات بين عميل SOVD وDiagnostic Management وموفر خدمة التشخيص. المصادر: [SWS_DM_01396]، [SWS_DM_02174]، [SWS_DM_02176]، [SWS_DM_02385]، [SWS_DM_02386].

دورة الحياة

يمنح التعريف كـ struct في ++C (AUTOSAR_AP_SWS_Diagnostics §8.59.1.1 «Public Member Variables»، [SWS_DM_02385]) DiagnosticSovdContentData دور وعاء البيانات. ويمتلك الهيكل متغير العضو العام elements من النوع ara::core::Vector<DiagnosticSovdContentElementData> ([SWS_DM_02386])، والذي تُدار فيه عناصر المحتوى الفردية ديناميكياً.

يتم إنشاء الحالة عادة محلياً داخل طرائق موفر الخدمة بمجرد تجميع بيانات التشخيص للرد. وفي الواجهات غير المتزامنة مثل Read (AUTOSAR_AP_SWS_Diagnostics §8.x «Read»)، يتم تغليف الكائن في ara::core::Future<DiagnosticSovdContentData>. تفسير: يُفترض هنا أن ينتقل الهيكل عبر تمرير القيمة أو دلالات النقل إلى ملكية المستدعي، بحيث يرتبط عمره بكائن Future المعالج. سؤال Q-564c59896de41f85 (مفتوح)

فيما يتعلق بالتزامن، لا يحتوي الهيكل على أي أوليات مزامنة داخلية. تفسير: نظراً لأنه كائن نقل قيمة بحت (Value Object)، فمن المرجح ألا توجد حماية خيوط داخلية؛ وبالتالي يجب مزامنة عمليات الوصول المتزامنة إلى نفس الحالة بواسطة منطق التطبيق المستدعي. سؤال (مفتوح) ويحدث إتلاف الحالة تلقائياً عند مغادرة نطاق صلاحية السياق المُدير.

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

يكمن مسار الاستخدام الأساسي لـ DiagnosticSovdContentData في توفير البيانات الصافية أثناء تنفيذ العمليات المتزامنة وكذلك عند استعلامات الحالة في إطار عمل SOVD:

1. يرسل عميل SOVD خارجي طلباً لبدء عملية وفقاً لـ ASAM SOVD إلى المركبة ([SWS_DM_01396]).
2. بعد التحقق من صحة الشروط الحدية، يفوض Diagnostic Management التنفيذ إلى العملية المسؤولة عبر ara::diag::GenericDiagnosticSovdOperation::StartExecution ([SWS_DM_02174]).
3. ينفذ تطبيق الخدمة عملية التشخيص، وينشئ نسخة من DiagnosticSovdContentData، ويملأ العضو elements ببيانات العنصر المُنشأة ([SWS_DM_02386]).
4. يتم تمرير الكائن كجزء من القيمة المُرجعة لعمليات التنفيذ المتزامنة إلى Diagnostic Management ([SWS_DM_02176]).
5. يقرأ Diagnostic Management القيم من DiagnosticSovdContentData، وينقلها إلى السمة parameters الخاصة بجسم استجابة SOVD، ويرسل الاستجابة إلى العميل ([SWS_DM_02176]).

ينطبق مسار مماثل على استعلام الحالة عبر SovdOperationExecution::GetStatus ([SWS_DM_02180])، حيث يتم اشتقاق السمة parameters أيضًا من DiagnosticSovdContentData الممررة ([SWS_DM_02181]). وبالمثل، يستخدم موفرو المحتوى البنية نفسها كنوع إرجاع عبر Read (AUTOSAR_AP_SWS_Diagnostics §8.x «Read»).

مخطط تسلسلي: توفير بيانات الحمولة النافعة بواسطة DiagnosticSovdContentData أثناء تنفيذ عملية متزامنة. المصادر: [SWS_DM_01396]، [SWS_DM_02174]، [SWS_DM_02176]، [SWS_DM_02386].