class ara::com::ServiceVersionType

Die Klasse ara::com::ServiceVersionType dient der standardisierten Repräsentation und Verwaltung von Service-Versionen in der AUTOSAR Adaptive Platform ([SWS_CM_11515]). Anwendungen nutzen die Instanzen zur Kompatibilitätsprüfung mittels Gleichheits- und Ordnungsvergleichen, zur Ablage in Containern sowie zur Protokollierung mittels ToString() ([SWS_CM_11519]). Der genaue Typ darf vom Communication-Management-Anbieter überschrieben werden, muss jedoch elementare C++-Vergleichs- und Zuweisungsanforderungen erfüllen. Bei der Verwendung ist zu beachten, dass sämtliche Elementfunktionen der Klasse spezifikatorisch als nicht ausnahmesicher eingestuft sind.

mehr ›

Kontext

Die Klasse ara::com::ServiceVersionType definiert im Header ara/com/service/service_version.h (AUTOSAR_AP_SWS_CommunicationManagement §8.11 „Header: ara/com/service/service_version.h“) die Version eines Kommunikationsdienstes ([SWS_CM_11515]). Ihre primäre Verantwortung besteht darin, Service-Versionen für Anwendungssoftware handhabbar zu machen, sodass diese Versionsangaben speichern, verwalten, vergleichen und protokollieren kann ([SWS_CM_11515]).

Eine architektonische Besonderheit liegt in der Flexibilität der Plattform: Gemäß [SWS_CM_11515] darf der konkrete Datentyp durch den Software-Provider des Communication Managements überschrieben oder erweitert werden. Um dennoch eine konsistente Handhabung in portablen Anwendungen sicherzustellen, fordert die Spezifikation, dass der Typ mindestens die C++-Standardkonzepte [equalitycomparable] ([SWS_CM_11516]), [lessthancomparable] ([SWS_CM_11517]) und [copyassignable] ([SWS_CM_11518]) gemäß ISO/IEC 14882:2014 erfüllt.

Zu den Interaktionspartnern zählen neben dem Communication Management Software Provider auch Service-Schnittstellen, welche Versionen als statische Konstante serviceVersion bereitstellen (AUTOSAR_AP_SWS_CommunicationManagement S. 320), sowie die anwendende Software, welche Versionsabgleiche vornimmt.

Kontextdiagramm: Einbettung von ara::com::ServiceVersionType zwischen Software Provider, Service-Schnittstelle und Anwendung. Quellen: [SWS_CM_11515], AUTOSAR_AP_SWS_CommunicationManagement S. 320, AUTOSAR_AP_SWS_CommunicationManagement §8.11.1 „Class: ServiceVersionType“.

Lebenszyklus

Instanzen von ara::com::ServiceVersionType sind als reguläre Werttypen (Value Types) ausgelegt. Die Erzeugung und Wertübernahme erfolgt über Kopie und Zuweisung: Über den Zuweisungsoperator operator= wird die Anforderung [copyassignable] erfüllt ([SWS_CM_11518]), sodass Instanzen neue Werte übernehmen können.

Hinsichtlich der Besitzverhältnisse unterliegt ara::com::ServiceVersionType dem Gültigkeitsbereich des jeweiligen Aufrufers oder wird als Konstante einer Service-Definition vorgehalten (AUTOSAR_AP_SWS_CommunicationManagement S. 320). Der Typ besitzt keine komplexe interne Zustandsmaschine, sondern kapselt einen diskreten Versionswert. Seine Zerstörung erfolgt automatisch beim Verlassen des Gültigkeitsbereichs.

In Bezug auf die Nebenläufigkeit sind die lesenden Operationen operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) und ToString ([SWS_CM_11519]) als const deklariert. Interpretation: Gleichzeitige Lesezugriffe auf dieselbe Instanz aus mehreren Threads dürften ohne Synchronisation sicher sein, während parallele Schreib- und Zuweisungsvorgänge extern geschützt werden müssen. Frage Q-9582ce9a82b9b833 (offen)

Nutzungspfad

Der typische Ablauf zur Nutzung von ara::com::ServiceVersionType in einer Anwendung gliedert sich in folgende Schritte:

1. Versionsabfrage: Die Anwendung greift auf die Versionsinformation eines Dienstes zu, beispielsweise über die statische Konstante serviceVersion einer Schnittstelle (AUTOSAR_AP_SWS_CommunicationManagement S. 320).
2. Kompatibilitätsprüfung: Die Anwendung vergleicht die Version mit einer erwarteten Version über operator== ([SWS_CM_11516]). Für Ordnungsprüfungen oder zur Ablage in sortierten Standard-Containern kommt operator< zum Einsatz ([SWS_CM_11517]).
3. Verwaltung und Speicherung: Zur Weitergabe oder lokalen Speicherung von Versionsständen nutzt die Anwendung den Zuweisungsoperator operator= ([SWS_CM_11518]).
4. Protokollierung: Für Diagnosemeldungen oder Log-Ausgaben erzeugt die Anwendung über die Methode ToString() eine textuelle Repräsentation als ara::core::StringView ([SWS_CM_11519], AUTOSAR_AP_SWS_CommunicationManagement §8.11.1.1.2.1 „ToString“).

Fehlerszenarien

Bei der Verwendung der Schnittstelle sind spezifische Randbedingungen zu beachten:

• Ausnahmesicherheit: Sämtliche spezifizierten Funktionen – operator= ([SWS_CM_11518]), operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) und ToString ([SWS_CM_11519]) – sind in der Spezifikation explizit als not exception safe deklariert. Anwendungen dürfen sich im Fehlerfall (etwa bei Speicherallokationen in anbieterspezifischen Implementierungen) nicht auf automatische Wiederherstellungsgarantien verlassen.
• Gültigkeit des String-Views: Die Methode ToString() liefert ein ara::core::StringView ([SWS_CM_11519]). Interpretation: Da ein StringView keinen eigenen Speicher verwaltet, dürfte die Lebensdauer der referenzierten Zeichenkette an die zugrundeliegende Instanz oder an statischen Speicher gekoppelt sein; eine Verwendung über die Gültigkeit der Datenquelle hinaus führt zu undefiniertem Verhalten. Frage Q-fdb6e821db46af00 (offen)