Unique identifier of a specific AdaptivePlatformServiceInstance, to distinguish different instances of exactly the same service. ara::com::InstanceIdentifier satisfies the [equalitycomparable], [lessthancomparable] and [copyassignable] requirements as per [30] to allow for logging of ara::com::InstanceIdentifiers as well as storing and managing ara::com::InstanceIdentifiers by the application (see operators). ara:: com::InstanceIdentifier does not contain a fully qualified name, which would also have service type information.
Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org
تُستخدم للتعريف الفريد لمثيل الخدمة التقني لتمييز الخدمات المتماثلة.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 1921f270f529المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم للتعريف الفريد لمثيل الخدمة التقني لتمييز الخدمات المتماثلة.
تُستخدم الفئة ara::com::InstanceIdentifier للتعريف الفريد لمثيل خدمة محدد على Adaptive Platform (AdaptivePlatformServiceInstance)، لتمييز مثيلات مختلفة لنفس الخدمة تمامًا عن بعضها البعض. وتغلف العنونة الخاصة بالتقنية لربط الاتصال المختار، ولكنها لا تحتوي عمدًا على اسم مؤهل بالكامل مع معلومات نوع الخدمة. بالنسبة لمطور البرمجيات العادي، يكون التفاعل المباشر مع ara::com::InstanceIdentifier مجردًا في العادة: فبينما تُستخدم في نموذج مكونات البرمجيات أسماء منطقية في المقام الأول عبر ara::core::InstanceSpecifier (AUTOSAR_AP_EXP_ARAComAPI ص. 23 §4.2 «InstanceSpecifier class»)، يقوم مسؤول التكامل بربطها عبر ملفات البيان بروابط الاتصال التقنية ومعرفات المثيلات الخاصة بها (AUTOSAR_AP_EXP_ARAComAPI ص. 23 §4.2 «InstanceSpecifier class»).
تتمتع مثيلات ara::com::InstanceIdentifier بدلالات قيمة كاملة. وهي تستوفي متطلبات equalitycomparable وlessthancomparable وكذلك copyassignable وفقًا لـ ISO/IEC 14882:2014، مما يسمح بإدارتها وفرزها وتسجيلها في الحاويات القياسية. توفر الفئة المنشئات ودوال دورة الحياة التالية:
إنشاء خالٍ من الاستثناءات عبر طريقة المصنع الثابتة Create ([SWS_CM_11520]) مع noexcept.
منشئ صريح يستند إلى تمثيل نصي ([SWS_CM_11521])، وهو غير آمن من حيث الاستثناءات (not exception safe) بشكل صريح.
نظرًا لأن ara::com يقدم تحميلات زائدة للطرق الشائعة تقبل مباشرةً ara::core::InstanceSpecifier، فإن المعالجة اليدوية لـ ara::com::InstanceIdentifier موجهة أساسًا لحالات الاستخدام المتقدمة مثل الروابط المتخصصة أو تجاوز الفشل المستهدف (AUTOSAR_AP_EXP_ARAComAPI ص. 25 «InstanceIdentifier Usage»). ينقسم التسلسل النموذجي إلى الخطوات التالية:
عند التعامل مع ara::com::InstanceIdentifier، يجب مراعاة حالتي خطأ على وجه الخصوص:
تنسيق سلسلة نصية غير صالح (InvalidInstanceIdentifierStringViolation): إذا تم تمرير معرف مسلْسَل تالف أو غير متوافق أو مكرر إلى Create ([SWS_CM_11520]) أو إلى المنشئ ([SWS_CM_11521])، فإن هذا الانتهاك يحدث. تفسير: بينما يُتوقع أن تُبلغ طريقة المصنع الخالية من الاستثناءات Create عن ذلك عبر كائن خطأ، يُرجح أن يُطلق المنشئ غير الآمن من حيث الاستثناءات استثناءً في حالة حدوث خطأ. سؤال Q-45a6fdd0859218bd (مفتوح)
غياب مثيل الخدمة: إذا لم يتم تنفيذ OfferService() المطابق على جانب Skeleton للمعرف المحدد، فإن ServiceHandleContainer المُرجع من FindService يظل فارغًا (ARAComAPI ص. 103 «Figure 6.5: Service Discovery»).
يستند دليل الفئات هذا إلى مواصفات وتوضيحات إصدار AUTOSAR Adaptive Platform R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b4194687c159المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تمثل الدالة الثابتة ara::com::InstanceIdentifier::Create ([SWS_CM_11520]) طريقة مصنع خالية من الاستثناءات لإنشاء نسخة من InstanceIdentifier. تستقبل كسلسلة إدخال متزامنة نصاً من النوع ara::core::StringView (serializedFormat) وتُرجع نسخة من InstanceIdentifier ([SWS_CM_11520]). التنسيق المحدد للسلسلة النصية المتسلسلة ليس قياسياً، بل تحدده الشركة المصنعة من خلال برنامج تشغيل إدارة الاتصالات المعني ([SWS_CM_00088]، AUTOSAR_AP_SWS_CommunicationManagement §7.5.22.1 «Service Identifier Data Types»).
معالجة الأخطاء
تم تحديد الدالة كـ noexcept وآمنة من الاستثناءات ([SWS_CM_11520]). إذا كانت السلسلة النصية الممررة تالفة، أو غير متوافقة، أو مكررة في النظام، فإن المواصفة تحدد الانتهاك InvalidInstanceIdentifierStringViolation ([SWS_CM_11520]). ونظراً لأن التوقيع لا يُرجع نوع خطأ مثل ara::core::Result، فمن المفترض أنه يتم اعتراض الانتهاك على الأرجح عبر معالجة الأخطاء الداخلية للمنصة أو الإنهاء (تفسير). سؤال Q-17a699ea15610637 (مفتوح)
التزامن والقيود
يُستخدم ara::com::InstanceIdentifier للتعريف الفريد والتمييز بين نُسخ مختلفة من نوع الخدمة نفسه في النظام ([SWS_CM_00302]). يجب على المتصل التأكد من أن السلسلة النصية المقدمة تمثل نسخة صالحة وفريدة على مستوى النظام، حيث تُعتبر التكرارات صراحة انتهاكاً ([SWS_CM_11520]).
تفاعل
يتوافق معرف النسخة المنشأ مع التابع ToString() ([SWS_CM_11522])، والذي يمكن من خلاله قراءة تمثيل السلسلة النصية مرة أخرى ([SWS_CM_00088]). بالإضافة إلى ذلك، يُستخدم الكائن لمخاطبة نُسخ خدمة محددة في النظام بأكمله ([SWS_CM_00302]).
تم توليد ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي وتستند حصراً إلى إصدار المواصفة R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: fb75f02e4eb4المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تم التصريح عن الدالة في الترويسة #include "ara/com/service/instance_identifier.h" وتُستدعى بشكل متزامن وبدون معلمات على كائن ثابت ([SWS_CM_11522]):
قيمة الإرجاع: يُرجع التابع التمثيل النصي لمعرف النسخة كـ ara::core::StringView ([SWS_CM_11522]).
التنسيق: تنسيق السلسلة النصية المُرجعة تم تطبيقه بشكل خاص بالشركة المصنعة لمزود Communication Management المعني وليس قياسياً ([SWS_CM_00088]). ويُتوقع التنسيق نفسه أيضاً من المنشئ (constructor) المعتمد على السلسلة النصية ([SWS_CM_11520]، [SWS_CM_00088]).
معالجة الأخطاء والتزامن
تم تعريف التابع كـ noexcept ويضمن بذلك أماناً كاملاً من الاستثناءات (exception safe) ([SWS_CM_11522]). لا يتم إطلاق أي استثناءات ولا إرجاع أي رموز أخطاء. ونظراً لأن نوع الإرجاع ara::core::StringView لا يمتلك ملكية الذاكرة المشار إليها، فمن المفترض على الأرجح أن تكون صلاحية البيانات مرتبطة بدورة حياة كائن InstanceIdentifier. سؤال Q-51f5f18a79ebf3a4 (مفتوح)
تفاعل
على عكس ara::com::ServiceIdentifierType::toString، المحددة بأنها not exception safe ([SWS_CM_11514])، يضمن InstanceIdentifier::toString الخلو الصارم من الاستثناءات والأخطاء ([SWS_CM_11522]).
تم توليد ملاحظة الاستخدام هذه تلقائياً. جميع البيانات موثقة بالمواصفة أو مصنفة صراحة كافتراض.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني