namespace ara::com::runtime

L'espace de noms ara::com::runtime fournit des services d'exécution centraux pour la résolution de points de terminaison de communication dans la gestion de la communication AUTOSAR_AP_SWS_CommunicationManagement p. 39. Sa fonction principale ResolveInstanceIDs traduit des identifiants de modèle abstraits de type ara::core::InstanceSpecifier en ara::com::InstanceIdentifierContainer concrets et utilisables pour les proxys et les squelettes [SWS_CM_00118]. Si l'association d'un identifiant formellement valide échoue lors du déploiement, la fonction sans exception renvoie le code d'erreur ComErrc::kInstanceIDNotResolvable au sein d'un ara::core::Result. Les appelants doivent donc évaluer l'objet de résultat avant l'instanciation du service.

plus ›

Contexte

L'espace de noms ara::com::runtime fournit des fonctionnalités d'exécution centrales pour la gestion de la communication (ara::com) de l'AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_CommunicationManagement p. 39. Sa responsabilité fonctionnelle principale réside dans le découplage de l'architecture logicielle abstraite vis-à-vis de l'infrastructure de communication concrète au moment de l'exécution. Alors que les applications et les composants logiciels sont liés à des ports dans leurs interfaces via des identifiants de modèle abstraits (ara::core::InstanceSpecifier), le middleware de communication nécessite des données concrètes d'adressage et d'instanciation sous la forme d'objets ara::com::InstanceIdentifier pour l'établissement de connexions [SWS_CM_00118].

La fonction ResolveInstanceIDs déclarée dans l'en-tête ara/com/runtime.h constitue la passerelle entre ces deux niveaux d'abstraction [SWS_CM_00118]. Elle reçoit un ara::core::InstanceSpecifier et le transforme en un ara::com::InstanceIdentifierContainer AUTOSAR_AP_SWS_CommunicationManagement p. 40. Interprétation : l'association concrète devrait reposer en interne sur les configurations de manifeste et de déploiement enregistrées dans le contexte d'exécution, garantissant ainsi que le code applicatif reste portable et exempt d'adresses réseau ou de protocole codées en dur. Question Q-8fab6de1c39a065a (ouverte)

Diagramme de contexte : intégration de ara::com::runtime entre l'architecture applicative et le déploiement de communication. Sources : [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 39.

Parcours d'utilisation

L'utilisation typique de l'espace de noms ara::com::runtime s'effectue pendant la phase d'initialisation et de démarrage d'une application adaptative, avant que des relations de communication ne soient établies via des proxys de service ou des squelettes de service AUTOSAR_AP_SWS_CommunicationManagement p. 41. Un consommateur ou fournisseur de service suit alors un chemin de résolution déterministe :

• Déterminer le spécificateur : l'application instancie ou référence l'identifiant de type ara::core::InstanceSpecifier défini pour le port de communication respectif.
• Résoudre les instances : l'identifiant est transmis à la fonction ara::com::runtime::ResolveInstanceIDs [SWS_CM_00118].
• Vérifier le résultat : l'appel renvoie un objet de type ara::core::Result<ara::com::InstanceIdentifierContainer>, dont l'exécution réussie ou les états d'erreur sont vérifiés [SWS_CM_00118].
• Traiter le conteneur : en cas de succès, le ara::com::InstanceIdentifierContainer contient un nombre d'identifiants d'instance qui est proportionnel au nombre de correspondances trouvées dans le déploiement [SWS_CM_00118]. L'application peut sélectionner de manière ciblée une instance ou itérer sur toutes les instances disponibles.
• Instancier le proxy ou le squelette : les objets ara::com::InstanceIdentifier résolus sont ensuite utilisés pour créer des instances concrètes de proxy ou de squelette AUTOSAR_AP_SWS_CommunicationManagement p. 42.

Diagramme de séquence : déroulement d'appel et de traitement de la résolution d'instances via ResolveInstanceIDs. Sources : [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 41.

Scénarios d'erreur

Les interfaces de l'espace de noms ara::com::runtime suivent le paradigme appliqué à l'échelle de la plateforme d'un traitement d'erreurs robuste et sans exception. Conformément à la spécification, ResolveInstanceIDs est déclaré comme noexcept et possède le niveau de sécurité vis-à-vis des exceptions exception safe [SWS_CM_00118]. Les erreurs ne sont donc jamais signalées par des exceptions C++, mais transportées intégralement via la monade d'erreur ara::core::Result AUTOSAR_AP_SWS_CommunicationManagement p. 47.

Le scénario d'erreur spécifié central concerne le code d'erreur ComErrc::kInstanceIDNotResolvable [SWS_CM_00118]. Cette erreur survient lorsque le ara::core::InstanceSpecifier transmis est formellement valide, mais ne peut être associé à aucun ara::com::InstanceIdentifier existant dans la configuration système actuelle ou dans le manifeste [SWS_CM_00118]. En pratique, cela indique des divergences entre la modélisation et le déploiement, par exemple si un fournisseur de service n'a pas été déployé sur une autre machine ou si le binding manque dans le manifeste. Pour cette erreur, la sémantique de rollback (rollback_semantics) s'applique : aucun état partiel n'est généré ni aucune ressource n'est liée, de sorte que l'appelant peut vérifier la configuration ou basculer vers un état d'erreur défini [SWS_CM_00118].