klasse <SI-Namespace>::common::<SI>

De klasse bundelt als gemeenschappelijke naamruimte statische metadata en identificatoren voor een interface in Communication Management van AUTOSAR Adaptive SWS CommunicationManagement §8.2.2.1 “Public Member Variables”. Ze stelt via serviceIdentifier en serviceVersion basisinformatie voor de eenduidige identificatie en versionering van de service ter beschikking [SWS_CM_11506]. Daarnaast definiëren serviceContractVersionMajor en serviceContractVersionMinor de exacte versie van het servicecontract om de interfacecompatibiliteit te waarborgen. Interpretatie: aangezien alle gedeclareerde elementen statisch aanwezig zijn, vereist de klasse vermoedelijk geen instantiëring tijdens runtime en wordt ze procesbreed onveranderlijk opgenomen. Vraag Q-bdf8084e3c4a2dec (open)

meer ›

Context

In het AUTOSAR Adaptive Platform vervult de C++-klasse <SI-Namespace>::common::<SI> in de module com (Communication Management) de centrale rol van een gemeenschappelijke container voor metadata en naamruimten voor een gedefinieerde Service Interface SWS CommunicationManagement §8.2.2.1 “Public Member Variables”. De klasse vat statische eigenschappen en interface-identificatoren samen die zowel voor serviceconsumenten als voor serviceproviders uniform gelden en via het headerbestand #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h" beschikbaar worden gesteld [SWS_CM_11506].

Tot de primaire interactiepartners behoort het functionele Communication Management ara::com, waarvan de basisgegevenstypen worden geïmporteerd. De klasse exposeert de service-identificator serviceIdentifier van het type const ara::com::ServiceIdentifierType [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 “serviceIdentifier”) en de serviceversie serviceVersion van het type const ara::com::ServiceVersionType [SWS_CM_11507] (SWS CommunicationManagement §8.2.2.1.4 “serviceVersion”). Interpretatie: applicatie- en platformcomponenten gebruiken deze gemeenschappelijke klassedefinitie als bindende referentie om service-instanties op te bouwen via uniforme identificatoren en interfacecontracten. Vraag (open)

Contextdiagram: inpassing van de gemeenschappelijke interfaceklasse in het samenspel met servicetoepassingen en basistypen van Communication Management. Bronnen: [SWS_CM_11506], [SWS_CM_11507], SWS CommunicationManagement §8.2.2.1 “Public Member Variables”.

Levenscyclus

Wat betreft de levenscyclus verschilt <SI-Namespace>::common::<SI> fundamenteel van dynamische instantieklassen: ze vereist geen expliciete instantiëring en bezit geen dynamisch beheerde toestand. Alle in de specificatie gedefinieerde interfacevariabelen zijn gedeclareerd als statische klasse-elementen SWS CommunicationManagement §8.2.2.1 “Public Member Variables”.

De identificator serviceIdentifier [SWS_CM_11506] en de versionering serviceVersion [SWS_CM_11507] zijn gedeclareerd als static const. Aanvullend hierop definiëren serviceContractVersionMajor [SWS_CM_11508] (SWS CommunicationManagement §8.2.2.1.1 “serviceContractVersionMajor”) en serviceContractVersionMinor [SWS_CM_11509] (SWS CommunicationManagement §8.2.2.1.2 “serviceContractVersionMinor”) de contractversienummers als statische std::uint32_t-waarden. Interpretatie: de statische levensduur van deze symbolen komt overeen met de volledige procesduur; hun initialisatie vindt vermoedelijk plaats bij het laden van de desbetreffende module respectievelijk de shared library. Vraag (open) Er bestaat geen dynamische vernietiging of vrijgave van geheugenbronnen.

Met betrekking tot concurrency bieden de met const gekwalificeerde variabelen serviceIdentifier en serviceVersion onbeperkte thread-safety bij gelijktijdige leestoegangen. Interpretatie: aangezien de versievariabelen serviceContractVersionMajor en serviceContractVersionMinor contractuele specificatiestanden vertegenwoordigen, blijven ze tijdens runtime vermoedelijk ongewijzigd, waardoor gelijktijdige leestoegangen vanuit meerdere uitvoeringsthreads mogelijk zijn zonder synchronisatie-overhead. Vraag Q-2335ea4535e239d6 (open)

Gebruikspad

Het typische gebruikspad omvat de statische toegang tot metadata en versie-informatie om de interfacecompatibiliteit te waarborgen:

• Header-opname: de applicatie of de gegenereerde communicatielaag bindt het bestand <SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h in om toegang te verkrijgen tot de naamruimte <SI-Namespace>::common::<SI> [SWS_CM_11506].
• Service-identificatie: componenten benaderen rechtstreeks via <SI-Namespace>::common::<SI>::serviceIdentifier de unieke identificator van de service, bijvoorbeeld voor de initialisatie van instanties of voor registratie bij de communicatie-infrastructuur [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 “serviceIdentifier”).
• Versievergelijking: ter verificatie van de interfacecompatibiliteit tussen communicatiepartners worden serviceVersion [SWS_CM_11507] en de contractversies serviceContractVersionMajor [SWS_CM_11508] en serviceContractVersionMinor [SWS_CM_11509] uitgelezen.

Er zijn geen precondities voor leestoegang, aangezien alle constanten al bij de programmastart beschikbaar zijn. Fouttoestanden of uitzonderingen zijn niet gespecificeerd voor pure leestoegang tot deze statische variabelen.