DEENESPTFRRUARHIKOZHNL

فئة <SI-Namespace>::proxy::triggers::<Trigger>

[SWS_CM_00727] Upstream: RS_CM_00103, RS_AP_00114

class <Trigger> final {...};

Service proxy Trigger class, one for each Trigger defined in the ServiceInterface in the role trigger.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Forwarding-Header#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy/<SiShortname>_proxy_fwd.h"
Scopenamespace <SI-Namespace>::proxy::triggers

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

يشترك في محفزات الخدمة الخالية من البيانات ويحسب نبضات الإطلاق الواردة لتطبيق العميل.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f0b35174b21c المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يشترك في محفزات الخدمة الخالية من البيانات ويحسب نبضات الإطلاق الواردة لتطبيق العميل.

تتيح الفئة <SI-Namespace>::proxy::triggers::<Trigger> لتطبيقات العميل الاشتراك في نبضات المشغلات (Triggers) الخالية من البيانات عبر Communication Management [SWS_CM_00723]. بعد تسجيل رد نداء عبر SetReceiveHandler()، يقرأ التطبيق النبضات الواردة حديثًا باستخدام GetNewTriggers() [SWS_CM_00226]، [SWS_CM_00250]. أمان الاستثناءات مضمون افتراضيًا باستثناء UnsetReceiveHandler() [SWS_CM_11614].

السياق

تمثل فئة الوكيل المُولدة <SI-Namespace>::proxy::triggers::<Trigger> على جانب العميل عنصر مشغل واحدًا بالضبط، والمصمم في واجهة الخدمة في الدور trigger AUTOSAR_AP_SWS_CommunicationManagement §8 «Service proxy Trigger class». وعلى عكس تدفقات البيانات القائمة على الأحداث، يرسل المشغل نبضات إطلاق مجردة دون بيانات حمولة. تعمل الفئة كجهة وسيطة بين تطبيق العميل المستخدم، وCommunication Management (ara::com)، وكذلك نظام مراقبة E2E. وتتمثل مهمتها الأساسية في إدارة الاشتراك للمشغلات الواردة، وتسجيل ردود نداء الإشعارات لورود النبضات أو تغيرات الحالة، وتوفير عدد مرات الإطلاق الواردة عبر عداد [SWS_CM_00226]، [SWS_CM_00250].

دورة الحياة

ترتبط دورة حياة مثيل <SI-Namespace>::proxy::triggers::<Trigger> بدورة حياة كائن وكيل الخدمة الرئيسي، والذي يوجد فيه كعضو فئة. ومن حيث الحالة، يمر اشتراك المشغل بعدة مراحل يتم تمثيلها بواسطة ara::com::SubscriptionState ويمكن الاستعلام عنها عبر GetSubscriptionState() [SWS_CM_01105]:

  • غير مشترك: الحالة الأولية قبل استدعاء Subscribe() أو بعد Unsubscribe() ناجح [SWS_CM_00723]، [SWS_CM_00810].
  • الاشتراك معلق (kSubscriptionPending): حالة وسيطة بعد إطلاق Subscribe() أثناء تأكيد الاشتراك [SWS_CM_00723].
  • مشترك (kSubscribed): الاشتراك نشط؛ وتؤدي نبضات المشغل الواردة إلى زيادة العداد الداخلي وإخطار المعالج المسجل [SWS_CM_00226]، [SWS_CM_00250].

استدعاء Subscribe() مجددًا في الحالتين kSubscribed أو kSubscriptionPending يظل بلا تأثير ويعود دون تنفيذ أي إجراء [SWS_CM_00723]. وبالمثل يتصرف Unsubscribe() إذا لم يكن اشتراك المشغل قائمًا في وقت الاستدعاء [SWS_CM_00810]. ولمراقبة تغيرات الحالة، يمكن للتطبيق تعيين رد نداء مطابق باستخدام SetSubscriptionStateChangeHandler() [SWS_CM_01107] أو إلغاء تسجيله عبر UnsetSubscriptionStateChangeHandler() [SWS_CM_01108].

TriggerState kNotSubscribed غير مشترك kSubscriptionPending kSubscriptionPending kNotSubscribed->kSubscriptionPending Subscribe() kSubscriptionPending->kNotSubscribed Unsubscribe() kSubscribed kSubscribed kSubscriptionPending->kSubscribed تأكيد kSubscribed->kNotSubscribed Unsubscribe()

مخطط الحالة: دورة حياة اشتراك المشغل مع الانتقالات بواسطة Subscribe وUnsubscribe. المصادر: [SWS_CM_00723]، [SWS_CM_00810]، [SWS_CM_01105].

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

يتضمن مسار الاستخدام النموذجي للمعالجة الموجهة بالأحداث لإشارات المشغل كلاً من تكوين ردود النداء، وتفعيل الاشتراك، والاستعلام عن العداد:

  1. تسجيل المعالج: يقوم التطبيق اختياريًا بتعيين معالج حالة عبر SetSubscriptionStateChangeHandler() [SWS_CM_01107] وإلزاميًا بتعيين معالج استقبال عبر SetReceiveHandler() [SWS_CM_00250]. بالنسبة للمعماريات المتزامنة، تتوفر تحميلات زائدة مع ExecutorT مخصص، والتي تحدد سياق التنفيذ للحسابات غير المتزامنة [SWS_CM_00352]، [SWS_CM_01106].
  2. طلب الاشتراك: يتم بدء اشتراك المشغل باستخدام Subscribe() [SWS_CM_00723].
  3. استقبال الإشارة واسترجاع العداد: بمجرد وصول نبضة مشغل، يستدعي Communication Management المعالج TriggerReceiveHandler دون معلمات [SWS_CM_00250]. وداخل هذا المعالج، يستدعي التطبيق GetNewTriggers() لتحديث عداد المشغل وقراءة عدد النبضات التي وصلت منذ آخر استدعاء [SWS_CM_00226]. وتشير القيمة 0 إلى عدم وجود نبضات جديدة.
  4. الإنهاء: للتفكيك المنظم، يستدعي التطبيق Unsubscribe() [SWS_CM_00810] ويزيل المعالجات المحددة عبر UnsetReceiveHandler() [SWS_CM_11614] وكذلك UnsetSubscriptionStateChangeHandler() [SWS_CM_01108].
سير معالجة إشارة المشغّلالتطبيقProxy TriggerCommunication ManagementSetReceiveHandler(handler)Subscribe()Abonnement anfordernUse Case: وصول حدث المشغّلhandler() (TriggerReceiveHandler)GetNewTriggers()std::size_t (قيمة العداد)Use Case: BereinigungUnsubscribe()UnsetReceiveHandler()

مخطط التسلسل: المسار النموذجي لمعالجة المشغل بدءًا من التسجيل والاشتراك مرورًا باستقبال الإشارة وحتى إلغاء التسجيل. المصادر: [SWS_CM_00226]، [SWS_CM_00250]، [SWS_CM_00723]، [SWS_CM_00810]، [SWS_CM_11614].

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

تحدد المواصفة شروط انتهاك محددة (Violations) ومستويات أمان الاستثناءات لطرق الواجهة:

  • InvalidHandlerViolation: يحدث عند تمرير كائن استدعاء (Callable) غير صالح أو فارغ (Null) في SetReceiveHandler() [SWS_CM_00250]، أو [SWS_CM_00352]، أو SetSubscriptionStateChangeHandler() [SWS_CM_01106]، أو [SWS_CM_01107] أو SetTransportFaultConditionHandler() [SWS_CM_00106]، [SWS_CM_00107].
  • InsufficientPermissionsViolation: يتم إطلاقه عند Subscribe() إذا رفض التحكم في الوصول (Grant Enforcement) الإذن لاشتراك المشغل [SWS_CM_00723].
  • خطأ النقل في حماية E2E: يتم الإبلاغ عن حالات النقل الخاطئة عبر المعالج المسجل باستخدام SetTransportFaultConditionHandler() [SWS_CM_00106]، [SWS_CM_00107]، والذي يمكن إلغاء تسجيله مرة أخرى عبر UnsetTransportFaultConditionHandler() [SWS_CM_00108].
  • أمان الاستثناءات: تم الإعلان عن جميع العمليات تقريبًا كـ noexcept وهي آمنة من الاستثناءات (exception safe) [SWS_CM_00226]، [SWS_CM_00723]. ويشكل UnsetReceiveHandler() استثناءً، حيث تم تصنيفه صراحةً وفقًا للمواصفة على أنه غير آمن من الاستثناءات (not exception safe) [SWS_CM_11614]؛ ويُرجح أن الاستدعاء قد يمرر استثناءات في حالة حدوث أخطاء أو يتطلب معالجة أخطاء منفصلة في تطبيق العميل. سؤال Q-3f9833ab71a91dd1 (مفتوح)

يستند هذا الدليل حصريًا إلى مواصفة AUTOSAR Adaptive R25-11 للموديول Communication Management.

خريطة الأعضاء

مخطط الفئة

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

G n_SI_Namespace___proxy__triggers___Trigger_725 <Trigger> + SetTransportFaultConditionHandler() + UnsetTransportFaultConditionHandler() + GetNewTriggers() + GetSubscriptionState() + SetSubscriptionStateChangeHandler() + Subscribe() + UnsetSubscriptionStateChangeHandler() + Unsubscribe() + SetReceiveHandler() + UnsetReceiveHandler()

عرض التفاصيل

اختر عنصرًا من المخطط.

الدوال الأعضاء

Method to update the trigger counter.

std::size_t GetNewTriggers () noexcept;

Query ara::com::SubscriptionState, as per [SWS_CM_00310].

ara::com::SubscriptionState GetSubscriptionState () const noexcept;

Trigger SetReceiveHandler

التحميلات الزائدة SetReceiveHandler 2
void SetReceiveHandler (ara::com::TriggerReceiveHandler handler) noexcept; SWS_CM_00250
template <typename ExecutorT> void SetReceiveHandler (ara::com::TriggerReceiveHandler handler, ExecutorT &&executor) noexcept; SWS_CM_00352

As per [SWS_CM_01107] but the method shall execute in a provided context

التحميلات الزائدة SetSubscriptionStateChangeHandler 2
template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept; SWS_CM_01106
void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept; SWS_CM_01107

Provides possibility to register a TransportFaultConditionHandler for a given Proxy Trigger.

التحميلات الزائدة SetTransportFaultConditionHandler 2
void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept; SWS_CM_00106
template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept; SWS_CM_00107
Subscribe دالة

Method to subscribe to a service trigger. When called it starts a subscription of the corresponding Trigger. If the Trigger is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and this method is invoked, it shall return without any action.

void Subscribe () noexcept;

Disable Trigger receive handler

void UnsetReceiveHandler ();

Unset ara::com::SubscriptionState change handler

void UnsetSubscriptionStateChangeHandler () noexcept;

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Trigger.

void UnsetTransportFaultConditionHandler () noexcept;
Unsubscribe دالة

Method to unsubscribe from a service trigger. If the Trigger is not subscribed to at the time of the call invoked, it shall return without any action.

void Unsubscribe () noexcept;

توثيق الدوال

دالة GetNewTriggers [SWS_CM_00226] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00139

std::size_t GetNewTriggers () noexcept;

Method to update the trigger counter.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
std::size_tThe number of triggers occurred since the last call to GetNew Triggers (a Zero value means that no new triggers have been received)

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

Record
AUTOSAR/AP/record/SWS_CM_00226
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00226@rel:R25-11#580b347c
Content hash
580b347c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00226
Status: valid/unmigrated Version: rel:R25-11#f934d813 Versionshistorie & Revisions (1 transition, 6 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_00226@rel:R25-11#f934d813
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#199cadc92026-09-30
  • R21-11rel:R21-11#cb20f15d2026-10-14
  • R22-11rel:R22-11#cb20f15d2026-10-14
  • R23-11rel:R23-11#7efe3ed62026-10-14
  • R24-11rel:R24-11#33fa04b82026-10-14
  • R25-11rel:R25-11#f934d8132026-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

دالة GetSubscriptionState [SWS_CM_01105] Upstream: RS_CM_00106

ara::com::SubscriptionState GetSubscriptionState () const noexcept;
Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::SubscriptionStateThe state of the subscription.

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

Record
AUTOSAR/AP/record/SWS_CM_01105
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01105@rel:R25-11#1665d9a7
Content hash
1665d9a7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01105
Status: valid/unmigrated Version: rel:R25-11#9a5b7923 Versionshistorie & Revisions (1 transition)
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_01105@rel:R25-11#9a5b7923
Point-in-Time History:
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

دالة SetReceiveHandler [SWS_CM_00250] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120, RS_AP_00121

void SetReceiveHandler (ara::com::TriggerReceiveHandler handler) noexcept;

Trigger SetReceiveHandler

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6c77e80a6df1 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستدعى الدالة SetReceiveHandler ضمن نطاق فئة المشغل الخاصة بوكيل الخدمة (<SI-Namespace>::proxy::triggers::<Trigger>) ويتم تضمينها عبر ملف الرأس <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h [SWS_CM_00250]. وتشكل المشغلات (Triggers) إلى جانب الأحداث، والأساليب، والحقول إحدى آليات الاتصال الأربع في ara::com EXP_ARAComAPI §4.2 «Means of Communication».

تستقبل المعلمة handler من النوع ara::com::TriggerReceiveHandler كائنًا قابلًا للاستدعاء، والذي يتم استدعاؤه بواسطة Communication Management عند ورود مشغل. ولا يمتلك المعالج نفسه أي معلمات؛ وللاستعلام عن قيمة عداد المشغل الحالية، يجب استدعاء الأسلوب GetNewTriggers لفئة المشغل المحددة داخل دالة رد النداء [SWS_CM_00250].

معالجة الأخطاء والأمان من الاستثناءات

لا يُرجع التسجيل أي قيمة (void) وهو معرف على أنه noexcept وكذلك exception safe [SWS_CM_00250]. ويحدث انتهاك لاتفاقية الاستدعاء في صورة InvalidHandlerViolation إذا كان الـ Callable الممرر غير موجود أو null [SWS_CM_00250].

التفاعل والمتغيرات

بالنسبة للسيناريوهات التي يتعين فيها تنفيذ معالج المشغل في سياق تنفيذ محدد، يتوفر التحميل الزائد للقالب مع ExecutorT [SWS_CM_00352]. وتتوفر أساليب تسجيل مماثلة لدوال رد النداء على مستوى الوكيل أيضًا للأحداث ([SWS_CM_00181]، [SWS_CM_11356]) وكذلك للحقول ([SWS_CM_11605]، [SWS_CM_11611]) EXP_ARAComAPI §5.3.1 «Proxy Class API’s».

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerThe handler that shall be called by Communication Management upon trigger arrival. The ara::com::TriggerReceiveHandler constitutes a function without parameters and has to use the Get NewTriggers method of the specific Trigger class to access the retrieved trigger counter. See [SWS_CM_00351] for it’s definition.

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00250
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00250@rel:R25-11#12b1ec27
Content hash
12b1ec27
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00250
Status: valid/unmigrated Version: rel:R25-11#999cd417 Versionshistorie & Revisions (1 transition, 4 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_00250@rel:R25-11#999cd417
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#a8f6c0c62026-09-30
  • R23-11rel:R23-11#8da588682026-10-14
  • R24-11rel:R24-11#c63fcde62026-10-14
  • R25-11rel:R25-11#999cd4172026-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

دالة SetReceiveHandler [SWS_CM_00352] Upstream: RS_CM_00211, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetReceiveHandler (ara::com::TriggerReceiveHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_00250] but the method shall execute in a provided context

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00181]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00352
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00352@rel:R25-11#abceef2b
Content hash
abceef2b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00352
Status: valid/unmigrated Version: rel:R25-11#7a0a39e7 Versionshistorie & Revisions (1 transition, 4 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_00352@rel:R25-11#7a0a39e7
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#774e38c12026-09-30
  • R23-11rel:R23-11#589034f42026-10-14
  • R24-11rel:R24-11#751a07032026-10-14
  • R25-11rel:R25-11#7a0a39e72026-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

دالة SetSubscriptionStateChangeHandler [SWS_CM_01106] Upstream: RS_CM_00106, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_01107] but the method shall execute in a provided context

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d2573855e57e المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تسجّل الدالة القالبية SetSubscriptionStateChangeHandler في نطاق الصلاحية <SI-Namespace>::proxy::triggers::<Trigger> دالة رد نداء للإشعار بتغييرات حالة الاشتراك ([SWS_CM_01106]). يتم التصريح عنها عبر ملف الترويسة <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h وتقبل معاملَين:

  • handler: الوحدة القابلة للاستدعاء من النوع ara::com::SubscriptionStateChangeHandler، والتي يُفترض تنفيذها عند حدوث تغيير في الحالة ([SWS_CM_01107]).
  • executor: سياق تنفيذ من النوع ExecutorT ([SWS_CM_11360])، يجب أن يتم تنفيذ المعالج بداخله.

عملية التسجيل نفسها تتصرف بشكل متزامن وليس لها قيمة إرجاع (void). ويتم تنفيذ دالة الرد نداء المسجلة عند حدوث تغييرات في الحالة ضمن سياق التنفيذ المحدد.

معالجة الأخطاء والأمان من الاستثناءات

تم التصريح عن الدالة بأنها noexcept وتحديدها كـ exception safe ([SWS_CM_01106]). إذا كان كائن Callable المُمرَّر غير موجود أو فارغاً (null)، فهذا يمثل InvalidHandlerViolation ([SWS_CM_01106]). وبما أنه لا يتم إطلاق أي استثناءات، فمن المحتمل أن يؤدي المعالج غير الصالح إلى مسار خطأ خاص بالمنصة (تفسير). سؤال Q-cbb90bfbfa10338d (مفتوح)

التزامن والتفاعل

من خلال تمرير المنفّذ ([SWS_CM_11360])، يتحكم التطبيق بنفسه في سياق التنفيذ الخاص بدوال الرد نداء للحالة. ويُرجح أن يمنع ذلك استدعاءات المعالج طويلة الأمد من حظر معالجة الأحداث الداخلية لإدارة الاتصالات (تفسير). سؤال (مفتوح) توسّع هذه الدالة النسخة المجردة من السياق [SWS_CM_01107] وتشكل المقابل للمُطلِق للواجهات المعتمدة على المنفّذ لأحداث الوكيل ([SWS_CM_11354])، وحقول الوكيل ([SWS_CM_11608])، ومُطلِقات الهيكل الأساسي (Skeleton) ([SWS_CM_11111]).

تم إنشاء ملاحظة الاستخدام هذه تلقائياً استناداً إلى مواصفات AUTOSAR Adaptive Platform.

دليل المنفِّذ قيد الإعداد (التعقيد I3)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_01107]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_01106
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01106@rel:R25-11#f1830770
Content hash
f1830770
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01106
Status: valid/unmigrated Version: rel:R25-11#c7808b12 Versionshistorie & Revisions (1 transition)
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_01106@rel:R25-11#c7808b12
Point-in-Time History:
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

دالة SetSubscriptionStateChangeHandler [SWS_CM_01107] Upstream: RS_CM_00106

void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept;

Set ara::com::SubscriptionState change handler

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b21ff32dc0c5 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

باستخدام الدالة [SWS_CM_01107]، يُسجَّل في نطاق الوكيل (proxy) لمشغّل (<SI-Namespace>::proxy::triggers::<Trigger>) معالج رد نداء يستدعيه Communication Management عند كل تغيير في حالة الاشتراك (ara::com::SubscriptionState). لا تمتلك الدالة أي قيمة إرجاع وهي محددة على أنها آمنة من الاستثناءات (noexcept).

نظراً لأن الاشتراك يجب معاملته مبدئياً كعملية غير متزامنة، فلا يجوز للتطبيق أن يفترض نجاح الاشتراك إلا عندما يبلّغ المعالج المسجل عبر [SWS_CM_01107] أو دالة الاستعلام GetSubscriptionState() عن الحالة kSubscribed [SWS_CM_12006]. وفي حالة حدوث تأخيرات زمنية أو عندما يكون الخادم غير متاح مؤقتاً نتيجة لإعادة تشغيل أو مشكلة في الشبكة، ينشط Communication Management المعالج مع الحالة kSubscriptionPending [SWS_CM_00313].

تنطبق الشروط الحدية التالية على معالجة الأخطاء والتكامل:

  • معالجة الأخطاء: يُعد تمرير كائن قابل للاستدعاء (callable) غير موجود أو فارغ (null) غير مسموح به ويؤدي إلى InvalidHandlerViolation [SWS_CM_01107].
  • سياق التنفيذ: إذا كان ينبغي تنفيذ المعالج ليس في السياق القياسي، بل ضمن سياق تنفيذ محدد، فإن التحميل الزائد للقالب (template overload) مع ExecutorT&& يكون متاحاً [SWS_CM_01106].
  • التفاعل المتبادل: لأحداث الخدمة، توجد الواجهة البرمجية المماثلة [SWS_CM_00333] ضمن واجهات برمجة التطبيقات (APIs) العامة لفئة الوكيل ARAComAPI §5.3.1 «Proxy Class API’s».

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

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerThe handler that shall be called by Communication Management when the ara::com::SubscriptionState of the event has changed.

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_01107
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01107@rel:R25-11#bebc1ea9
Content hash
bebc1ea9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01107
Status: valid/unmigrated Version: rel:R25-11#465350f1 Versionshistorie & Revisions (1 transition)
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_01107@rel:R25-11#465350f1
Point-in-Time History:
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

دالة SetTransportFaultConditionHandler [SWS_CM_00106] Upstream: RS_CM_00224, RS_E2E_08534

void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept;

Provides possibility to register a TransportFaultConditionHandler for a given Proxy Trigger.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 979128a8c136 المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة SetTransportFaultConditionHandler في مثيل من proxy::triggers::<Trigger> لتسجيل دالة رد اتصال من النوع ara::com::e2e::TransportFaultConditionHandler ([SWS_CM_00106]). وهي تأخذ المعلمة handler، وليس لها قيمة إرجاع، ومحددة كـ noexcept وكذلك exception safe ([SWS_CM_00106]).

من خلال المعالج المسجل، تشير طبقة الاتصالات إلى الأخطاء المكتشفة في طبقة الإرسال. وفي ربط شبكة DDS، يبلّغ المعالج عن أحداث كيان DataReader الأساسي كـ TransportFaultCondition ([SWS_CM_00212]):

  • TransportFaultCondition::kSampleRejected عند تجاهل العينات (بسبب نقص الذاكرة أو تلف البيانات مثلاً)،
  • TransportFaultCondition::kDeadlineMissed عند انتهاك المواعيد النهائية للاستلام (REQUESTED_DEADLINE_MISSED)،
  • TransportFaultCondition::kSampleLost عند فقدان عينات البيانات المكتشفة ([SWS_CM_00212]).

إذا تم تمرير معالج غير موجود أو فارغ بدلاً من كائن صالح قابل للاستدعاء، تبلّغ بيئة التشغيل عن InvalidHandlerViolation ([SWS_CM_00106]). ونظرًا لأن توقيع الدالة مصرح عنه كـ noexcept، فمن المحتمل أن يؤدي هذا الانتهاك إلى معالجة أخطاء من جانب المنصة بدلاً من استثناء C++. سؤال Q-ebaf44b8f7b198e8 (مفتوح)

يتم التسجيل بشكل متزامن في سياق المتصل؛ ولا يتم تفويض تنفيذ المعالج في هذا التحميل الزائد إلى مرسل (dispatcher) محدد. وإذا كان يتعين تشغيل رد الاتصال في سياق تنفيذ محدد، فإن صيغة القالب ذات التحميل الزائد مع ExecutorT&& إضافي تكون متاحة ([SWS_CM_00107]). ومن المرجح أن يتم الربط عادةً قبل المعالجة الفعلية للمشغل لالتقاط الأخطاء منذ البداية. سؤال (مفتوح)

توجد إمكانيات تسجيل متوافقة لـ TransportFaultConditionHandler بالمثل لأحداث الوكيل ([SWS_CM_00099])، وحقول الوكيل ([SWS_CM_00109])، وكذلك طرق Skeleton ([SWS_CM_00093]) وحقول Skeleton ([SWS_CM_00096]).

تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو بمثابة دليل توجيهي. وتعتبر مواصفات AUTOSAR المرجعية هي الملزمة.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerHandler of type TransportFaultConditionHandler to be set

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00106
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00106@rel:R25-11#7b3f87ef
Content hash
7b3f87ef
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00106
Status: valid/unmigrated Version: rel:R25-11#a6d4504c Versionshistorie & Revisions (1 transition, 3 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_00106@rel:R25-11#a6d4504c
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#8276dedf2026-09-30
  • R24-11rel:R24-11#807777b02026-10-14
  • R25-11rel:R25-11#a6d4504c2026-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

دالة SetTransportFaultConditionHandler [SWS_CM_00107] Upstream: RS_CM_00224, RS_E2E_08534

template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept;

Execution Context overload for hierarchicalnamespacelistlowerproxy::proxy:: triggers::triggername::SetTransportFaultConditionHandler for a given Proxy Trigger.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 653e5e8a79be المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة [SWS_CM_00107] لتسجيل روتين رد اتصال (Callback) لأخطاء النقل لمشغّل وكيل في نطاق الأسماء <SI-Namespace>::proxy::triggers::<Trigger>. وبصفتها تحميلًا زائدًا (Overload) مع سياق تنفيذ، فإنها تقبل كائن منفّذ (Executor) executor إلى جانب المعالج من النوع ara::com::e2e::TransportFaultConditionHandler، والذي تُنفَّذ فيه الحسابات غير المتزامنة التي تم إطلاقها.

تسري التحديدات التالية على الاستخدام ومعالجة الأخطاء:

  • المعلمات والقيمة المرجعة: تمرر المعلمة handler الكائن القابل للاستدعاء المراد ضبطه، بينما يحدد executor سياق التنفيذ للمهام غير المتزامنة [SWS_CM_00107]. لا تُرجع الدالة أي قيمة ومصرَّح عنها كـ noexcept (أمان الاستثناءات: exception safe).
  • حالات الخطأ والانتهاكات: إذا مُرِّر معالج غير موجود أو غير صالح (null)، يُبلّغ وقت التشغيل عن InvalidHandlerViolation [SWS_CM_00107].
  • حالات الأخطاء المُبلَّغ عنها: يستقبل المعالج المسجَّل أخطاء النقل المكتشفة وفقًا لـ [SWS_CM_00212]. ويشمل ذلك TransportFaultCondition::kSampleRejected (على سبيل المثال عند تلف البيانات أو نقص الموارد)، وTransportFaultCondition::kDeadlineMissed (عند انتهاك المهل الزمنية)، وكذلك TransportFaultCondition::kSampleLost (عند فقدان العينات).

بالمقارنة مع الدالة الأساسية الخالية من المنفّذ [SWS_CM_00106]، يتيح هذا الخيار التحكم المستهدف في سياق التزامن لمعالجة أخطاء المشغّل. وتوجد تحميلات زائدة مماثلة ذات سياق تنفيذ في إدارة الاتصالات لأحداث الوكيل ([SWS_CM_00100])، وحقول الوكيل ([SWS_CM_00110])، وكذلك على مستوى Skeleton للطرق ([SWS_CM_00094]) والحقول ([SWS_CM_00097]).

تم إنشاء إشعار الاستخدام هذا آليًا بناءً على مواصفة AUTOSAR Adaptive Platform R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerHandler to be set
executorExecutor object in which any asynchronous computation spawn shall be invoked

Rückgabewert

TypBeschreibung
None
Siehe auch: [SWS_CM_00106]

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

Record
AUTOSAR/AP/record/SWS_CM_00107
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00107@rel:R25-11#77f09da3
Content hash
77f09da3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00107
Status: valid/unmigrated Version: rel:R25-11#b77dbb3c Versionshistorie & Revisions (1 transition, 3 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_00107@rel:R25-11#b77dbb3c
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#ed4541552026-09-30
  • R24-11rel:R24-11#eeb2c97a2026-10-14
  • R25-11rel:R25-11#b77dbb3c2026-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

دالة Subscribe [SWS_CM_00723] Upstream: RS_CM_00103, RS_AP_00114, RS_AP_00120

void Subscribe () noexcept;

Method to subscribe to a service trigger. When called it starts a subscription of the corresponding Trigger. If the Trigger is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and this method is invoked, it shall return without any action.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: cad2e3ac0bc9 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة Subscribe للاشتراك من جهة العميل في مشغّل خدمة عبر مثيل وكيل في مساحة الأسماء <SI-Namespace>::proxy::triggers::<Trigger> [SWS_CM_00723]. قبل الاستخدام، يجب إتاحة مثيل الخدمة من جهة الخادم عبر OfferService() والعثور عليه بواسطة العميل عبر آليات Service Discovery AUTOSAR_AP_EXP_ARAComAPI §4.2 «Means of Communication».

بالمقارنة مع اشتراكات الأحداث ([SWS_CM_00141]) واشتراكات الحقول ([SWS_CM_11601])، يُظهر Subscribe خصائص محددة للمشغلات:

  • المعلمات والتخزين المؤقت: لا تقبل الدالة أي معلمات (void Subscribe() noexcept) [SWS_CM_00723]. نظرًا لأن المشغلات تنقل إشعارات محضة بدون عينات بيانات، فإن الحجز المعتاد لذاكرة تخزين مؤقت للعينات محليًا عبر maxSampleCount كما في الأحداث لا ينطبق [SWS_CM_00141].
  • قيمة الإرجاع: لا يتم إرجاع ara::core::Result، بل void [SWS_CM_00723].
  • اللاتزامن: يبدأ الاستدعاء عملية الاشتراك؛ ويُفترض أن إنشاء الاتصال الفعلي بمثيل الخدمة يتم بشكل غير متزامن في Communication Management على نحو مماثل لاشتراكات الأحداث AUTOSAR_AP_EXP_ARAComAPI §5.3.5.2 «Monitoring Event Subscription». سؤال Q-92ae3f442b45f3cc (مفتوح)

تنطبق الشروط التالية على دورة الحياة ومعالجة الأخطاء:

  • فحص الحالة والتكرار الحيادي: إذا كان المشغل بالفعل في الحالة kSubscribed أو kSubscriptionPending عند وقت الاستدعاء، تعود الطريقة فورًا دون اتخاذ أي إجراء إضافي [SWS_CM_00723].
  • أمان الاستثناءات: تم تحديد الدالة على أنها noexcept وexception safe [SWS_CM_00723].
  • التحكم في الوصول: في حالة عدم كفاية الصلاحيات، يرفض إنفاذ المنح التنفيذ باستخدام InsufficientPermissionsViolation [SWS_CM_00723].

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي وتستند حصريًا إلى متطلبات المواصفات من AUTOSAR Adaptive R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe
Verletzungen (Violations)InsufficientPer- Refused by Grant Enforcement missionsViolation

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00723
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00723@rel:R25-11#54067b1e
Content hash
54067b1e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00723
Status: valid/unmigrated Version: rel:R25-11#c781043c Versionshistorie & Revisions (1 transition, 6 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_00723@rel:R25-11#c781043c
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#efea6fd02026-09-30
  • R21-11rel:R21-11#3e3032682026-10-14
  • R22-11rel:R22-11#3e3032682026-10-14
  • R23-11rel:R23-11#91a4b8412026-10-14
  • R24-11rel:R24-11#0233787d2026-10-14
  • R25-11rel:R25-11#c781043c2026-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

دالة UnsetReceiveHandler [SWS_CM_11614] Upstream: RS_CM_00203

void UnsetReceiveHandler ();

Disable Trigger receive handler

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 78176c7d7edd المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الدالة المتزامنة UnsetReceiveHandler في مساحة الاسم <SI-Namespace>::proxy::triggers::<Trigger> لتعطيل مُعالج الاستقبال المسجل مسبقًا لمشغل الخدمة في جانب الوكيل [SWS_CM_11614]. تتطلب الدالة تضمين ملف الترويسة #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"، ولا تقبل أية معلمات تمرير، وليس لها أية قيمة إرجاع.

من خلال الاستدعاء، يتم إلغاء تسجيل رد النداء المخصص للتطبيق. يتيح ذلك للتطبيق التبديل بمرونة بين الاستقبال الموجه بالأحداث والنموذج القائم على الاستعلام (الاستطلاع) (AUTOSAR_AP_EXP_ARAComAPI ص. 46، AUTOSAR_AP_SWS_CommunicationManagement §7.5.18.1).

معالجة الأخطاء وأمان الاستثناءات

على عكس الدوال المماثلة لأحداث الخدمة [SWS_CM_00183] وحقول الخدمة [SWS_CM_11606]، المحددة صراحةً على أنها noexcept وآمنة من الاستثناءات، أُعلن عن UnsetReceiveHandler للمشغلات بأنها غير آمنة من الاستثناءات (not exception safe) [SWS_CM_11614]. تفسير: ينبغي للمستدعين الاستعداد لاحتمال طرح استثناءات عند حدوث أخطاء داخلية في البنية التحتية للاتصال، وإن لم تكن أنواع الاستثناءات المحددة أو رموز الأخطاء مذكورة في المعيار. سؤال Q-92e16243a7ddee35 (مفتوح)

التفاعل المتبادل والربط

تُعد الطريقة جزءًا من فئات المشغلات في مساحة اسم الوكيل (AUTOSAR_AP_EXP_ARAComAPI §5.3.1). وعند استخدام ربط DDS، يتم تمثيل استدعاء الطريقة وفقًا لـ [SWS_CM_11141] عبر DataReader المخصص وفقًا للقواعد المحددة في [SWS_CM_11026].

أُنشئت ملاحظة الاستخدام هذه آليًا وتستند حصريًا إلى مواصفات AUTOSAR Adaptive الإصدار R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitnot exception safe

Rückgabewert

TypBeschreibung
None
Siehe auch: [SWS_CM_00183]

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

Record
AUTOSAR/AP/record/SWS_CM_11614
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11614@rel:R25-11#980de281
Content hash
980de281
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11614
Status: valid/unmigrated Version: rel:R25-11#bbdaf9e4 Versionshistorie & Revisions (1 transition, 3 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_11614@rel:R25-11#bbdaf9e4
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#5e7e170f2026-09-30
  • R24-11rel:R24-11#34cc39122026-10-14
  • R25-11rel:R25-11#bbdaf9e42026-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

دالة UnsetSubscriptionStateChangeHandler [SWS_CM_01108] Upstream: RS_CM_00106, RS_AP_00114, RS_AP_00120

void UnsetSubscriptionStateChangeHandler () noexcept;

Unset ara::com::SubscriptionState change handler

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: de69ae0196a3 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة UnsetSubscriptionStateChangeHandler على جانب العميل لإزالة دالة رد نداء مسجلة مسبقاً لتغييرات حالة الاشتراك (ara::com::SubscriptionState) الخاصة بمُطلِق [SWS_CM_01108]. تم التصريح عنها في نطاق الصلاحية <SI-Namespace>::proxy::triggers::<Trigger> ويتم تضمينها عبر الترويسة #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" [SWS_CM_01108].

الاستخدام وسياق الاستدعاء

تمتلك الدالة البنية التوقيعية void UnsetSubscriptionStateChangeHandler () noexcept;، ولا تقبل معاملات تمرير ولا تُرجع قيمة [SWS_CM_01108]. ويتم استدعاؤها بشكل متزامن على نسخة المُطلِق المعني لفئة وكيل، وذلك لإلغاء الاشتراك في الإشعارات عند تغييرات حالة الاشتراك AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s». تفسير: بعد تنفيذ الاستدعاء، يُرجح ألا يتم تسليم المزيد من تغييرات الحالة إلى المعالج السابق. سؤال Q-d08dc975aacba85c (مفتوح)

معالجة الأخطاء والتزامن

تم التصريح عن الواجهة بأنها noexcept وتحديدها صراحةً كآمنة ضد الاستثناءات (exception safe) [SWS_CM_01108]. وبالتالي فإن فشل الاستدعاء أو إطلاق الاستثناءات أمر مستبعد، ولا توجد قيم إرجاع للأخطاء.

تفاعل

تندرج الدالة ضمن المخطط الموحد لواجهات الوكيل. وتتوفر دوال مماثلة لإلغاء التسجيل في سياق الوكيل للأحداث وفقاً لـ [SWS_CM_00334] AUTOSAR_AP_SWS_CommunicationManagement §8.3.2.2.4.5 «UnsetSubscriptionStateChangeHandler» وللحقول وفقاً لـ [SWS_CM_11609] AUTOSAR_AP_SWS_CommunicationManagement §8.3.3.2.4.5 «UnsetSubscriptionStateChangeHandler». وتوجد نظائر مقابلة على جانب الخادم أو الهيكل الأساسي (Skeleton) للمُطلِقات [SWS_CM_01112] والأحداث [SWS_CM_12010].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي، وهو بمثابة دليل توجيهي في إطار مواصفة AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_01108
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01108@rel:R25-11#52af3fe9
Content hash
52af3fe9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01108
Status: valid/unmigrated Version: rel:R25-11#ed939965 Versionshistorie & Revisions (1 transition)
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_01108@rel:R25-11#ed939965
Point-in-Time History:
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

دالة UnsetTransportFaultConditionHandler [SWS_CM_00108] Upstream: RS_CM_00224, RS_E2E_08534

void UnsetTransportFaultConditionHandler () noexcept;

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Trigger.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e7e7522ccae0 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة UnsetTransportFaultConditionHandler لإلغاء تسجيل ara::com::e2e::TransportFaultConditionHandler تم تسجيله مسبقاً لمشغل وكيل معين ([SWS_CM_00108]، موثق في AUTOSAR_AP_SWS_CommunicationManagement §8.3.7.1.1.3 «UnsetTransportFaultConditionHandler»). وهي تقع في نطاق الأسماء <SI-Namespace>::proxy::triggers::<Trigger> ويتم تضمينها عبر ملف الرأس #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" ([SWS_CM_00108]).

التوقيع هو void UnsetTransportFaultConditionHandler() noexcept;. لا يقبل الاستدعاء أي معلمات ولا يُرجع أي قيمة ([SWS_CM_00108]). وبفضل التصريح noexcept والتصنيف كـ exception safe، لا تطرح الدالة أي استثناءات أثناء التشغيل العادي ([SWS_CM_00108]). لا تنص المواصفة على رموز خطأ محددة أو قنوات خطأ أو قيم احتياطية.

فيما يتعلق بسير العمل، تلغي الدالة الربط مع روتين معالجة الأخطاء بشكل متزامن؛ وبالتالي، بعد التنفيذ الناجح، يُرجَّح ألا يتم تسليم أي إخطارات أخرى حول أخطاء نقل E2E للمشغل المعني إلى المعالج السابق (تفسير). سؤال Q-ae8477bc6530e352 (مفتوح)

في إطار النظام الكلي، يمثل هذا العنصر المقابل لدوال إلغاء التسجيل التناظرية لأنماط اتصال أخرى في AUTOSAR_AP_SWS_CommunicationManagement §8.3/8.4:

  • أحداث Proxy: UnsetTransportFaultConditionHandler على مستوى الحدث ([SWS_CM_00105]).
  • حقول Proxy: إلغاء التسجيل لمنبه الحقل ([SWS_CM_00126]).
  • مستوى Skeleton: إلغاء التسجيل لـ Get/Set الحقل ([SWS_CM_00098]) وكذلك لكافة دوال الـ Skeleton ([SWS_CM_00095]).

تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00108
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00108@rel:R25-11#629e5fbb
Content hash
629e5fbb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00108
Status: valid/unmigrated Version: rel:R25-11#5766b8c1 Versionshistorie & Revisions (1 transition, 3 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_00108@rel:R25-11#5766b8c1
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#b0faf65e2026-09-30
  • R24-11rel:R24-11#a251c51a2026-10-14
  • R25-11rel:R25-11#5766b8c12026-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

دالة Unsubscribe [SWS_CM_00810] Upstream: RS_CM_00103, RS_AP_00114, RS_AP_00120

void Unsubscribe () noexcept;

Method to unsubscribe from a service trigger. If the Trigger is not subscribed to at the time of the call invoked, it shall return without any action.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::triggers::<Trigger>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00810
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00810@rel:R25-11#b22e3876
Content hash
b22e3876
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00810
Status: valid/unmigrated Version: rel:R25-11#270e3cc7 Versionshistorie & Revisions (1 transition, 6 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_00810@rel:R25-11#270e3cc7
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#d20f32f52026-09-30
  • R21-11rel:R21-11#d12e778e2026-10-14
  • R22-11rel:R22-11#d12e778e2026-10-14
  • R23-11rel:R23-11#d12e778e2026-10-14
  • R24-11rel:R24-11#037f29922026-10-14
  • R25-11rel:R25-11#270e3cc72026-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