فئة ara::shwa::ShwaException

تشتق الفئة ara::shwa::ShwaException من ara::core::Exception وتُستخدم في الوحدة shwa للإشارة إلى حالات الخطأ عبر آلية استثناءات C++. عند إنشاء المثيل، يأخذ المنشئ الصريح ara::core::ErrorCode، الذي يغلف سبب الخطأ ويوفره للتشخيص في كتلة الالتقاط [AP_SWS_SHWA_01303]. تم تحديد الإنشاء وفقاً لـ [AP_SWS_SHWA_01303] كـ noexcept، وهو آمن من الاستثناءات وآمن خيطياً. تفسير: ينبغي على المستدعين التقاط الاستثناء بشكل منظم وتقييم رمز الخطأ لتجنب حالات الإنهاء غير المعالجة للعملية. سؤال (مفتوح)

المزيد ›

السياق

تمثل الفئة ara::shwa::ShwaException في الوحدة shwa الخاصة بـ AUTOSAR Adaptive Platform فئة الاستثناء المتخصصة للإشارة إلى حالات الخطأ الخاصة بالوحدة. يشتق النوع علناً من ara::core::Exception وفقاً لبنية الفئة، وبذلك يندمج في التسلسل الهرمي الموحد للاستثناءات في Adaptive Platform. وفي بنية النظام، تعمل الفئة كجسر بين المكونات الداخلية للوحدة shwa وطبقات التطبيق المستدعية. ويتمثل غرضها الأساسي في نقل ara::core::ErrorCode عبر آلية استثناءات C++، كما يثبت إعلان المنشئ وفقاً لـ [AP_SWS_SHWA_01303]. ويُرجح أن تستخدم شيفرة التطبيق الفئة كنوع التقاط للتمييز المستهدف لأخطاء الوحدة shwa عن استثناءات المنصة العامة. سؤال Q-c74c928a939e73ad (مفتوح)

دورة الحياة

تبدأ دورة حياة مثيل من ara::shwa::ShwaException بإنشائه في سياق اكتشاف الخطأ. وفقاً لـ [AP_SWS_SHWA_01303]، يتم الإنشاء عبر المنشئ explicit ShwaException(ara::core::ErrorCode errorCode) noexcept. تربط التهيئة رمز الخطأ الممرر مباشرةً بكائن الاستثناء. تضمن المواصفة لهذا الإعلان أماناً كاملاً من الاستثناءات (exception safe) بالإضافة إلى أمانية الخيوط (thread-safe) [AP_SWS_SHWA_01303]. ونظراً لأن المنشئ معلن كـ noexcept، يُضمن ألا يؤدي إنشاء الكائن نفسه إلى إطلاق أي استثناءات ثانوية.

بعد الإنشاء، يتم تمرير الكائن عبر عبارة throw إلى نظام تشغيل C++. يتولى نظام التشغيل الإدارة أثناء تفكيك المكدس (Stack-Unwinding)، حتى يتم ربط الكائن في كتلة catch متوافقة. وبعد مغادرة كتلة الاستثناء، ينتهي عمر الكائن ويتم تدميره تلقائياً. ونظراً لأن الإنشاء محدد بأنه آمن خيطياً [AP_SWS_SHWA_01303]، يمكن لعدة خيوط تنفيذ إنشاء مثيلات ورميها بشكل مستقل عن بعضها البعض.

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

يبدأ مسار الاستخدام النموذجي باستدعاء دالة للوحدة shwa بواسطة تطبيق ما. وإذا فشلت العملية وكانت الدلالات الخاصة بالوحدة تنص على استثناء، يُنشئ المكون المنفذ مثيلاً من ara::shwa::ShwaException مع تمرير ara::core::ErrorCode المناسب [AP_SWS_SHWA_01303]. وبعد ذلك يتم إطلاق الاستثناء.

يلتقط كود التطبيق المستدعي الاستثناء إما كـ ara::shwa::ShwaException أو عبر الفئة الأساسية ara::core::Exception. وفي كتلة الالتقاط، يمكن قراءة رمز الخطأ المغلف لتحليل السبب، أو كتابة إدخالات السجل، أو بدء إجراءات الاستعادة. يوضح التسلسل التالي هذا المسار.

مخطط تسلسلي: المسار النموذجي لتوليد الاستثناءات ومعالجتها عند استدعاءات الدوال في الوحدة shwa. المصادر: [AP_SWS_SHWA_01303]

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

بوصفها فئة استثناء، تعمل ara::shwa::ShwaException نفسها على الإشارة إلى سيناريوهات الخطأ. يتطلب الإنشاء كشرط مسبق وحيد تمرير ara::core::ErrorCode [AP_SWS_SHWA_01303]. ومن خلال تمييز المنشئ بـ explicit، يتم منع تحويلات الأنواع الضمنية غير المقصودة في وقت الترجمة.

حالات الخطأ أثناء إنشاء الاستثناء مستبعدة، نظراً لأن المنشئ مُعلَن عنه وفقاً لـ [AP_SWS_SHWA_01303] بـ noexcept. وبالتالي فإن إنشاء النسخ يتسم بالمتانة ولا يؤدي إلى أخطاء تخصيص أو توقفات غير طبيعية في وقت التشغيل. ولا ينشأ سيناريو خطأ حرج على مستوى النظام إلا إذا لم يتم التقاط الاستثناء المُطلق من قِبل السياق المستدعي: يؤدي هذا عبر الآلية القياسية لـ C++ إلى استدعاء لـ std::terminate. تفسير: ينبغي للمستدعين تأمين نطاق الاستثناء ومعالجة رمز الخطأ لضمان استقرار العملية. سؤال Q-0b08103bdf1368b7 (مفتوح)