DEENESPTFRRUARHIKOZHNL

فئة <SI-Namespace>::skeleton::fields::<Field>

[SWS_CM_00007] Upstream: RS_CM_00219, RS_AP_00114

class <Field> {...};

Service skeleton Field class, one for each Field defined in the ServiceInterface in the role field.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h"
Forwarding-Header#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton/<SiShortname>_skeleton_fwd.h"
Scopenamespace <SI-Namespace>::skeleton::fields

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

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

يُمكّن هيكل الخدمة (Service-Skeleton) من توفير طلبات الحقول وتحديثها ومعالجتها محددة النوع.

تُوفّر الفئة <SI-Namespace>::skeleton::fields::<Field> حقلًا من ServiceInterface من جانب الخادم وتربط دوال Getter وSetter وكذلك دوال الإشعار للخدمة المُوفَّرة. ويسجل تطبيق المزوّد معالجات غير متزامنة ([SWS_CM_00114]، [SWS_CM_00116]) لعمليات الوصول الواردة للقراءة والكتابة، ويوزع تغييرات القيم بفعالية عبر الدالة Update ([SWS_CM_00119]) على العملاء المشتركين. ويجب بالضرورة أن تكون المعالجات المُمررة صالحة، في حين يجب أن تلتزم استدعاءات الإرسال بالحد الأدنى لوقت الإرسال المكوَّن، لتجنب أخطاء مثل kMinimumSendIntervalViolationError.

السياق

تُغلّف فئة القالب <SI-Namespace>::skeleton::fields::<Field> التمثيل من جانب الخادم لحقل منمذج في ServiceInterface داخل Communication Management لـ Adaptive Platform. ولكل حقل محدد في واجهة الخدمة، تُنشئ البرمجية الوسيطة مثيل فئة مطابقًا في نطاق الأسماء skeleton::fields باستخدام مسار الترويسة #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h". ويجمع الحقل بين السمات الوظيفية لنقل البيانات واستدعاءات الدوال، من خلال امتلاكه اختياريًا لـ Getter وSetter بالإضافة إلى دالة إشعار. ويُوفَّر نوع البيانات المقترن بقيمة الحقل عبر الاسم المستعار للنوع FieldType ([SWS_CM_11402]). ومن بين أطراف التفاعل المركزية: تطبيق المزوّد الموفِّر، ومثيل حقل الهيكل بوصفه وسيطًا، ومستهلكو الخدمة المشتركون (الوكلاء Proxies)، بالإضافة إلى سياقات التنفيذ الاختيارية في هيئة منفّذ (Executor) ([SWS_CM_11360]، [SWS_CM_11362]).

app Provider-Anwendung field skeleton::fields::<Field> app->field RegisterGetHandler() RegisterSetHandler() Update() field->app Get / Set Callback client Client / Proxy field->client Feld-Notifizierungen client->field Get / Set Anfragen executor ExecutorT (ara::core::Executor) executor->field Asynchroner Kontext

مخطط السياق: أطراف التفاعل لفئة Skeleton-Field أثناء الطلبات والإشعارات. المصادر: [SWS_CM_00114]، [SWS_CM_00116]، [SWS_CM_00119]، [SWS_CM_11360].

دورة الحياة

يرتبط عمر مثيل الحقل ارتباطًا وثيقًا بمثيل هيكل الخدمة الأصلي. تفسير: يُرجَّح أن يُنشأ مثيل Field ككائن عضو في فئة الهيكل المقترنة وأن يشاركها دورة حياتها بالكامل. سؤال Q-dedeaea09a8abb20 (مفتوح) ويعتمد توفر دوال الواجهة الفردية بشكل مباشر على التعريف في تصميم البرمجيات: الدالة RegisterGetHandler غير موجودة إلا إذا كُوِّن الحقل باستخدام Field.hasGetter == TRUE ([SWS_CM_00114])، بينما تفترض RegisterSetHandler وجود Setter عبر Field.hasSetter == TRUE ([SWS_CM_00116]). ولتأمين الاتصال ضد أخطاء النقل من طرف إلى طرف (End-to-End)، يمكن للتطبيق تسجيل معالج محدد عبر SetTransportFaultConditionHandler ([SWS_CM_00096]) وإزالته عند الحاجة باستخدام UnsetTransportFaultConditionHandler ([SWS_CM_00098]). وفيما يتعلق بالتزامن، تُتيح التحميلات الزائدة ذات معلمة القالب ExecutorT (مثل ara::core::Executor) إمكانية نقل تنفيذ دوال رد النداء إلى سياق تنفيذ غير متزامن محدد ([SWS_CM_11360]، [SWS_CM_11362]، [SWS_CM_00097]، AUTOSAR_AP_EXP_ARAComAPI ص. 11).

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

ينقسم مسار التشغيل المنتظم إلى تكوين دوال رد النداء، ومعالجة الاستعلامات، وكذلك الإرسال الفعال لتحديثات البيانات:

تفسير: يُرجَّح أن يتم تسجيل المعالجات بشكل ملائم قبل توفير الخدمة، من أجل التمكن من خدمة الطلبات الواردة دون ثغرات. سؤال Q-617e65d056af24f9 (مفتوح) ويربط التطبيق عند وجود Getter دالة رد نداء عبر RegisterGetHandler، والتي تُرجع ara::core::Future<FieldType> ([SWS_CM_00114]). وبالنسبة لعمليات الوصول المُعدِّلة، فإنه يسجل عبر RegisterSetHandler معالجًا يستقبل القيمة الجديدة ويعالجها ويُوفّر الحالة الناتجة أيضًا بشكل غير متزامن عبر Future ([SWS_CM_00116]). وإذا أراد مزود الخدمة تحديث قيمة الحقل بشكل مستقل، فإنه يستدعي الدالة Update بالقيمة الجديدة ([SWS_CM_00119]، AUTOSAR_AP_EXP_ARAComAPI ص. 11). وبذلك تُعيَّن الحالة الداخلية للحقل من جديد. وإذا كان الحقل منمذجًا مع دالة إشعار (Field.hasNotifier == TRUE)، فإن Update تتسبب في النقل الفوري لقيمة البيانات المتغيرة إلى جميع المشتركين المسجلين ([SWS_CM_00119]، [SWS_CM_00120]، [SWS_CM_00162]).

السير النموذجي للتفاعل مع الحقل في الهيكل (Skeleton)Provider-Anwendungskeleton::fields::<Field>Client / ProxyUse Case: التهيئة وتسجيل المعالجRegisterGetHandler(handler)RegisterSetHandler(setHandler)Use Case: معالجة Get وSetGet()handler()ara::core::Future<FieldType>إرجاع FieldTypeSet(value)setHandler(value)ara::core::Future<FieldType>Aktualisierter WertUse Case: تحديث القيمة والإشعارUpdate(value)ara::core::Result<void>Notifizierung (Event/Field-Update)

مخطط التتابع: المسار النموذجي لتسجيل المعالج، ومعالجة الطلبات، وتحديث البيانات. المصادر: [SWS_CM_00114]، [SWS_CM_00116]، [SWS_CM_00119].

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

تتجسد شروط الخطأ إما في صورة انتهاكات لعقود البرمجة عند التسجيل أو في صورة أخطاء نقل في وقت التشغيل. وتُحدد جميع دوال التسجيل للمعالجات – RegisterGetHandler وRegisterSetHandler وكذلك SetTransportFaultConditionHandler – على أنها noexcept وتتمتع بضمان الاستثناء exception safe ([SWS_CM_00114]، [SWS_CM_00116]، [SWS_CM_00096]). ويُشترط كشرط مسبق أن يكون الكائن القابل للاستدعاء (Callable) المُمرر موجودًا وألا يكون فارغًا (null)؛ ويؤدي عدم الالتزام بذلك إلى إطلاق InvalidHandlerViolation ([SWS_CM_00114]، [SWS_CM_11360]، [SWS_CM_00116]، [SWS_CM_11362]، [SWS_CM_00096]، [SWS_CM_00097]).

عند التحديث الفعال عبر Update، تحدث الإفادة عن الخطأ عبر نوع الإرجاع ara::core::Result<void> ([SWS_CM_00119]). وإذا حدث خطأ، يُرجع كائن Result رمز خطأ من ara::com::ComErrc. وبوجه خاص، يؤدي الإرسال بفترات زمنية أقصر مما هو محدد بواسطة سمة النشر ServiceInterfaceDeploymentElement.minimumSendInterval إلى إرجاع الخطأ ComErrc::kMinimumSendIntervalViolationError ([SWS_CM_00119]).

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

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

مخطط الفئة

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

G n_SI_Namespace___skeleton__fields___Field_667 <Field> + SetTransportFaultConditionHandler() + UnsetTransportFaultConditionHandler() + Update() + RegisterGetHandler() + RegisterSetHandler()

عرض التفاصيل

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

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

Register a callback function to be invoked when a Get() request is received. The method exists only if the offered service contains a Field and Field.hasGetter ==TRUE

التحميلات الزائدة RegisterGetHandler 2
void RegisterGetHandler (std::function< ara::core::Future< FieldType >()> handler) noexcept; SWS_CM_00114
template <typename ExecutorT> void RegisterGetHandler (std::function< ara::core::Future< FieldType >()> handler, ExecutorT &&executor) noexcept; SWS_CM_11360

Register a callback function to be invoked when a Set() request is received. The method exists only if the offered service contains a Field and Field.hasSetter ==TRUE

التحميلات الزائدة RegisterSetHandler 2
void RegisterSetHandler (std::function< ara::core::Future< FieldType >(<SFieldDerivedType> value)> handler) noexcept; SWS_CM_00116
template <typename ExecutorT> void RegisterSetHandler (std::function< ara::core::Future< FieldType >(<SFieldDerivedType> value)> setHandler, ExecutorT &&executor) noexcept; SWS_CM_11362

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Skeleton Field Get/Set.

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

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Skeleton Field Get/Set.

void UnsetTransportFaultConditionHandler () noexcept;
Update دالة

Initiate the transmission of updated field data to the subscribers. See [SWS_CM_00162] for the required behavior. The Update function shall also update the fields internal value. An update notification shall be sent to any subscribers if: • Field.hasNotifier ==TRUE (according to [SWS_CM_00120])

ara::core::Result< void > Update (<SFieldDerivedType> value) noexcept;

أسماء الأنواع البديلة

FieldType اسم نوع بديل

Data type for the value of a field (an alias for the CppImplementationDataType of the Field, i.e. for the CppImplementationDataType which is either referenced by the VariableDataPrototype in the role type directly or via indirection of a DataTypeMap)

using FieldType = <SFieldCppidt>;

توثيق الدوال

دالة RegisterGetHandler [SWS_CM_00114] Upstream: RS_CM_00218, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

void RegisterGetHandler (std::function< ara::core::Future< FieldType >()> handler) noexcept;

Register a callback function to be invoked when a Get() request is received. The method exists only if the offered service contains a Field and Field.hasGetter ==TRUE

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

الاستخدام

تُستدعى الدالة RegisterGetHandler من جهة الخادم على كائن الحقل لـ Skeleton ([SWS_CM_00114]). ولا توجد في الكود المُولَّد إلا إذا تم تكوين غيتِر (Getter) للحقل المعني في وصف الواجهة (Field.hasGetter == TRUE) (EXP ARAComAPI §5.4.8.1 «Registering Getters»). ويتم تمرير رد اتصال handler من النوع std::function<ara::core::Future<FieldType>()>، والذي يتم استدعاؤه بواسطة تنفيذ الربط (Binding) عند ورود طلب Get() من جانب Proxy.

يُعد تسجيل مثل هذا المعالج اختياريًا تمامًا (EXP ARAComAPI §5.4.8.1 «Registering Getters»). عادةً لا يحتاج تنفيذ الخدمة إلى معالج غيتِر، حيث يقوم Communication Management بتخزين القيمة المحددة مؤخرًا عبر Update() مؤقتًا والرد على طلبات Proxy ذاتيًا. ويكون المعالج مفيدًا خصوصًا إذا كان تحديد قيمة الحقل مستغرقًا للوقت أو متطلبًا لعمليات حسابية مكثفة، وبالتالي ينبغي ألا يتم إلا عند الحاجة الفعلية بشكل غير متزامن عبر نمط Promise/Future.

معالجة الأخطاء والشروط الحدية

ليس للدالة قيمة إرجاع، ومُعلنة بصفتها noexcept وآمنة من الاستثناءات (exception safe) ([SWS_CM_00114]). وإذا كان الكائن القابل للاستدعاء المُمرَّر غير موجود أو بقيمة null، فسيحدث الخطأ InvalidHandlerViolation ([SWS_CM_00114]).

تفاعل

على النقيض من RegisterSetHandler، الذي يُعد استدعاؤه إلزاميًا عند وجود سِتِر (Setter) (EXP ARAComAPI §5.4.8.2 «Registering Setters»)، يظل RegisterGetHandler اختياريًا تمامًا. وإذا كان من المقرر معالجة المعالج في سياق تنفيذ محدد بشكل غير متزامن، تتوفر بالإضافة إلى ذلك دالة القالب ذات التحميل الزائد مع ExecutorT ([SWS_CM_11360]).

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

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

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

Parameter (in)

ParameterBeschreibung
handlerThe callback function to be invoked to process the Field get request

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00114
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00114@rel:R25-11#f95598b7
Content hash
f95598b7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00114
Status: valid/unmigrated Version: rel:R25-11#c6386380 Versionshistorie & Revisions (1 transition, 8 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_00114@rel:R25-11#c6386380
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#417163c72026-09-30
  • R19-11rel:R19-11#f07f56a32026-10-14
  • R20-11rel:R20-11#cdd125c72026-10-14
  • R21-11rel:R21-11#cdd125c72026-10-14
  • R22-11rel:R22-11#6a153b112026-10-14
  • R23-11rel:R23-11#23956e7c2026-10-14
  • R24-11rel:R24-11#5d29d0102026-10-14
  • R25-11rel:R25-11#c63863802026-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

دالة RegisterGetHandler [SWS_CM_11360] Upstream: RS_CM_00211, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void RegisterGetHandler (std::function< ara::core::Future< FieldType >()> handler, ExecutorT &&executor) noexcept;

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

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

الاستخدام

تسجل الطريقة RegisterGetHandler في مساحة الأسماء <SI-Namespace>::skeleton::fields::<Field> استدعاءً رجعيًا من جانب التطبيق (handler)، والذي يتم استدعاؤه بواسطة رابط الاتصال عند ورود استدعاء Get() من وكيل ([SWS_CM_11360]، EXP ARAComAPI §5.4.8.1 «Registering Getters»). بخلاف التحميل الزائد الأساسي بدون معاملات [SWS_CM_00114]، تقبل الطريقة سياق تنفيذ executor من النوع ExecutorT، حيث يتم تنفيذ الاستدعاء الرجعي فيه بشكل غير متزامن ([SWS_CM_11360]). ويمكن استخدام ara::core::Executor المعياري كمنفّذ أو نوع خاص بالمستخدم بنفس الواجهة ([SWS_CM_11360]).

يُعيد المعالج المسجل ara::core::Future<FieldType>، مما يفصل حساب قيمة الحقل عبر نمط Promise/Future ([SWS_CM_11360]، EXP ARAComAPI §5.4.8.1 «Registering Getters»). والتسجيل اختياري تمامًا: ما لم يتم تسجيل أي معالج، تستجيب Communication Management للطلبات بشكل مستقل بآخر قيمة تم تعيينها عبر Update() (EXP ARAComAPI §5.4.8.1 «Registering Getters»). ويُعد معالج الجلب (Getter-Handler) مناسبًا في المقام الأول لتحديد قيم الحقول المكلفة أو التي تستغرق وقتًا طويلاً حسب الحاجة (EXP ARAComAPI §5.4.8.1 «Registering Getters»).

القيود ومعالجة الأخطاء

توجد الطريقة في Skeleton فقط إذا تم تكوين Getter للحقل في IDL (Field.hasGetter == TRUE، [SWS_CM_00114]، EXP ARAComAPI §5.4.8.1 «Registering Getters»). تم التصريح عن RegisterGetHandler بأنها noexcept؛ ومع ذلك، إذا تم تمرير كائن قابل للاستدعاء غير صالح أو فارغ، فإن ذلك يُعد InvalidHandlerViolation ([SWS_CM_11360]). تفسير: يُرجّح أن يتعين بقاء المنفّذ الممرر صالحًا طوال فترة استخدام المعالج بالكامل، حيث يتم توجيه الطلبات الواردة بشكل غير متزامن إلى سياقه. سؤال Q-c58eb22b06a8c27c (مفتوح)

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

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

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

Template-Parameter

ParameterBeschreibung
ExecutorTWrapper type providing methods for asynchronous execution of Callables. AUTOSAR provides a standardized ara::core:: Executor or implementations may use a custom type which provides the same interface.

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00114]
executorThe context in which this method shall be "executed"

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11360
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11360@rel:R25-11#42cafb6f
Content hash
42cafb6f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11360
Status: valid/unmigrated Version: rel:R25-11#bd94b445 Versionshistorie & Revisions (1 transition, 7 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_11360@rel:R25-11#bd94b445
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#9957b1ff2026-09-30
  • R20-11rel:R20-11#437503622026-10-14
  • R21-11rel:R21-11#29c07ecb2026-10-14
  • R22-11rel:R22-11#29c07ecb2026-10-14
  • R23-11rel:R23-11#1e758dfd2026-10-14
  • R24-11rel:R24-11#6f38f9302026-10-14
  • R25-11rel:R25-11#bd94b4452026-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

دالة RegisterSetHandler [SWS_CM_00116] Upstream: RS_CM_00218, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

void RegisterSetHandler (std::function< ara::core::Future< FieldType >(<SFieldDerivedType> value)> handler) noexcept;

Register a callback function to be invoked when a Set() request is received. The method exists only if the offered service contains a Field and Field.hasSetter ==TRUE

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

الاستخدام

تُستخدم الطريقة RegisterSetHandler على جانب الخادم (Skeleton) لتسجيل دالة رد اتصال (Callback) تُستدعى عند وصول طلب Set() من عميل لحقل ما [SWS_CM_00116]. لا توجد الطريقة إلا إذا كان الحقل المقدَّم مهيئًا بدعم أداة التعيين (Setter) (Field.hasSetter == TRUE) [SWS_CM_00116]. وعلى عكس تسجيل Getter، يُعد استدعاء RegisterSetHandler إلزاميًا، نظرًا لأن تنفيذ الخادم يجب أن يتحقق مسبقًا من صحة قيم الحقول الجديدة أو المحدَّثة من العملاء المجهولين EXP ARAComAPI §5.4.8.2 «Registering Setters».

يتلقى المعالج المسجَّل القيمة الجديدة كوسيطة ويُرجع ara::core::Future<FieldType> مع القيمة الفعلية المصححة عند الاقتضاء [SWS_CM_00116]، EXP ARAComAPI §5.4.8.2 «Registering Setters». ويتم تطبيق هذه القيمة الفعلية ضمنيًا بواسطة إدارة الاتصالات ونشرها للعملاء؛ ولذلك فإن الاستدعاء الصريح لـ Update() داخل المعالج يُعد غير ضروري EXP ARAComAPI §5.4.8.2 «Registering Setters».

معالجة الأخطاء والشروط الحدية

تم تعريف الدالة على أنها noexcept وآمنة من الاستثناءات [SWS_CM_00116]. إذا تم تمرير Callable غير موجود أو غير صالح (null)، فإن ذلك يُعد انتهاكًا للمواصفة في صورة InvalidHandlerViolation [SWS_CM_00116]. التفسير: يُرجح أنه يجب أن يتم التسجيل قبل توفير الخدمة عبر OfferService()، وذلك من أجل التمكن من استقبال طلبات العميل الواردة منذ البداية. سؤال Q-d45be0a899ddb6dd (مفتوح)

تفاعل

إلى جانب الدالة الأساسية، يوجد تحميل زائد لقالب [SWS_CM_11362]، يمكن من خلاله ربط تنفيذ المعالج بسياق تنفيذ محدد (ExecutorT وفقًا لـ [SWS_CM_11360]) EXP ARAComAPI.

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

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

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

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00114]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00116
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00116@rel:R25-11#3f25fe04
Content hash
3f25fe04
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00116
Status: valid/unmigrated Version: rel:R25-11#a967ca39 Versionshistorie & Revisions (1 transition, 8 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_00116@rel:R25-11#a967ca39
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#50a50c352026-09-30
  • R19-11rel:R19-11#320f0ae42026-10-14
  • R20-11rel:R20-11#e56d43e62026-10-14
  • R21-11rel:R21-11#e56d43e62026-10-14
  • R22-11rel:R22-11#f8c463c42026-10-14
  • R23-11rel:R23-11#4653d88a2026-10-14
  • R24-11rel:R24-11#eb7262452026-10-14
  • R25-11rel:R25-11#a967ca392026-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

دالة RegisterSetHandler [SWS_CM_11362] Upstream: RS_CM_00211, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void RegisterSetHandler (std::function< ara::core::Future< FieldType >(<SFieldDerivedType> value)> setHandler, ExecutorT &&executor) noexcept;

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

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

تسجّل دالة القالب RegisterSetHandler على مستوى الخادم أو الهيكل (skeleton) لحقل ما دالة رد نداء تُستدعى بمجرد أن يرسل العميل طلب Set() ([SWS_CM_11362]، [SWS_CM_00116]). لا توجد الواجهة إلا إذا كان حقل الخدمة المهيأ ينص على دعم المحدِّد (setter) (Field.hasSetter == TRUE) ([SWS_CM_00116]). بخلاف تسجيل Get، فإن تسجيل معالج Set إلزامي، نظرًا لأن تنفيذ الخادم يجب أن يتحقق دائمًا من صحة قيم الحقول الجديدة للعملاء المجهولين (EXP ARAComAPI §5.4.8.2 «Registering Setters»).

بالمقارنة مع التسجيل القياسي وفقًا لـ [SWS_CM_00116]، يقبل هذا التحميل الزائد بالإضافة إلى ذلك سياق تنفيذ executor من النوع ExecutorT&& ([SWS_CM_11362]، [SWS_CM_11360]). تفسير: يُرجّح أن يتحكم executor في سياق خيط المعالجة أو مجدول المهام الذي يتم فيه تنفيذ رد النداء. سؤال Q-6dec4c0005c388dd (مفتوح) يمتلك المعالج الممرَّر التوقيع std::function<ara::core::Future<FieldType>(<SFieldDerivedType> value)>؛ حيث يستقبل القيمة المحددة من قِبل العميل ويعيد بشكل غير متزامن عبر ara::core::Future القيمة الفعلية – التي قد تكون مصحوبة بالتحقق من الصحة أو التصحيح ([SWS_CM_11362]، EXP ARAComAPI §5.4.8.2 «Registering Setters»).

تعتمد Communication Management القيمة الفعلية التي يعيدها المعالج ضمنيًا كما لو كان تطبيق الخادم نفسه قد استدعى Update()؛ وبالتالي، فإن الاستدعاء اليدوي لـ Update() داخل المعالج يُعد أمرًا غير ضروري (EXP ARAComAPI §5.4.8.2 «Registering Setters»، EXP ARAComAPI §4.6 «Data Type Abstractions»).

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

  • الأمان من الاستثناءات: تم إعلان الدالة كـ noexcept وتم تحديدها على أنها آمنة من الاستثناءات (exception safe) ([SWS_CM_11362]).
  • الانتهاكات: إذا كان الكائن القابل للاستدعاء المُمرَّر setHandler غير موجود أو كان nullptr، فسيحدث الانتهاك InvalidHandlerViolation ([SWS_CM_11362]).
  • السياق: تضمن الطريقة تنفيذ المعالج في السياق المُوفَّر لـ executor ([SWS_CM_11362]).

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

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

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h"
Scopeclass <SI-Namespace>::skeleton:: fields::<Field>
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
setHandlerAs per [SWS_CM_00116]
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_11362
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11362@rel:R25-11#6ef24536
Content hash
6ef24536
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11362
Status: valid/unmigrated Version: rel:R25-11#012add4b Versionshistorie & Revisions (1 transition, 7 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_11362@rel:R25-11#012add4b
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#6e268d732026-09-30
  • R20-11rel:R20-11#a1cce0c32026-10-14
  • R21-11rel:R21-11#46e987b82026-10-14
  • R22-11rel:R22-11#46e987b82026-10-14
  • R23-11rel:R23-11#cdcd5ed72026-10-14
  • R24-11rel:R24-11#d4ed3d212026-10-14
  • R25-11rel:R25-11#012add4b2026-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_00096] Upstream: RS_CM_00224, RS_E2E_08534

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

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Skeleton Field Get/Set.

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

تُستخدم الدالة SetTransportFaultConditionHandler لتسجيل معالج أخطاء من النوع ara::com::e2e::TransportFaultConditionHandler لطلبات Get وSet لحقل على مستوى الهيكل البرمجي (Skeleton) في نطاق الأسماء <SI-Namespace>::skeleton::fields::<Field> [SWS_CM_00096]. يتم تنفيذ الاستدعاء بشكل متزامن، ولا يمتلك قيمة إرجاع (void)، ويضمن أمان الاستثناءات من خلال تحديده كـ noexcept [SWS_CM_00096]. وبالنسبة للسيناريوهات التي يجب فيها تفويض تنفيذ المعالج إلى سياق تنفيذ صريح، يتوفر التحميل الزائد للقالب مع كائن المنفذ (Executor) ExecutorT&& executor [SWS_CM_00097].

تم تحديد الانتهاك InvalidHandlerViolation كشرط خطأ؛ ويحدث عندما يكون الكائن القابل للاستدعاء (Callable) المُمرَّر handler غير موجود أو صفراً (null) [SWS_CM_00096]. وبينما يتم الإبلاغ من جانب العميل عن الأخطاء في طلبات الدوال والحقول عبر ComErrc::kCommunicationFailure في مثيلات ara::core::Future المعنية [SWS_CM_00090]، تتيح هذه الدالة لمثيل الخادم استقبال أخطاء النقل عند استدعاءات Get وSet الواردة [SWS_CM_00096].

يتوافق المفهوم مع آليات التسجيل المقابلة لجميع دوال مثيل خدمة الهيكل البرمجي [SWS_CM_00093] وكذلك المعالجات من جانب الوكيل (Proxy) للأحداث [SWS_CM_00099] والمشغلات (Triggers) [SWS_CM_00106] ومُخطِرات الحقول [SWS_CM_00109]. تفسير: من المنطقي أن يتم تسجيل المعالج أثناء مرحلة التهيئة قبل توفير الهيكل البرمجي، وذلك لتسجيل الأخطاء عند الوصول الأولي للحقول بسلاسة. سؤال Q-627229896b666532 (مفتوح)

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

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

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

Parameter (in)

ParameterBeschreibung
handlerHandler of type ara::com::e2e:: 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_00096
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00096@rel:R25-11#8aa5a327
Content hash
8aa5a327
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00096
Status: valid/unmigrated Version: rel:R25-11#3e34141f 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_00096@rel:R25-11#3e34141f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#37a0a6942026-09-30
  • R24-11rel:R24-11#b910a6fe2026-10-14
  • R25-11rel:R25-11#3e34141f2026-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_00097] 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 hierarchicalnamespacelistlowerskeleton:: skeleton::fields::fieldname::SetTransportFaultConditionHandler for a given Skeleton Field Get/Set.

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

تسجل الدالة SetTransportFaultConditionHandler في مساحة الاسم <SI-Namespace>::skeleton::fields::<Field> معالج أخطاء لاضطرابات النقل لطلبات Get وSet لحقل على مستوى Skeleton [SWS_CM_00097]. ويتم تضمينها عبر ملف الترويسة <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h [SWS_CM_00097].

الاستخدام والمعلمات

يتم الاستدعاء بشكل متزامن وليس له قيمة إرجاع (void) [SWS_CM_00097]. وكـمعلمات، يتم تمرير رد اتصال الخطأ القابل للاستدعاء handler من النوع ara::com::e2e::TransportFaultConditionHandler وكذلك مرجع إعادة التوجيه executor من النوع العام ExecutorT&& [SWS_CM_00097]. وتشير المعلمة executor إلى كائن التنفيذ الذي يتم تنفيذ أي حسابات غير متزامنة في سياقه [SWS_CM_00097].

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

تم التصريح عن الطريقة كـ noexcept وهي تضمن أمانًا كاملاً من الاستثناءات (exception safe) [SWS_CM_00097]. وإذا كان الكائن القابل للاستدعاء handler الممرر غير موجود أو كان null، فسيتم إطلاق InvalidHandlerViolation [SWS_CM_00097]. تفسير: يُفترض أن كائن executor الممرر يحدد في أي سياق خيط أو مهمة تتم معالجة الإشعار غير المتزامن عند حدوث أخطاء النقل. سؤال Q-4101faaa8d6a3130 (مفتوح)

تفاعل

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

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

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

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

Parameter (in)

ParameterBeschreibung
handlerHandler of type ara::com::e2e:: TransportFaultConditionHandler to be set
executorExecutor object in which any asynchronous computation spawn shall be invoked

Rückgabewert

TypBeschreibung
None
Siehe auch: [SWS_CM_00096]

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

Record
AUTOSAR/AP/record/SWS_CM_00097
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00097@rel:R25-11#92b58238
Content hash
92b58238
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00097
Status: valid/unmigrated Version: rel:R25-11#43b66b1f 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_00097@rel:R25-11#43b66b1f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#225cecf82026-09-30
  • R24-11rel:R24-11#ee2004b32026-10-14
  • R25-11rel:R25-11#43b66b1f2026-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

دالة UnsetTransportFaultConditionHandler [SWS_CM_00098] 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 Skeleton Field Get/Set.

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

تُستخدم الدالة UnsetTransportFaultConditionHandler على جانب Skeleton لواجهة الخدمة لإلغاء ara::com::e2e::TransportFaultConditionHandler مسجَّل مسبقًا لطلبات Get وSet الخاصة بحقل ما ([SWS_CM_00098]). وهي معرَّفة في نطاق الأسماء <SI-Namespace>::skeleton::fields::<Field> ومضمَّنة عبر ملف الترويسة <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h (AUTOSAR_AP_SWS_CommunicationManagement §8.4.3.2.1.3 «UnsetTransportFaultConditionHandler»). ويتم الاستدعاء بشكل متزامن، ولا يقبل معلمات تمرير ولا يُرجع أي قيمة (void).

من خلال الإلغاء، يتم إلغاء تنشيط رد الاتصال (Callback) الخاص بالتطبيق لحالات أخطاء النقل في طلبات الحقول (AUTOSAR_AP_SWS_CommunicationManagement §7.4.1 «End-to-end communication protection for SOMEIP»). الواجهة مصرَّح عنها كـ noexcept وتضمن أمان الاستثناءات (exception safe) ([SWS_CM_00098]). ولا توجد رموز أخطاء أو رسائل أخطاء محددة عبر DET أو DEM في المواصفة؛ وقد صُمِّم الإجراء ليكتمل بنجاح دون أخطاء.

فيما يخص التزامن وقابلية إعادة الدخول، لا تتضمن المواصفة متطلبات خاصة. وبناءً على ذلك، يُرجَّح أن يتم إلغاء التسجيل ويفضَّل ذلك أثناء مراحل إلغاء التهيئة أو خارج معالجات Get/Set المتزامنة، لتجنب حالات عدم الاتساق أثناء عمليات الاتصال الجارية. سؤال Q-06bc8d90f1891904 (مفتوح)

العملية جزء من تأمين اتصال End-to-End لمثيلات الخدمة (AUTOSAR_AP_SWS_CommunicationManagement §7.4.1 «End-to-end communication protection for SOMEIP»). وهي تمثل النظير الخاص بالحقول لـ [SWS_CM_00095]، الذي يلغي تسجيل المعالج لجميع طرق Skeleton. وعلى جانب Proxy، تقابلها عمليات إلغاء تسجيل مطابقة للأحداث ([SWS_CM_00105])، والمشغلات ([SWS_CM_00108])، ومنبهات الحقول ([SWS_CM_00126]).

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

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

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h"
Scopeclass <SI-Namespace>::skeleton:: fields::<Field>
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_00098
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00098@rel:R25-11#bdbb7201
Content hash
bdbb7201
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00098
Status: valid/unmigrated Version: rel:R25-11#0a13a3e7 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_00098@rel:R25-11#0a13a3e7
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#567e08112026-09-30
  • R24-11rel:R24-11#8140569f2026-10-14
  • R25-11rel:R25-11#0a13a3e72026-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

دالة Update [SWS_CM_00119] Upstream: RS_CM_00218, RS_AP_00114, RS_AP_00120, RS_AP_00121

ara::core::Result< void > Update (<SFieldDerivedType> value) noexcept;

Initiate the transmission of updated field data to the subscribers. See [SWS_CM_00162] for the required behavior. The Update function shall also update the fields internal value. An update notification shall be sent to any subscribers if: • Field.hasNotifier ==TRUE (according to [SWS_CM_00120])

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

تُستدعى الدالة Update() من جهة الخادم في النطاق <SI-Namespace>::skeleton::fields::<Field> لتحديث القيمة الداخلية لحقل ما وبدء إرسال البيانات الجديدة إلى العملاء المشتركين ([SWS_CM_00119]، AUTOSAR_AP_EXP_ARAComAPI §4.6 «Data Type Abstractions»). ويتم إرسال إشعار إلى المشتركين إذا تم تكوين hasNotifier == TRUE للحقل ([SWS_CM_00119]، [SWS_CM_00120]، [SWS_CM_00162]). وتُمرَّر المعلمة value عبر مرجع؛ حيث ينشئ تنفيذ الربط نسخة متسلسلة عادةً أثناء الاستدعاء، بحيث يمكن تعديل بيانات التطبيق أو تحريرها من جانب جهة الاستدعاء بعد العودة (AUTOSAR_EXP_ARAComAPI «UpdateRate Class»).

تم تعريف الدالة بصفتها noexcept وكذلك exception safe، وتُرجع ara::core::Result<void> بشكل متزامن ([SWS_CM_00119]). وفي حال حدوث خطأ، تحتوي النتيجة على رمز خطأ من ara::com::ComErrc ([SWS_CM_00119]، [SWS_CM_10432]). وتحديدًا، يتم إرجاع ComErrc::kMinimumSendIntervalViolationError مع دلالات التراجع (Rollback)، إذا تمت طلبات الإرسال بشكل أسرع مما يحدده الحد الأدنى لفاصل الإرسال المُكوَّن ServiceInterfaceDeploymentElement.minimumSendInterval ([SWS_CM_00119]).

في دورة حياة الخدمة، يلزم استدعاء أولي لـ Update() قبل تقديم الخدمة: إذا تم استدعاء OfferService() قبل تهيئة قيمة الحقل، فسيفشل التقديم مع ComErrc::kFieldValueNotInitialized ([SWS_CM_00101]، [SWS_CM_00128]). ونظرًا لعدم وجود ضمان صريح لإعادة الدخول (Reentrancy) في المعيار القياسي، يُرجَّح أنه يجب مزامنة الاستدعاءات المتزامنة على نفس مثيل الحقل من جانب التطبيق. سؤال Q-67b174ef05867989 (مفتوح)

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

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

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h"
Scopeclass <SI-Namespace>::skeleton:: fields::<Field>
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
valueThe value to be sent to subscribers

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComErrc::kMinimumSendIntervalViolationErrorrollback_semantics Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.

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

Record
AUTOSAR/AP/record/SWS_CM_00119
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00119@rel:R25-11#21e1bd5d
Content hash
21e1bd5d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00119
Status: valid/unmigrated Version: rel:R25-11#f2b83ddc Versionshistorie & Revisions (1 transition, 8 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_00119@rel:R25-11#f2b83ddc
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#de7aa84f2026-09-30
  • R19-11rel:R19-11#e64af9a12026-10-14
  • R20-11rel:R20-11#e8f21c102026-10-14
  • R21-11rel:R21-11#0afac5612026-10-14
  • R22-11rel:R22-11#3e7a86112026-10-14
  • R23-11rel:R23-11#daabe32d2026-10-14
  • R24-11rel:R24-11#c1e2db482026-10-14
  • R25-11rel:R25-11#f2b83ddc2026-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

توثيق أسماء الأنواع البديلة

اسم نوع بديل FieldType [SWS_CM_11402] Upstream: RS_CM_00219, RS_AP_00114

using FieldType = <SFieldCppidt>;

Data type for the value of a field (an alias for the CppImplementationDataType of the Field, i.e. for the CppImplementationDataType which is either referenced by the VariableDataPrototype in the role type directly or via indirection of a DataTypeMap)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h"
Scopeclass <SI-Namespace>::skeleton:: fields::<Field>
SymbolFieldType

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

Record
AUTOSAR/AP/record/SWS_CM_11402
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11402@rel:R25-11#e0e01a6c
Content hash
e0e01a6c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11402
Status: valid/unmigrated Version: rel:R25-11#11e46b26 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_11402@rel:R25-11#11e46b26
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#ab2582db2026-09-30
  • R22-11rel:R22-11#fd04825a2026-10-14
  • R23-11rel:R23-11#fd04825a2026-10-14
  • R24-11rel:R24-11#f639aee72026-10-14
  • R25-11rel:R25-11#11e46b262026-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