يمكّن تطبيقات العميل من الاشتراك في أحداث الخدمة واستقبال عينات البيانات المحددة النوع.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 056774d8023aالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يمكّن تطبيقات العميل من الاشتراك في أحداث الخدمة واستقبال عينات البيانات المحددة النوع.
تمكّن فئة الواجهة <SI-Namespace>::proxy::events::<Event> تطبيقات العميل في AUTOSAR Adaptive Platform من استقبال أحداث الخدمة من جهة المستهلك عبر الموديل com. ويتضمن المسار النموذجي طلب الاشتراك عبر Subscribe[SWS_CM_00141]، والإخطار التفاعلي عبر معالجات مسجلة، بالإضافة إلى جلب العينات بشكل متزامن باستخدام GetNewSamples[SWS_CM_00701]. وأثناء ذلك، لا يجوز الاحتفاظ بمؤشرات عينات في الوقت نفسه أكثر مما تم حجزه عند الاشتراك، ويجب تحرير جميع المراجع قبل إلغاء الاشتراك عبر Unsubscribe.
السياق
تمثل فئة C++ المسماة <SI-Namespace>::proxy::events::<Event> الواجهة من جهة المستهلك لحدث خدمة في الموديل com لـ AUTOSAR Adaptive Platform (الإصدار R25-11). وضمن نمط الاتصال الموجه نحو الخدمة، تعمل هذه الفئة المولّدة كممثل محلي لحدث يوفره هيكل الخادم. وتستخدم تطبيقات العميل مثيلات هذه الفئة للاشتراك في بيانات الأحداث، واستقبال العينات (Samples) الواردة من شبكة الاتصال، وإدارة دورة حياتها على جانب المستهلك AUTOSAR_AP_EXP_ARAComAPI ص. 10.
أطراف التفاعل الأساسية للفئة هي:
التطبيق (المشترك): يباشر تسجيل اشتراك الحدث عبر Subscribe[SWS_CM_00141]، ويودع إجراءات رد النداء لاستقبال البيانات بالإضافة إلى تغييرات الحالة، ويستعلم عن عينات جديدة عبر GetNewSamples[SWS_CM_00701].
Communication Management: ينسق نقل بيانات الأحداث عبر البرمجيات الوسيطة الأساسية، ويدير حالة الشبكة، وينفّذ معالجات الإخطار المسجلة عند وصول أحداث جديدة أو تغييرات في الحالة [SWS_CM_00181]، [SWS_CM_00333].
سياق التنفيذ (المنفّذ): عند استخدام دوال تسجيل محملة بشكل زائد، يتم تنفيذ المعالجات غير المتزامنة داخل سياق ExecutorT ممرر صراحةً [SWS_CM_11354]، [SWS_CM_11356]، [SWS_CM_00100].
يُرجّح أن يكون إنشاء <SI-Namespace>::proxy::events::<Event> وتدميره، بوصفه عضوًا في فئة الوكيل العليا، مرتبطين بشكل وثيق بفترة بقاء وكيل الخدمة. سؤال Q-6c591ea580278c12 (مفتوح) وبعد الإنشاء، يكون الحدث في البداية في حالة غير مشترَك بها. ويمكن الاستعلام عن حالة الاشتراك الحالية في أي وقت عبر GetSubscriptionState، والتي تُرجع الحالة بوصفها ara::com::SubscriptionState[SWS_CM_00316].
يتم بدء الانتقال إلى حالة الاشتراك النشطة عبر Subscribe، حيث يتم تحديد الحد الأقصى لعدد فتحات الذاكرة المؤقتة المتاحة في الوقت نفسه عبر maxSampleCount[SWS_CM_00141]. وإذا كان الحدث عند وقت الاستدعاء موجودًا بالفعل في الحالتين kSubscribed أو kSubscriptionPending وكانت القيمة الممررة متطابقة مع القيمة الحالية، فإن الاستدعاء يظل بلا تأثير [SWS_CM_00141]. ويبلّغ Communication Management عن تغييرات حالة الاشتراك عبر معالج يتم تسجيله بواسطة SetSubscriptionStateChangeHandler[SWS_CM_00333] أو مع سياق تنفيذ عبر SetSubscriptionStateChangeHandler[SWS_CM_11354]. ويمكن إلغاء هذا التسجيل عبر UnsetSubscriptionStateChangeHandler[SWS_CM_00334]AUTOSAR_AP_EXP_ARAComAPI ص. 10.
بالإضافة إلى ذلك، تدير الفئة حالة التأمين الشامل بين الطرفين (E2E). وعبر GetE2EStateMachineState، يتم تحديد الحالة ara::com::e2e::SMState لآلة حالة E2E، كما تم رصدها عند آخر استدعاء داخلي لـ E2E_Check() أثناء GetNewSamples()[SWS_CM_11554]. ويمكن مراقبة شروط النقل المعيبة من خلال معالجات يتم تعيينها عبر SetTransportFaultConditionHandler[SWS_CM_00099] أو [SWS_CM_00100] وإزالتها عبر UnsetTransportFaultConditionHandler[SWS_CM_00105].
يتم إنهاء الاشتراك عبر Unsubscribe[SWS_CM_00151]AUTOSAR_AP_EXP_ARAComAPI ص. 10. وإذا لم يكن الحدث مشترَكًا به في ذلك الوقت، تعود الدالة دون تنفيذ أي إجراء [SWS_CM_00151]. وجميع الدوال الأعضاء معلنة كـ noexcept وتوفر أمانًا كاملاً من الاستثناءات.
مسار الاستخدام
ينقسم المسار النموذجي لاستخدام حدث الوكيل إلى المراحل المتتالية التالية:
بدء الاشتراك: يستدعي التطبيق Subscribe(maxSampleCount)[SWS_CM_00141] لحجز حجم المخزن المؤقت للعينات الواردة.
تكوين الإخطار: عبر SetReceiveHandler[SWS_CM_00181] (أو مع سياق تنفيذ عبر [SWS_CM_11356])، يتم تسجيل رد نداء بدون معلمات، والذي يستدعيه Communication Management عند وصول أحداث جديدة.
جلب العينات ومعالجتها: في رد النداء، يستدعي التطبيق GetNewSamples[SWS_CM_00701]. ويعالج كائن قابل للاستدعاء f ممرر مع التوقيع void(ara::com::SamplePtr<SampleType const>) كل عينة على التوالي. وهنا يتطابق SampleType مع نوع بيانات الحمولة الخاص بنوع الحدث [SWS_CM_11401]. وتوفر القيمة المرجعة كـ ara::core::Result<std::size_t> العدد الدقيق للعينات الممررة إلى f[SWS_CM_00701].
مراقبة الذاكرة المؤقتة: باستخدام GetFreeSampleCount[SWS_CM_00705]، يمكن للتطبيق التحقق من عدد المواضع غير المستخدمة في الذاكرة المؤقتة المحلية لاكتشاف اختناقات المخزن المؤقت مبكرًا.
إلغاء المراجع وإلغاء الاشتراك: بعد الانتهاء من معالجة البيانات، يتم إلغاء تنشيط مشغّل الاستقبال باستخدام UnsetReceiveHandler[SWS_CM_00183] وإنهاء الاشتراك عبر Unsubscribe[SWS_CM_00151].
عند استخدام الفئة، قد تظهر رموز خطأ محددة وانتهاكات وقت تشغيل تتطلب عمليات فحص دفاعية:
خطأ في التكوين عند إعادة الاشتراك: إذا تم استدعاء Subscribe بينما الحدث مشترَك به بالفعل، واختلف maxSampleCount الجديد عن القيمة الحالية، يفشل الاستدعاء برمز الخطأ ComErrc::kMaxSampleCountNotRealizable[SWS_CM_00141]. وفي حالة نقص الأذونات، يرفض النظام التنفيذ بـ InsufficientPermissionsViolation[SWS_CM_00141].
تجاوز حدود المخزن المؤقت: إذا احتفظ التطبيق بمثيلات من ara::com::SamplePtr أكثر مما تم التعهد به في الاستدعاء السابق لـ Subscribe، يُرجع GetNewSamples رمز الخطأ ComErrc::kMaxSamplesExceeded؛ وفي هذه الحالة ربما تم التخلص من عينات البيانات [SWS_CM_00701].
عينات متبقية عند إلغاء الاشتراك: إذا لم يتم تحرير جميع ara::com::SamplePtr المحتفظ بها قبل استدعاء Unsubscribe، فإن ذلك ينتج عنه DanglingSamplesViolation[SWS_CM_00151].
تم إنشاء هذا الدليل بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.
Returns the state of the specific event class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()
Method to subscribe to a service event. If the Event is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and the provided maxSampleCount value is the same as for the current subscription, the method shall return without action.
Returns the state of the specific event class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()
• If successful: an ara::core::Result containing a ara:: core::Result::value_type i.e. a std::size_t the total number of data samples passed to f • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc
Fehler
Fehlercode
Beschreibung
ComErrc::kMaxSamplesExceeded
no_rollback_semantics Application holds more ara::com::SamplePtrs than commited in Subscribe() Samples were possibly skipped.
Request a governed re-review of this record. The record is not changed immediately.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 262c351f3d58المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الدالة SetReceiveHandler من جانب العميل في النطاق <SI-Namespace>::proxy::events::<Event> لتسجيل معالج رد اتصال للأحداث الواردة [SWS_CM_00181]. ويتم تمرير ara::com::EventReceiveHandler كمعلمة، وهو معرّف كدالة بدون معلمات ويتم استدعاؤه بواسطة Communication Management عند ورود الحدث [SWS_CM_00181]. وليس للدالة قيمة إرجاع (void) [SWS_CM_00181].
معالجة الأخطاء وسلوك الاستثناءات
تم تحديد العملية بصفتها noexcept وآمنة من الاستثناءات (exception safe) [SWS_CM_00181]. وإذا كان الكائن القابل للاستدعاء المُمرَّر غير موجود أو بقيمة null، فسيُعتبر ذلك InvalidHandlerViolation[SWS_CM_00181].
سياق التنفيذ والتكامل
ضمن واجهات Proxy، ينتمي SetReceiveHandler إلى الآليات الأساسية إلى جانب استدعاءات مثل UnsetReceiveHandler() وGetNewSamples()ARAComAPI §5.3.1 «Proxy Class API’s». وإذا كان من المقرر تنفيذ المعالج في سياق محدد مسبقًا، يتوفر التحميل الزائد للقالب مع ExecutorT[SWS_CM_11356] (ARAComAPI ص. 10).
InvalidHandlerVio- Provided Callable handler does not exist or is null lation
Parameter (in)
Parameter
Beschreibung
handler
The handler that shall be called by Communication Management upon event arrival. The EventReceiveHandler constitutes a function without parameters and has to use the f method of the specific Event class to access the retrieved event data. See [SWS_CM_00309] for its definition.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: a54152e96424المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تقوم الدالة SetSubscriptionStateChangeHandler في مساحة الأسماء proxy::events::<Event> بتسجيل دالة رد نداء (callback function) يستدعيها Communication Management بمجرد تغير الحالة ara::com::SubscriptionState للحدث ([SWS_CM_00333]). تم التصريح عن الدالة كـ noexcept وتُعد آمنة من الاستثناءات ([SWS_CM_00333]).
الاستخدام والدلالات غير المتزامنة
تعمل استدعاءات Subscribe() بشكل غير متزامن من حيث المبدأ؛ ولا يجوز اعتبار الاشتراك الناجح مكتملاً إلا عندما يبلغ المعالج المسجل أو GetSubscriptionState() عن الحالة kSubscribed ([SWS_CM_12006]). يتم استدعاء المعالج مع kSubscriptionPending إذا لم يدخل الاشتراك حيز التنفيذ فورًا (على سبيل المثال نتيجة فترات زمن الانتقال لبروتوكول ناقل البيانات) أو إذا كان مثيل الخادم غير قابل للوصول إليه بسبب عمليات إعادة التشغيل أو أخطاء الشبكة ([SWS_CM_00313]). يتم إلغاء تسجيل المعالج عبر UnsetSubscriptionStateChangeHandler() (EXP ARAComAPI §5.3.1 «Proxy Class API’s»).
معالجة الأخطاء والشروط الحدية
إذا لم يتم تمرير كائن رد نداء صالح أو إذا كان هذا الكائن خاليًا (null)، تحدث حالة الخطأ InvalidHandlerViolation ([SWS_CM_00333]). فيما يتعلق بترتيب الاستدعاء، يُستحسن تسجيل المعالج قبل Subscribe() لرصد انتقالات الحالة المبكرة بشكل موثوق. سؤال Q-3b9c25c6aa2d0a0f (مفتوح)
التفاعل والمتغيرات
لتنفيذ المعالج في سياق عمل أو خيط تنفيذ (thread) محدد مسبقًا، يتوفر متغير القالب ذو التحميل الزائد مع المعلمة ExecutorT ([SWS_CM_11354]). توجد واجهات موازية لمحفزات الوكيل ([SWS_CM_01107])، وحقول الوكيل ([SWS_CM_11607])، وكذلك على مستوى الهيكل العظمي (skeleton) ([SWS_CM_12008]).
ملاحظة استخدام مولدة بواسطة الذكاء الاصطناعي بناءً على AUTOSAR R25-11.
handler: الكائن القابل للاستدعاء (callable) المراد استدعاؤه، والذي يتم إشعاره عند حدوث تغيير في ara::com::SubscriptionState الخاص بالحدث ([SWS_CM_00333]).
executor: سياق التنفيذ وفقًا لـ [SWS_CM_11360]، الذي يجب معالجة المعالج داخله.
قيمة الإرجاع: لا تمتلك الدالة أي قيمة إرجاع (void).
معالجة الأخطاء والتنفيذ
تم التصريح عن الدالة كـ noexcept وتم تحديدها على أنها آمنة من الاستثناءات (exception safe). إذا كان الكائن القابل للاستدعاء handler المُمرر غير موجود أو كان null، يتم إطلاق InvalidHandlerViolation ([SWS_CM_11354]).
تفاعل
نمط مراقبة الحالة المرتبطة بالسياق باستخدام ExecutorT موجود بشكل مماثل لمحفزات الوكيل ([SWS_CM_01106]) بالإضافة إلى حقول الوكيل ([SWS_CM_11608]). إذا لم تكن هناك حاجة لنقل التنفيذ إلى سياق محدد، يتوفر المتغير [SWS_CM_00333].
تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى مواصفة AUTOSAR R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f1aa03e805b1المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم دالة العضو SetTransportFaultConditionHandler في حدث وكيل ([SWS_CM_00099]) لتسجيل دالة رد اتصال من النوع ara::com::e2e::TransportFaultConditionHandler. وعبر هذا المعالج، يتم الإبلاغ عن أخطاء الإرسال التي يتم اكتشافها على مستوى طبقة النقل لربط الاتصالات ([SWS_CM_00211]).
الاستخدام والدلالات:
الاستدعاء والمعلمات: تقبل الدالة كائن المعالج القابل للاستدعاء handler ولا تُرجع أي قيمة ([SWS_CM_00099]). وتم التصريح عن توقيع الطريقة كـ noexcept ([SWS_CM_00099]).
حالات الخطأ المنقولة: يبلّغ المعالج المسجل في حالة حدوث خطأ عن قيم من التعداد ara::com::e2e::TransportFaultCondition، مثل kSampleRejected عند تجاهل عينات قناة النقل الأساسية ([SWS_CM_00211]).
سياق التنفيذ: بالنسبة لعمليات التنفيذ غير المتزامنة، يتوفر تحميل زائد للقالب مع كائن منفذ (Executor) إضافي ExecutorT&& executor ([SWS_CM_00100]).
معالجة الأخطاء والشروط الحدية:
الأمان من الاستثناءات: تعتبر الدالة آمنة من الاستثناءات (exception safe) ([SWS_CM_00099]).
الانتهاكات: إذا كان الكائن القابل للاستدعاء الممرر غير موجود أو كان null، فإن هناك InvalidHandlerViolation ([SWS_CM_00099]).
التفاعل: توجد واجهات مكافئة لتسجيل TransportFaultConditionHandler أيضًا للمشغلات ([SWS_CM_00106])، وأجهزة إشعار الحقول ([SWS_CM_00109])، وطرق Skeleton ([SWS_CM_00093]).
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفة AUTOSAR.
Execution Context overload for hierarchicalnamespacelistlowerproxy::proxy:: events::eventname::SetTransportFaultConditionHandler for a given Proxy Event.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 45577c09ced5المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تسجل دالة القالب SetTransportFaultConditionHandler في حدث وكيل معالجًا خاصًا بالتطبيق من النوع ara::com::e2e::TransportFaultConditionHandler مع منفذ مخصص للمستخدم ([SWS_CM_00100]). وهي تمثل التحميل الزائد لسياق التنفيذ مقارنة بالدالة الأساسية ذات المعلمات الأقل ([SWS_CM_00099]).
الاستخدام والمعلمات: يتم استدعاء الطريقة على مثيلات <SI-Namespace>::proxy::events::<Event> ولا تُرجع أي قيمة (void) ([SWS_CM_00100]). وهي تأخذ المعالج المراد استدعاؤه (handler) وتقبل كائن منفذ (executor كمرجع عام ExecutorT&&)، والذي يُطلق في سياقه أي تنفيذ غير متزامن للمعالج ([SWS_CM_00100]). وتم التصريح عن توقيع الدالة بـ noexcept ([SWS_CM_00100]).
معالجة الأخطاء: تم تحديد العملية كـ exception safe ([SWS_CM_00100]). وإذا تم تمرير كائن غير صالح أو غير موجود قابل للاستدعاء (null)، فإن ذلك يعد انتهاكًا في صورة InvalidHandlerViolation ([SWS_CM_00100]). وعبر المعالج المسجل، يتم الإبلاغ عن أخطاء النقل المكتشفة، مثل TransportFaultCondition::kSampleRejected عند تجاهل عينات البيانات الواردة بواسطة كيان النقل الأساسي ([SWS_CM_00211]).
Method to subscribe to a service event. If the Event is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and the provided maxSampleCount value is the same as for the current subscription, the method shall return without action.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7e840633f446المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تسجل الدالة Subscribe عنصر Proxy لاستقبال أحداث الخدمة وفقًا لـ [SWS_CM_00141]. وطبيعة الاستدعاء غير متزامنة: تؤكد عودة الدالة فقط أن Communication Management قد قبلت طلب التسجيل (AUTOSAR_AP_EXP_ARAComAPI §5.3.5.2 «Monitoring Event Subscription»). ومن خلال المعلمة الإلزامية maxSampleCount، يبلغ التطبيق بشكل ملزم عن الحد الأقصى لعدد عينات الأحداث التي سيحتفظ بها في نفس الوقت، وبالتالي يقوم بتهيئة مخزن الاستقبال المؤقت المحلي (AUTOSAR_AP_EXP_ARAComAPI ص. 40).
معالجة الأخطاء والشروط الحدية
إذا كان الحدث عند الاستدعاء موجودًا بالفعل في الحالة kSubscribed أو kSubscriptionPending وكانت القيمة الممررة maxSampleCount متطابقة مع الاشتراك النشط، تعود الدالة بنجاح دون أي إجراء ([SWS_CM_00141]). أما إذا اختلف حجم الذاكرة المؤقتة عند إعادة الاشتراك، فسيفشل الاستدعاء ويُرجع في ara::core::Result رمز الخطأ ComErrc::kMaxSampleCountNotRealizable ([SWS_CM_00141]). وفي حال عدم وجود أذونات وصول، يتم رفض الاستدعاء (InsufficientPermissionsViolation وفقًا لـ [SWS_CM_00141]). والتوقيع مُعلن بصفته noexcept ويُعد آمنًا من الاستثناءات.
تفاعل
تحد سعة الذاكرة المؤقتة المحجوزة من استقبال البيانات لاحقًا عبر GetNewSamples ([SWS_CM_00701])؛ وإذا احتفظ التطبيق بمؤشرات ذكية أكثر مما هو محدد، فسيتم إطلاق الخطأ ComErrc::kMaxSamplesExceeded ([SWS_CM_10432]). بينما يتم الاشتراك في أحداث الحقول بشكل متطابق عبر maxSampleCount ([SWS_CM_11601])، لا تتطلب أحداث المُشغِّلات البحتة تحديد حجم المخزن المؤقت ([SWS_CM_00723]).
تم توليد هذا النص آليًا استنادًا إلى المواصفات وإرشادات التصميم.
• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a void • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc
Fehler
Fehlercode
Beschreibung
ComErrc::kMaxSampleCountNotRealizable
rollback_semantics Provided maxSampleCount for event re-subscription does not match the maxSampleCount for the current subscription
Request a governed re-review of this record. The record is not changed immediately.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 51bbc4b93d81المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تعد الدالة UnsetReceiveHandler جزءًا من مغلف الأحداث في النطاق <SI-Namespace>::proxy::events::<Event> ويتم تضمينها عبر ملف الترويسة #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" ([SWS_CM_00183]). وهي لا تقبل أي معاملات تمرير وليس لها قيمة إرجاع (void). يؤدي الاستدعاء إلى إزالة معالج الاستقبال الخاص بالتطبيق لحدث خدمة والذي تم تسجيله مسبقًا باستخدام SetReceiveHandler (EXP ARAComAPI §5.3.2 «RadarService Proxy Class Example»). يتيح ذلك للتطبيق المستلم التبديل في أي وقت بين الاستقبال الموجه بالأحداث («event-driven») ووضع الاستقصاء النشط («polling style») باستخدام GetNewSamples() (EXP ARAComAPI §5.3.2 «RadarService Proxy Class Example»).
معالجة الأخطاء
تم التصريح عن الطريقة بـ noexcept وتمتلك الخاصية exception safe ([SWS_CM_00183]). وهي لا تطلق أي استثناءات في وقت التشغيل ولا تُبلغ عن رموز أخطاء محددة.
التزامن والربط
بينما ينطبق على معالج رد الاتصال المسجل أنه لا يلزم أن يكون قابلاً لإعادة الدخول (reentrant)، لأن Communication Management يقوم بتسلسل الاستدعاءات (EXP ARAComAPI §5.3.2 «RadarService Proxy Class Example»)، فإن UnsetReceiveHandler يعطل مشغل الحدث لاستقبال المزيد من الإشعارات ([SWS_CM_00183]). في سياق ربط DDS، يتم تعيين الطريقة UnsetReceiveHandler() وفقًا لـ [SWS_CM_11141] وطبقًا للمعيار [SWS_CM_11026] إلى DataReader المطابق.
بالنسبة للحقول، توجد دالة تحمل نفس الاسم UnsetReceiveHandler في النطاق <SI-Namespace>::proxy::fields::<Field>، والتي تم تعريفها أيضًا كـ noexcept و exception safe ([SWS_CM_11606]).
بالنسبة للمشغلات (triggers)، يتوفر UnsetReceiveHandler في النطاق <SI-Namespace>::proxy::triggers::<Trigger>، ولكنه معلن بشكل مختلف كـ not exception safe ([SWS_CM_11614]).
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفات AUTOSAR للإصدار R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 72320dd7a142المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
وفقًا للمواصفة، صُرح عن الدالة بالمعرّف noexcept وصُنفت بأنها آمنة من الاستثناءات («exception safe») ([SWS_CM_00334]). وهي لا تطلق استثناءات C++ في حالة الخطأ ولا ترجع رموز أخطاء ([SWS_CM_00334]).
Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Event.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 91b2726516e3المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الدالة UnsetTransportFaultConditionHandler في نطاق الأسماء <SI-Namespace>::proxy::events::<Event> لإلغاء تسجيل ara::com::e2e::TransportFaultConditionHandler تم تسجيله مسبقاً لحدث وكيل معين [SWS_CM_00105]. يتم توفير التصريح عن الدالة عبر ملف الرأس <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.hAUTOSAR_AP_SWS_CommunicationManagement §8.3.2.2.1.3 «UnsetTransportFaultConditionHandler». لا يقبل الاستدعاء أي معلمات ولا يُرجع أي قيمة (void).
معالجة الأخطاء والأمان من حيث الاستثناءات
الدالة مُصرَّح بها بالمُعرِّف noexcept ومُحدَّدة بأنها آمنة للاستثناءات (exception safe) [SWS_CM_00105]. لم يحدد المعيار رموز خطأ معينة أو إخطارات للأنظمة الفرعية للأخطاء أو التشخيص.
سير العمل والشروط الحدية
يُرجَّح أن يتم تنفيذ الاستدعاء بشكل متزامن لإيقاف معالجة أخطاء E2E فورياً على مستوى الحدث، على سبيل المثال عندما لا يعود الحدث بحاجة للمراقبة أو قبل تحرير كائن الوكيل المقترن به (تفسير). سؤال Q-ff00695fff5407fe (مفتوح) بعد التنفيذ، لا تعالج طبقة الاتصال أي أخطاء نقل E2E عبر رد النداء المحفوظ مسبقاً لهذا الحدث.
تفاعل
يتبع إلغاء تسجيل معالجات أخطاء النقل نمطاً موحداً عبر عناصر الاتصال المختلفة:
بالنسبة لمُخطِرات الحقول على مستوى الوكيل، تُستخدم الدالة [SWS_CM_00126].
بالنسبة لمشغلات الوكيل (Proxy Triggers)، يتم إلغاء تسجيل المعالج عبر [SWS_CM_00108].
من جانب الهيكل البرمجي (Skeleton)، تتوفر واجهات مماثلة لجميع دوال واجهة الخدمة ([SWS_CM_00095]) وكذلك لدوال Getter/Setter للحقول ([SWS_CM_00098]).
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR.
Method to unsubscribe from a service event. If the Event is not subscribed to at the time of the call, the method shall return without action.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: fb295b3ef414المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُنهي الطريقة Unsubscribe() الاشتراك النشط لحدث خدمة في جانب الوكيل ([SWS_CM_00151]، EXP_ARAComAPI §5.5). وهي معرّفة في نطاق الرؤية <SI-Namespace>::proxy::events::<Event> ويتم تضمينها عبر ملف الرأس #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" ([SWS_CM_00151]). لا تقبل الدالة أي معلمات تمرير ولا تُرجع أي قيمة (void). إذا لم يكن الحدث مشتركًا فيه وقت الاستدعاء، تعود الطريقة دون تنفيذ أي إجراء ([SWS_CM_00151]).
معالجة الأخطاء والأمان من الاستثناءات
تم التصريح عن العملية باستخدام المحدد noexcept وتحديدها على أنها آمنة من الاستثناءات ([SWS_CM_00151]). وتم النص على انتهاك (Violation) كـ DanglingSamplesViolation في حال تم انتهاك الشرط المسبق وفقًا لـ [SWS_CM_00085] قبل استدعاء الطريقة ([SWS_CM_00151]).
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني