نطاق أسماء ara::com::runtime

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

يحل محددات المثيلات المجردة في وقت التشغيل إلى معرفات ملموسة لاتصالات الخدمة.

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يحل محددات المثيلات المجردة في وقت التشغيل إلى معرفات ملموسة لاتصالات الخدمة.

يوفر نطاق الأسماء ara::com::runtime خدمات وقت تشغيل مركزية لحل نقاط النهاية للاتصال في إدارة الاتصال AUTOSAR_AP_SWS_CommunicationManagement ص. 39. تقوم وظيفته الأساسية ResolveInstanceIDs بترجمة معرفات النماذج التجريدية من النوع ara::core::InstanceSpecifier إلى ara::com::InstanceIdentifierContainer فعلية وقابلة للاستخدام لـ Proxies وSkeletons [SWS_CM_00118]. إذا فشل تعيين معرّف صالح شكليًا في التوزيع (Deployment)، فإن الوظيفة الآمنة من الاستثناءات تُرجع رمز الخطأ ComErrc::kInstanceIDNotResolvable داخل ara::core::Result. لذلك، يجب على المتصلين تقييم كائن النتيجة (Result) قبل إنشاء مثيل للخدمة.

السياق

يوفر نطاق الأسماء ara::com::runtime وظائف وقت تشغيل مركزية لإدارة الاتصال (ara::com) في AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_CommunicationManagement ص. 39. وتتمثل مسؤوليته الوظيفية الأساسية في فصل بنية البرمجيات التجريدية عن البنية التحتية الفعلية للاتصال في وقت التشغيل. بينما ترتبط التطبيقات ومكونات البرمجيات بالمنافذ في واجهاتها عبر معرفات نماذج تجريدية (ara::core::InstanceSpecifier)، تتطلب البرمجيات الوسيطة للاتصال بيانات عنونة وإنشاء مثيلات فعلية في شكل كائنات ara::com::InstanceIdentifier لإنشاء الاتصالات [SWS_CM_00118].

تشكل الدالة ResolveInstanceIDs المصرح عنها في ملف الترويسة ara/com/runtime.h الجسر بين هذين المستويين من التجريد [SWS_CM_00118]. فهي تستقبل ara::core::InstanceSpecifier وتحوله إلى ara::com::InstanceIdentifierContainer AUTOSAR_AP_SWS_CommunicationManagement ص. 40. تفسير: من المرجح أن يعتمد التعيين الفعلي داخليًا على تكوينات البيان (Manifest) والتوزيع المخزنة في سياق التنفيذ، مما يحافظ على كود التطبيق قابلاً للنقل وخاليًا من عناوين الشبكة أو البروتوكول المبرمجة بشكل ثابت. سؤال Q-8fab6de1c39a065a (مفتوح)

مخطط السياق: تصنيف ara::com::runtime بين بنية التطبيق وتوزيع الاتصال. المصادر: [SWS_CM_00118]، AUTOSAR_AP_SWS_CommunicationManagement ص. 39.

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

يتم الاستخدام النموذجي لنطاق الأسماء ara::com::runtime أثناء مرحلة التهيئة والبدء لتطبيق متكيف، قبل إنشاء علاقات الاتصال عبر Service-Proxies أو Service-Skeletons AUTOSAR_AP_SWS_CommunicationManagement ص. 41. ويمر مستهلك الخدمة (Service Consumer) أو مزودها (Service Provider) بمسار حل حتمي:

تحديد المحدد: يُنشئ التطبيق مثيلاً للمعرّف المحدد لمنفذ الاتصال المعني أو يشير إليه من النوع ara::core::InstanceSpecifier.
حل المثيلات: يتم تمرير المعرّف إلى الدالة ara::com::runtime::ResolveInstanceIDs [SWS_CM_00118].
التحقق من النتيجة: يُرجع الاستدعاء كائنًا من النوع ara::core::Result<ara::com::InstanceIdentifierContainer>، ويتم فحصه للتأكد من التنفيذ الناجح أو حالات الخطأ [SWS_CM_00118].
معالجة الحاوية: عند النجاح، يحتوي ara::com::InstanceIdentifierContainer على عدد من معرفات المثيلات يتناسب مع عدد التطابقات الموجودة في التوزيع [SWS_CM_00118]. يمكن للتطبيق تحديد مثيل بعينه أو التكرار عبر جميع المثيلات المتاحة.
إنشاء مثيل Proxy أو Skeleton: تُستخدم كائنات ara::com::InstanceIdentifier المحلولة بعد ذلك لإنشاء مثيلات Proxy أو Skeleton فعلية AUTOSAR_AP_SWS_CommunicationManagement ص. 42.

مخطط التسلسل: تسلسل الاستدعاء والمعالجة لحل المثيلات عبر ResolveInstanceIDs. المصادر: [SWS_CM_00118]، AUTOSAR_AP_SWS_CommunicationManagement ص. 41.

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

تتبع الواجهات في نطاق الأسماء ara::com::runtime النموذج المعتمد على مستوى المنصة للمعالجة القوية للخطأ والخالية من الاستثناءات. وفقًا للمواصفة، تم التصريح عن ResolveInstanceIDs كـ noexcept وتمتلك مستوى أمان الاستثناء exception safe [SWS_CM_00118]. وبالتالي، لا يتم الإشارة إلى الأخطاء أبدًا عبر استثناءات C++‎، بل تُنقل بالكامل عبر موناد الخطأ ara::core::Result AUTOSAR_AP_SWS_CommunicationManagement ص. 47.

يتعلق سيناريو الخطأ المركزي المحدد برمز الخطأ ComErrc::kInstanceIDNotResolvable [SWS_CM_00118]. يحدث هذا الخطأ عندما يكون ara::core::InstanceSpecifier الممرر صالحًا شكليًا، ولكن لا يمكن تعيينه لأي ara::com::InstanceIdentifier موجود في تكوين النظام الحالي أو في البيان [SWS_CM_00118]. يشير هذا عمليًا إلى وجود تعارضات بين النمذجة والتوزيع، مثل عدم توزيع مزود الخدمة على جهاز آخر أو غياب الربط (Binding) في البيان. ينطبق على هذا الخطأ دلالات التراجع (rollback_semantics): لا يتم إنشاء حالات جزئية أو حجز موارد، مما يمكّن المتصل من التحقق من التكوين أو الانتقال إلى حالة خطأ محددة [SWS_CM_00118].

يستند هذا الدليل إلى مواصفات الإصدار R25-11 من AUTOSAR Adaptive Platform.

لا توجد بيانات عناصر لهذا الإصدار

الدوال

ResolveInstanceIDs دالة

Translates an ara::core::InstanceSpecifier to a ara::com:: InstanceIdentifierContainer. The length/size of the ara::com:: InstanceIdentifierContainer is relative to the number of matches.

ara::core::Result< ara::com::InstanceIdentifierContainer > Resolve InstanceIDs (ara::core::InstanceSpecifier metaModelIdentifier) noexcept;

توثيق الدوال الحرة

دالة ResolveInstanceIDs [SWS_CM_00118] Upstream: RS_CM_00200, RS_AP_00114, RS_AP_00115, RS_AP_00120, RS_AP_00121, RS_AP_00119, RS_AP_00127, RS_AP_00137

ara::core::Result< ara::com::InstanceIdentifierContainer > Resolve InstanceIDs (ara::core::InstanceSpecifier metaModelIdentifier) noexcept;

Translates an ara::core::InstanceSpecifier to a ara::com:: InstanceIdentifierContainer. The length/size of the ara::com:: InstanceIdentifierContainer is relative to the number of matches.

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تحلل الدالة المتزامنة ResolveInstanceIDs في مساحة الأسماء ara::com::runtime ([SWS_CM_00118]) معرفًا مستندًا إلى النموذج من النوع ara::core::InstanceSpecifier إلى مثيلات تقنية ملموسة. وكنتيجة، تُرجع ara::core::Result<ara::com::InstanceIdentifierContainer> يحتوي على الـ ara::com::InstanceIdentifier المخصصة (EXP ARAComAPI §4 «InstanceSpecifier Resolution»).

تمثل الحاوية في هذه الحالة النشر (deployment) المكوّن:

يمثل العنصر الفردي الحالة القياسية للربط التقني الفريد.
تظهر عناصر متعددة عندما يقوم المكامل (integrator) بتكوين ربط متعدد (Multi-Binding)، على سبيل المثال لروابط بديلة على جانب الخادم أو مفاهيم تجاوز الفشل (fail-over) على جانب العميل (EXP ARAComAPI §4 «InstanceSpecifier Resolution»).
تشير الحاوية الفارغة إلى تعيين مفقود، وبالتالي إلى خطأ في التكوين من جانب المكامل (EXP ARAComAPI §4 «InstanceSpecifier Resolution»).

في حالة الخطأ، يُرجع ara::core::Result رمز الخطأ ComErrc::kInstanceIDNotResolvable إذا كان InstanceSpecifier صالحًا شكليًا، ولكن لم يمكن ربطه بأي InstanceIdentifier موجود ([SWS_CM_00118]). الدالة معلنة كـ noexcept وآمنة من الاستثناءات.

في سيناريوهات التطبيق النموذجية، لا يكون الاستدعاء المباشر ضروريًا، لأن واجهات برمجة تطبيقات الوكيل والهيكل توفر تحميلات زائدة تقبل InstanceSpecifier مباشرةً (EXP ARAComAPI §4 «InstanceSpecifier Resolution»). يُستخدم التحليل اليدوي بشكل أساسي في السيناريوهات المتقدمة التي يتم فيها تبادل InstanceIdentifier الخاصة بالتقنية عبر العمليات أو تحديد الروابط بشكل مستهدف (EXP ARAComAPI §4 «InstanceSpecifier Resolution»).

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

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

Header-Datei	#include "ara/com/runtime.h"
Scope	namespace ara::com::runtime
Exception-Sicherheit	exception safe

Parameter (in)

Parameter	Beschreibung
metaModelIdentifier	The ara::core::InstanceSpecifier to be translated.

Rückgabewert

Typ	Beschreibung
ara::core::Result<ara::com::InstanceIdentifierContainer >	An ara::com::InstanceIdentifierContainer if successful, otherwise an error code indicating the error

Fehler

Fehlercode	Beschreibung
ComErrc::kInstanceIDNotResolvable	rollback_semantics The ara::core::InstanceSpecifier is valid but could not be resolved/mapped to an existing ara::com:: InstanceIdentifier

Siehe auch: [SWS_CORE_08001]

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

Record: AUTOSAR/AP/record/SWS_CM_00118
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00118@rel:R25-11#f42671e7
Content hash: f42671e7
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00118

Status: valid/unmigrated Version: rel:R25-11#7fda17bf 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_00118@rel:R25-11#7fda17bf

Recorded Revisions (8):

R25-11rel:R25-11#0f70035f2026-09-30
R19-11rel:R19-11#f7400f912026-10-14
R20-11rel:R20-11#41c24bfc2026-10-14
R21-11rel:R21-11#29fd954c2026-10-14
R22-11rel:R22-11#e6a302622026-10-14
R23-11rel:R23-11#2a18d23a2026-10-14
R24-11rel:R24-11#09c394e82026-10-14
R25-11rel:R25-11#7fda17bf2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill