class <SI-Namespace>::common::<SI>

Die Klasse bündelt als gemeinsamer Namensraum statische Metadaten und Kennungen für eine Schnittstelle im Kommunikations-Management von AUTOSAR Adaptive SWS CommunicationManagement §8.2.2.1 „Public Member Variables“. Sie stellt über serviceIdentifier und serviceVersion grundlegende Informationen zur eindeutigen Identifikation und Versionierung des Dienstes zur Verfügung [SWS_CM_11506]. Zusätzlich definieren serviceContractVersionMajor sowie serviceContractVersionMinor die exakte Version des Servicevertrags zur Sicherstellung der Schnittstellenkompatibilität. Interpretation: Da alle deklarierten Elemente statisch vorliegen, erfordert die Klasse vermutlich keine Instanziierung zur Laufzeit und wird prozessweit unveränderlich eingebunden. Frage Q-bdf8084e3c4a2dec (offen)

mehr ›

Kontext

In der AUTOSAR Adaptive Platform erfüllt die C++-Klasse <SI-Namespace>::common::<SI> im Modul com (Communication Management) die zentrale Rolle eines gemeinsamen Metadaten- und Namensraum-Containers für ein definiertes Service Interface SWS CommunicationManagement §8.2.2.1 „Public Member Variables“. Die Klasse fasst statische Eigenschaften und Schnittstellenkennungen zusammen, die sowohl für Dienstkonsumenten als auch für Dienstbereitsteller einheitlich gelten und über die Header-Datei #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h" bereitgestellt werden [SWS_CM_11506].

Zu den primären Interaktionspartnern gehört das funktionale Kommunikations-Management ara::com, dessen grundlegende Datentypen eingebunden werden. Die Klasse exponiert die Dienstkennung serviceIdentifier vom Typ const ara::com::ServiceIdentifierType [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 „serviceIdentifier“) sowie die Dienstversion serviceVersion vom Typ const ara::com::ServiceVersionType [SWS_CM_11507] (SWS CommunicationManagement §8.2.2.1.4 „serviceVersion“). Interpretation: Anwendungs- und Plattformkomponenten nutzen diese gemeinsame Klassendefinition als verbindliche Referenz, um Dienstinstanzen über einheitliche Identifikatoren und Schnittstellenverträge aufzubauen. Frage (offen)

Kontextdiagramm: Einordnung der gemeinsamen Schnittstellenklasse im Zusammenspiel mit Dienstanwendungen und Basistypen des Kommunikations-Managements. Quellen: [SWS_CM_11506], [SWS_CM_11507], SWS CommunicationManagement §8.2.2.1 „Public Member Variables“.

Lebenszyklus

Hinsichtlich des Lebenszyklus unterscheidet sich <SI-Namespace>::common::<SI> grundlegend von dynamischen Instanzklassen: Sie erfordert keine explizite Instanziierung und besitzt keinen dynamisch verwalteten Zustand. Alle in der Spezifikation definierten Schnittstellenvariablen sind als statische Klassenelemente deklariert SWS CommunicationManagement §8.2.2.1 „Public Member Variables“.

Die Kennung serviceIdentifier [SWS_CM_11506] und die Versionierung serviceVersion [SWS_CM_11507] sind als static const deklariert. Ergänzend dazu definieren serviceContractVersionMajor [SWS_CM_11508] (SWS CommunicationManagement §8.2.2.1.1 „serviceContractVersionMajor“) und serviceContractVersionMinor [SWS_CM_11509] (SWS CommunicationManagement §8.2.2.1.2 „serviceContractVersionMinor“) die Vertragsversionsnummern als statische std::uint32_t-Werte. Interpretation: Die statische Lebensdauer dieser Symbole entspricht der gesamten Prozessdauer; ihre Initialisierung dürfte beim Laden des jeweiligen Moduls bzw. der Shared Library erfolgen. Frage (offen) Es existiert keine dynamische Zerstörung oder Freigabe von Speicherressourcen.

Bezüglich der Nebenläufigkeit bieten die mit const qualifizierten Variablen serviceIdentifier und serviceVersion uneingeschränkte Thread-Sicherheit bei simultanen Lesezugriffen. Interpretation: Da die Versionsvariablen serviceContractVersionMajor und serviceContractVersionMinor vertragliche Spezifikationsstände repräsentieren, verbleiben sie zur Laufzeit vermutlich unverändert, womit gleichzeitige Lesezugriffe aus mehreren Ausführungsthreads ohne Synchronisationsaufwand möglich sind. Frage Q-2335ea4535e239d6 (offen)

Nutzungspfad

Der typische Nutzungspfad umfasst den statischen Zugriff auf Metadaten und Versionsinformationen zur Gewährleistung der Schnittstellenkompatibilität:

• Header-Einbindung: Die Anwendung oder die generierte Kommunikationsschicht bindet die Datei <SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h ein, um Zugriff auf den Namensraum <SI-Namespace>::common::<SI> zu erhalten [SWS_CM_11506].
• Dienstidentifikation: Komponenten greifen direkt über <SI-Namespace>::common::<SI>::serviceIdentifier auf die eindeutige Kennung des Dienstes zu, beispielsweise zur Initialisierung von Instanzen oder zur Registrierung bei der Kommunikationsinfrastruktur [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 „serviceIdentifier“).
• Versionsabgleich: Zur Verifikation der Schnittstellenkompatibilität zwischen Kommunikationspartnern werden serviceVersion [SWS_CM_11507] sowie die Vertragsversionen serviceContractVersionMajor [SWS_CM_11508] und serviceContractVersionMinor [SWS_CM_11509] ausgelesen.

Vorbedingungen für den Lesezugriff bestehen nicht, da sämtliche Konstanten bereits bei Programmstart verfügbar sind. Fehlerzustände oder Ausnahmen sind für den reinen Lesezugriff auf diese statischen Variablen nicht spezifiziert.