DEENESPTFRRUARHIKOZHNL

فئة ara::com::e2e::ComE2EException

[SWS_CM_12501] Upstream: RS_AP_00122, RS_AP_00127, RS_AP_00130

class ComE2EException final :            public ara::core::Exception {...};

Defines a class for exceptions to be thrown by the E2E APIs

Header-Datei#include "ara/com/e2e/e2e_error_domain.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com::e2e
Basisklasse(n)ara::core::Exception

دليل المستخدممولَّد بالذكاء الاصطناعي

تُستخدم كاستثناء C++‎ محدد للإشارة إلى أخطاء من واجهات End-to-End متضمناً رمز الخطأ.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 385c2dd6528b المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم كاستثناء C++‎ محدد للإشارة إلى أخطاء من واجهات End-to-End متضمناً رمز الخطأ.

تُستخدم الفئة ara::com::e2e::ComE2EException كاستثناء C++‎ قياسي للإبلاغ عن أخطاء من واجهات برمجة تطبيقات E2E لإدارة الاتصال ([SWS_CM_12501]). وهي ترث من ara::core::Exception وتغلِّف ara::core::ErrorCode محدداً، يتم تمريره عند إنشاء المثيل عبر منشئ noexcept آمن ضد الاستثناءات ([SWS_CM_12502]). وفي حال تم تعطيل استثناءات C++‎ في سلسلة أدوات المترجم، لا تشارك الدالة المطلِقة في دقة التحميل الزائد وفقاً للمواصفة، بحيث يتطلب مسار الخطأ هذا دعماً نشطاً للاستثناءات.

السياق

تُستخدم الفئة ara::com::e2e::ComE2EException كفئة استثناء C++‎ قياسية تُطلقها واجهات برمجة التطبيقات لـ End-to-End‏ (E2E) في إدارة الاتصال للإشارة إلى شروط الخطأ التي حدثت ([SWS_CM_12501]، AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). الفئة مُصرَّح عنها كـ final وترث علناً من ara::core::Exception (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). ويتم توفيرها عبر ملف الترويسة ara/com/e2e/e2e_error_domain.h ([SWS_CM_12502]).

ضمن المعمارية الوظيفية لـ AUTOSAR Adaptive، تعمل ComE2EException كجسر اتصال بين روتينات مراقبة E2E للمنصة وبرمجيات التطبيق المستدعية. وإذا اكتشفت إحدى دوال E2E حالة خطأ أثناء التحقق من البيانات أو معالجتها، يتم نقل هذا الخطأ إلى مسار التحكم الأعلى عبر إطلاق هذا الاستثناء (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»).

دورة الحياة

يتم إنشاء مثيل لكائن من ComE2EException بصورة صريحة من خلال تمرير رمز خطأ إلى المنشئ explicit ComE2EException(ara::core::ErrorCode errorCode) noexcept ([SWS_CM_12502]، AUTOSAR_AP_SWS_CommunicationManagement §8.15.4.1.1.1 «ComE2EException»). تم تحديد المنشئ كـ noexcept وآمن ضد الاستثناءات (exception safe) ([SWS_CM_12502]). يضمن ذلك عدم إمكانية إطلاق أي استثناءات أخرى أثناء بناء الاستثناء نفسه، مما يؤمن المتانة في مسار الخطأ.

فيما يتعلق بملكية الكائنات، يتم إنشاء الاستثناء بواسطة واجهة E2E المُطلِقة ويُرمى بالقيمة (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). ومن جانب التطبيق، يتم التقاط الكائن عادةً كمرجع ثابت. وبمجرد الخروج من كتلة المعالجة المعنية، يحدث التدمير التلقائي في إطار تفكيك مكدس C++‎ الاعتيادي. ونظرًا لأن الفئة معرّفة كـ final، فإنه لا يُتوقع وجود أي فئات فرعية.

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

ينقسم المسار النموذجي لاستخدام الاستثناء إلى المراحل التالية:

  • يستدعي برنامج التطبيق دالة محمية بـ E2E تابعة لإدارة الاتصال.
  • يكتشف منطق E2E خطأً أثناء معالجة البيانات أو فحصها، ويُنشئ نسخة من ara::com::e2e::ComE2EException باستخدام errorCode المحدد ويرميها (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»).
  • يلتقط التطبيق الاستثناء في كتلة try-catch. ومن المحتمل هنا (تفسير) أن يصل المستدعون إلى الطرق الأساسية الموروثة لـ ara::core::Exception لتقييم ara::core::ErrorCode المتضمن من أجل تشخيص الأخطاء. سؤال Q-8dfac2428f223afe (مفتوح)
تسلسل معالجة الاستثناءات عند حدوث أخطاء E2Eالتطبيقara::com E2E-APIComE2EExceptionاستدعاء عملية تم التحقق منها بواسطة E2EUse Case: حالة خطأ في فحص E2EoptC++ Exceptions aktiviertComE2EException(errorCode) instanziierenthrow ComE2EExceptionالتقاط الاستثناء وتقييم رمز الخطأ

مخطط تسلسلي: مسار معالجة الأخطاء عند حدوث أخطاء E2E عبر ComE2EException. المصادر: [SWS_CM_12501]، [SWS_CM_12502]، AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException».

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

لاستخدام ComE2EException، ينطبق شرط مسبق أساسي يتعلق بسلسلة الأدوات: وفقًا لـ [SWS_CORE_10304]، لا تشارك الدالة التي تُنشئ النسخة وترميها في حل التحميل الزائد (overload resolution) إذا تم إلغاء تفعيل استثناءات C++‎ في المترجم (AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 «Class: ComE2EException»). وبالتالي، فإن مسار الإشارة هذا غير موجود في بيئات وقت التشغيل التي لا تدعم استثناءات C++‎؛ ومن المحتمل في هذه الحالة (تفسير) أن يتم نقل الأخطاء عبر آليات أخطاء بديلة للمنصة لا تعتمد على الاستثناءات. سؤال Q-e1b3f4f1dfc191ef (مفتوح)

إذا كانت الاستثناءات مفعّلة، فإن كل ComE2EException ينقل رمز خطأ بشكل إلزامي ([SWS_CM_12502]). وكشرط مسبق لإنشاء النسخة، يجب أن يتوفر ara::core::ErrorCode صالح ([SWS_CM_12502]). ونظرًا لأن المُنشئ مُعلن كآمن من حيث الاستثناءات ([SWS_CM_12502])، فلا يمكن أن يفشل إنشاء الكائن نفسه حتى في حالة الخطأ.

يستند هذا الدليل إلى مواصفة AUTOSAR بالنسخة R25-11 وتم تنظيمه تلقائيًا.

مخطط الفئات UML

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__com__e2e__ComE2EException703 ComE2EException + ComE2EException() nara__core__Exception792 Exception nara__com__e2e__ComE2EException703->nara__core__Exception792 nstd__exception10 std::exception nara__core__Exception792->nstd__exception10

المُنشئات والمُتلف

ComE2EException دالة

Constructs a new ara::com::e2e::ComE2EException object containing an error code

explicit ComE2EException (ara::core::ErrorCode errorCode) noexcept;

توثيق الدوال

دالة ComE2EException [SWS_CM_12502] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

explicit ComE2EException (ara::core::ErrorCode errorCode) noexcept;

Constructs a new ara::com::e2e::ComE2EException object containing an error code

Header-Datei#include "ara/com/e2e/e2e_error_domain.h"
Scopeclass ara::com::e2e::ComE2EException
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
errorCodeThe error code.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_12502
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12502@rel:R25-11#cc3be56d
Content hash
cc3be56d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12502
Status: valid/unmigrated Version: rel:R25-11#f55f1c7d Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_12502@rel:R25-11#f55f1c7d
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#e593e1602026-09-30
  • R22-11rel:R22-11#803783f82026-10-14
  • R23-11rel:R23-11#0ff65df22026-10-14
  • R24-11rel:R24-11#eaa1533d2026-10-14
  • R25-11rel:R25-11#f55f1c7d2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill