namespace ara::com::runtime

Der Namespace ara::com::runtime stellt zentrale Laufzeitdienste zur Auflösung von Kommunikationsendpunkten im Kommunikationsmanagement bereit AUTOSAR_AP_SWS_CommunicationManagement S. 39. Seine Kernfunktion ResolveInstanceIDs übersetzt abstrakte Modellbezeichner vom Typ ara::core::InstanceSpecifier in konkrete, für Proxies und Skeletons nutzbare ara::com::InstanceIdentifierContainer [SWS_CM_00118]. Schlägt die Zuordnung eines formal gültigen Bezeichners im Deployment fehl, liefert die ausnahmesichere Funktion den Fehlercode ComErrc::kInstanceIDNotResolvable innerhalb eines ara::core::Result zurück. Aufrufer müssen daher das Result-Objekt vor der Dienstinstanziierung auswerten.

mehr ›

Kontext

Der Namespace ara::com::runtime stellt zentrale Laufzeitfunktionalitäten für das Kommunikationsmanagement (ara::com) der AUTOSAR Adaptive Platform bereit AUTOSAR_AP_SWS_CommunicationManagement S. 39. Seine primäre funktionale Verantwortung besteht in der Entkopplung der abstrakten Software-Architektur von der konkreten Kommunikationsinfrastruktur zur Laufzeit. Während Applikationen und Softwarekomponenten in ihren Schnittstellen über abstrakte Modellbezeichner (ara::core::InstanceSpecifier) an Ports gebunden sind, benötigt die Kommunikations-Middleware für den Aufbau von Verbindungen konkrete Adressierungs- und Instanzierungsdaten in Form von ara::com::InstanceIdentifier-Objekten [SWS_CM_00118].

Die im Header ara/com/runtime.h deklarierte Funktion ResolveInstanceIDs bildet die Brücke zwischen diesen beiden Abstraktionsebenen [SWS_CM_00118]. Sie nimmt einen ara::core::InstanceSpecifier entgegen und transformiert ihn in einen ara::com::InstanceIdentifierContainer AUTOSAR_AP_SWS_CommunicationManagement S. 40. Interpretation: Die konkrete Zuordnung dürfte intern auf den im Ausführungskontext hinterlegten Manifest- und Deployment-Konfigurationen basieren, wodurch Anwendungscode portabel und frei von fest verdrahteten Netzwerk- oder Protokolladressen bleibt. Frage Q-8fab6de1c39a065a (offen)

Kontextdiagramm: Einordnung von ara::com::runtime zwischen Anwendungsarchitektur und Kommunikations-Deployment. Quellen: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement S. 39.

Nutzungspfad

Der typische Einsatz des Namespace ara::com::runtime erfolgt während der Initialisierungs- und Startphase einer adaptiven Anwendung, bevor Kommunikationsbeziehungen über Service-Proxies oder Service-Skeletons etabliert werden AUTOSAR_AP_SWS_CommunicationManagement S. 41. Ein Service Consumer oder Provider durchläuft dabei einen deterministischen Auflösungspfad:

• Spezifizierer ermitteln: Die Anwendung instanziiert oder referenziert den für den jeweiligen Kommunikationsport definierten Bezeichner vom Typ ara::core::InstanceSpecifier.
• Instanzen auflösen: Der Bezeichner wird an die Funktion ara::com::runtime::ResolveInstanceIDs übergeben [SWS_CM_00118].
• Ergebnis prüfen: Der Aufruf liefert ein Objekt des Typs ara::core::Result<ara::com::InstanceIdentifierContainer> zurück, das auf erfolgreiche Ausführung oder Fehlerzustände geprüft wird [SWS_CM_00118].
• Container verarbeiten: Bei Erfolg enthält der ara::com::InstanceIdentifierContainer eine Anzahl von Instanzbezeichnern, die proportional zur Anzahl der gefundenen Treffer im Deployment ist [SWS_CM_00118]. Die Anwendung kann gezielt eine Instanz auswählen oder über alle verfügbaren Instanzen iterieren.
• Proxy oder Skeleton instanziieren: Die aufgelösten ara::com::InstanceIdentifier-Objekte werden anschließend zur Erzeugung konkreter Proxy- oder Skeleton-Instanzen verwendet AUTOSAR_AP_SWS_CommunicationManagement S. 42.

Sequenzdiagramm: Aufruf- und Verarbeitungsablauf der Instanzauflösung über ResolveInstanceIDs. Quellen: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement S. 41.

Fehlerszenarien

Die Schnittstellen im Namespace ara::com::runtime folgen dem plattformweiten Paradigma robuster, ausnahmefreier Fehlerbehandlung. Entsprechend der Spezifikation ist ResolveInstanceIDs als noexcept deklariert und besitzt die Ausnahme-Sicherheitsstufe exception safe [SWS_CM_00118]. Fehler werden daher niemals über C++-Exceptions signalisiert, sondern vollständig über den Fehlermonaden ara::core::Result transportiert AUTOSAR_AP_SWS_CommunicationManagement S. 47.

Das zentrale spezifizierte Fehlerszenario betrifft den Fehlercode ComErrc::kInstanceIDNotResolvable [SWS_CM_00118]. Dieser Fehler tritt auf, wenn der übergebene ara::core::InstanceSpecifier formal gültig ist, jedoch in der aktuellen Systemkonfiguration oder im Manifest keinem existierenden ara::com::InstanceIdentifier zugeordnet werden kann [SWS_CM_00118]. Dies deutet in der Praxis auf Diskrepanzen zwischen Modellierung und Deployment hin, etwa wenn ein Service Provider auf einer anderen Maschine nicht deployt wurde oder das Binding im Manifest fehlt. Für diesen Fehler gilt die Rollback-Semantik (rollback_semantics): Es werden keine Teilzustände erzeugt oder Ressourcen gebunden, sodass der Aufrufer die Konfiguration prüfen oder in einen definierten Fehlerzustand übergehen kann [SWS_CM_00118].