فئة ara::rds::ReadDataResult

تُغلّف البنية ara::rds::ReadDataResult نتيجة عملية قراءة من تدفق بيانات أولية لـ AUTOSAR Adaptive Platform (AUTOSAR_AP_SWS_RawDataStream, ص. 1). ويتم إنشاؤها بواسطة الدوال ReadData، كما توفر البيانات الثنائية المقروءة في المخزن المؤقت data مع عدد وحدات البايت الفعلي numberOfBytes [SWS_RDS_11301]. وبما أن المخزن المؤقت يُدار كـ std::unique_ptr، يُفترض أن تنقل البنية الملكية الحصرية إلى جهة الاستدعاء وتستبعد النسخ. سؤال (مفتوح) وتُبلّغ الأخطاء عبر ara::core::Result المحيط، ولهذا السبب يجب التحقق من صحة النتيجة قبل الوصول إلى البيانات.

المزيد ›

السياق

تعمل الفئة ara::rds::ReadDataResult في الوحدة rds (RawDataStream) التابعة لـ AUTOSAR Adaptive Platform كحاوية نتائج مهيكلة لعمليات جلب البيانات من تدفقات البيانات (AUTOSAR_AP_SWS_RawDataStream, ص. 1). وتتمثل مسؤوليتها الأساسية في تسليم وحدات بايت البيانات الأولية المقروءة من تدفق بيانات أولية مع عدد وحدات البايت المنقولة فعليًا إلى التطبيق المستدعي. وتظهر كأطراف تفاعل في منظومة النظام مثيلاتُ التدفق، التي تقدم دوال القراءة ReadData، بالإضافة إلى مكون التطبيق المعني، الذي يقيّم تدفق البيانات ويواصل معالجة البيانات [SWS_RDS_10486]، [SWS_RDS_11322].

دورة الحياة

تنشأ مثيلات ara::rds::ReadDataResult في إطار عمليات قراءة متزامنة أو محددة بوقت. ويبدأ الإنشاء عندما تستدعي جهة الاستدعاء الدالة ReadData(std::size_t maxLength) [SWS_RDS_10486]، [SWS_RDS_11322] أو دالة التحميل الزائد مع مراقبة الوقت ReadData(std::size_t maxLength, std::chrono::milliseconds timeout) [SWS_RDS_11309]، [SWS_RDS_11323].

تتحدد علاقات الملكية ودورة حياة الذاكرة بشكل رئيسي عبر عنصر البيانات المتضمن data، المُصرّح عنه كـ std::unique_ptr<ara::core::Byte[]> [SWS_RDS_11301]. ويعني هذا وفقًا لتفسير C++‎ المعتاد أن ReadDataResult قد صُممت على الأرجح كنوع يقبل النقل فقط، وبالتالي لا يمكن نسخه بل نقله حصريًا. سؤال Q-fe4b113c5852b5aa (مفتوح) ويتولى البرنامج المستدعي الملكية الفردية للمخزن المؤقت للبيانات المخصص بمجرد استلام الكائن. ويؤدي تدمير المثيل تلقائيًا إلى تحرير ذاكرة الكومة المحجوزة لمصفوفة البايتات، ما لم يتم استخراج المؤشر صراحةً من الكائن مسبقًا. وفيما يخص التزامن، لا توجد مزامنة داخلية؛ والوصول المتزامن إلى مثيل من خيوط متعددة دون أقفال خارجية ليس آمنًا خيطيًا.

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

ينقسم المسار المعتاد لاستخدام ara::rds::ReadDataResult إلى الخطوات الفرعية التالية:

• طلب عملية القراءة: يستدعي التطبيق على التدفق ReadData مع الحد الأقصى المطلوب لحجم البيانات maxLength [SWS_RDS_10486]، [SWS_RDS_11322]، مع إمكانية إضافة قيمة مهلة زمنية اختياريًا [SWS_RDS_11309]، [SWS_RDS_11323].
• إرجاع حاوية النتائج: يقرأ التدفق البيانات الثنائية من القناة ويُرجع كائنًا ممتلئًا من النوع ara::core::Result<ReadDataResult> في حال النجاح (AUTOSAR_AP_SWS_RawDataStream, ص. 1).
• تحديد الحجم: يقرأ التطبيق الحقل numberOfBytes [SWS_RDS_11302]. تفسير: يُرجّح أن تشير هذه القيمة إلى كمية البايتات المتوفرة فعليًا في المخزن المؤقت، والتي قد تكون أصغر من أو مساوية لـ maxLength المطلوب. سؤال Q-12bde8c67452a632 (مفتوح)
• معالجة البيانات: يتم إلغاء إسناد المخزن المؤقت data [SWS_RDS_11301]، بغرض معالجة وحدات البايت المستلمة أو تحويلها إلى بنى خاصة بالتطبيق عبر دلالات النقل.

مخطط تسلسلي: المسار النموذجي لعملية قراءة مع استلام ReadDataResult وتقييمها. المصادر: [SWS_RDS_10486]، [SWS_RDS_11301]، [SWS_RDS_11302]، AUTOSAR_AP_SWS_RawDataStream, ص. 1

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

صُرّح عن دوال إنشاء ReadDataResult بـ noexcept [SWS_RDS_10486]، [SWS_RDS_11309]، [SWS_RDS_11322]، [SWS_RDS_11323]، ولهذا السبب لا يتم إطلاق استثناءات C++‎ في حالة الخطأ. وبدلاً من ذلك، تتم معالجة الأخطاء بالكامل عبر كائن الإرجاع ara::core::Result (AUTOSAR_AP_SWS_RawDataStream, ص. 1).

تشمل سيناريوهات الخطأ النموذجية انقطاعات التدفق، أو طلبات القراءة غير الصالحة، أو انقضاء مهلة الانتظار في استدعاءات القراءة المراقبة زمنيًا [SWS_RDS_11309]، [SWS_RDS_11323]. تفسير: في حالات الإخفاق هذه، من المحتمل ألا يحتوي ara::core::Result على كائن ReadDataResult صالح، بل على كود خطأ مطابق. سؤال Q-f3f971c4789fe8e7 (مفتوح) بالنسبة للتطبيق، يعني هذا كشرط مسبق للوصول إلى data [SWS_RDS_11301] وnumberOfBytes [SWS_RDS_11302]، التحقق دائمًا أولاً من حالة نجاح كائن Result الأصلي لمنع الوصول إلى مؤشرات غير مهيأة أو مناطق ذاكرة غير صالحة.