classe <SI-Namespace>::common::<SI>

En tant qu'espace de noms commun, la classe regroupe des métadonnées statiques et des identifiants pour une interface dans le Communication Management d'AUTOSAR Adaptive SWS CommunicationManagement §8.2.2.1 « Public Member Variables ». Elle fournit via serviceIdentifier et serviceVersion des informations fondamentales pour l'identification et le versionnement univoques du service [SWS_CM_11506]. De plus, serviceContractVersionMajor ainsi que serviceContractVersionMinor définissent la version exacte du contrat de service afin de garantir la compatibilité d'interface. Interprétation : étant donné que tous les éléments déclarés sont statiques, la classe ne requiert probablement aucune instanciation à l'exécution et est intégrée de manière immuable à l'échelle du processus. Question Q-bdf8084e3c4a2dec (ouverte)

plus ›

Contexte

Dans l'AUTOSAR Adaptive Platform, la classe C++ <SI-Namespace>::common::<SI> assume dans le module com (Communication Management) le rôle central d'un conteneur commun de métadonnées et d'espace de noms pour un Service Interface défini SWS CommunicationManagement §8.2.2.1 « Public Member Variables ». La classe regroupe des propriétés statiques et des identifiants d'interface qui s'appliquent de manière uniforme tant aux consommateurs de service qu'aux fournisseurs de service et sont mis à disposition via le fichier d'en-tête #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h" [SWS_CM_11506].

Parmi les partenaires d'interaction principaux figure le Communication Management fonctionnel ara::com, dont les types de données de base sont inclus. La classe expose l'identifiant de service serviceIdentifier de type const ara::com::ServiceIdentifierType [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 « serviceIdentifier ») ainsi que la version de service serviceVersion de type const ara::com::ServiceVersionType [SWS_CM_11507] (SWS CommunicationManagement §8.2.2.1.4 « serviceVersion »). Interprétation : les composants applicatifs et de plateforme utilisent cette définition de classe commune comme référence contraignante pour établir des instances de service via des identificateurs et des contrats d'interface uniformes. Question (ouverte)

Diagramme de contexte : intégration de la classe d'interface commune en interaction avec les applications de service et les types de base du Communication Management. Sources : [SWS_CM_11506], [SWS_CM_11507], SWS CommunicationManagement §8.2.2.1 « Public Member Variables ».

Cycle de vie

En ce qui concerne le cycle de vie, <SI-Namespace>::common::<SI> se distingue fondamentalement des classes d'instances dynamiques : elle ne requiert aucune instanciation explicite et ne possède aucun état géré dynamiquement. Toutes les variables d'interface définies dans la spécification sont déclarées comme des membres de classe statiques SWS CommunicationManagement §8.2.2.1 « Public Member Variables ».

L'identifiant serviceIdentifier [SWS_CM_11506] et les versions serviceVersion [SWS_CM_11507] sont déclarés comme static const. En complément, serviceContractVersionMajor [SWS_CM_11508] (SWS CommunicationManagement §8.2.2.1.1 « serviceContractVersionMajor ») et serviceContractVersionMinor [SWS_CM_11509] (SWS CommunicationManagement §8.2.2.1.2 « serviceContractVersionMinor ») définissent les numéros de version contractuelle sous la forme de valeurs statiques std::uint32_t. Interprétation : la durée de vie statique de ces symboles correspond à la durée totale du processus ; leur initialisation devrait s'effectuer lors du chargement du module respectif ou de la bibliothèque partagée. Il n'existe aucune destruction dynamique ni libération de ressources mémoire. Question (ouverte)

Concernant la concurrence, les variables serviceIdentifier et serviceVersion qualifiées par const offrent une sécurité de thread sans restriction lors d'accès en lecture simultanés. Interprétation : étant donné que les variables de version serviceContractVersionMajor et serviceContractVersionMinor représentent des états de spécification contractuels, elles demeurent probablement inchangées à l'exécution, ce qui permet des accès simultanés en lecture à partir de plusieurs threads d'exécution sans surcoût de synchronisation. Question Q-2335ea4535e239d6 (ouverte)

Parcours d'utilisation

Le chemin d'utilisation typique comprend l'accès statique aux métadonnées et aux informations de version afin de garantir la compatibilité d'interface :

• Inclusion de l'en-tête : l'application ou la couche de communication générée inclut le fichier <SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h afin d'obtenir l'accès à l'espace de noms <SI-Namespace>::common::<SI> [SWS_CM_11506].
• Identification du service : les composants accèdent directement à l'identifiant unique du service via <SI-Namespace>::common::<SI>::serviceIdentifier, par exemple pour initialiser des instances ou pour s'enregistrer auprès de l'infrastructure de communication [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 « serviceIdentifier »).
• Vérification des versions : pour vérifier la compatibilité d'interface entre les partenaires de communication, serviceVersion [SWS_CM_11507] ainsi que les versions de contrat serviceContractVersionMajor [SWS_CM_11508] et serviceContractVersionMinor [SWS_CM_11509] sont lues.

Il n'existe aucune condition préalable pour l'accès en lecture, car toutes les constantes sont déjà disponibles dès le démarrage du programme. Aucun état d'erreur ni aucune exception ne sont spécifiés pour le simple accès en lecture à ces variables statiques.