klasse ara::com::ServiceVersionType

De klasse ara::com::ServiceVersionType dient voor de gestandaardiseerde representatie en het beheer van serviceversies in het AUTOSAR Adaptive Platform ([SWS_CM_11515]). Toepassingen gebruiken de instanties voor compatibiliteitscontrole via gelijkheids- en volgordevergelijkingen, voor opslag in containers en voor logging via ToString() ([SWS_CM_11519]). Het exacte type mag door de Communication Management-provider worden overschreven, maar moet wel voldoen aan elementaire C++-vergelijkings- en toewijzingsvereisten. Bij gebruik moet er rekening mee worden gehouden dat alle lidfuncties van de klasse volgens de specificatie zijn geclassificeerd als niet exception-safe.

meer ›

Context

De klasse ara::com::ServiceVersionType definieert in de header ara/com/service/service_version.h (AUTOSAR_AP_SWS_CommunicationManagement §8.11 “Header: ara/com/service/service_version.h”) de versie van een communicatieservice ([SWS_CM_11515]). Haar primaire verantwoordelijkheid bestaat erin serviceversies hanteerbaar te maken voor applicatiesoftware, zodat deze versiegegevens kan opslaan, beheren, vergelijken en loggen ([SWS_CM_11515]).

Een architectonische bijzonderheid ligt in de flexibiliteit van het platform: conform [SWS_CM_11515] mag het concrete datatype worden overschreven of uitgebreid door de softwareprovider van Communication Management. Om desondanks een consistente hantering in draagbare toepassingen te waarborgen, vereist de specificatie dat het type ten minste voldoet aan de C++-standaardconcepten [equalitycomparable] ([SWS_CM_11516]), [lessthancomparable] ([SWS_CM_11517]) en [copyassignable] ([SWS_CM_11518]) conform ISO/IEC 14882:2014.

Tot de interactiepartners behoren naast de Communication Management Software Provider ook service-interfaces, die versies als statische constante serviceVersion beschikbaar stellen (AUTOSAR_AP_SWS_CommunicationManagement p. 320), evenals de toepassingssoftware, die versiecontroles uitvoert.

Contextdiagram: Inbedding van ara::com::ServiceVersionType tussen softwareprovider, service-interface en toepassing. Bronnen: [SWS_CM_11515], AUTOSAR_AP_SWS_CommunicationManagement p. 320, AUTOSAR_AP_SWS_CommunicationManagement §8.11.1 “Class: ServiceVersionType”.

Levenscyclus

Instanties van ara::com::ServiceVersionType zijn ontworpen als reguliere waardetypes (value types). De aanmaak en overname van waarden gebeurt via kopiëren en toewijzen: via de toewijzingsoperator operator= wordt voldaan aan de eis [copyassignable] ([SWS_CM_11518]), zodat instanties nieuwe waarden kunnen overnemen.

Wat betreft eigendomsverhoudingen valt ara::com::ServiceVersionType binnen de scope van de respectievelijke aanroeper of wordt aangehouden als constante van een servicedefinitie (AUTOSAR_AP_SWS_CommunicationManagement p. 320). Het type heeft geen complexe interne toestandsmachine, maar kapselt een discrete versiewaarde in. De vernietiging vindt automatisch plaats bij het verlaten van de scope.

Met betrekking tot gelijktijdigheid zijn de leesoperaties operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) en ToString ([SWS_CM_11519]) gedeclareerd als const. Interpretation: Gelijktijdige leestoegangen tot dezelfde instantie vanuit meerdere threads zullen vermoedelijk veilig zijn zonder synchronisatie, terwijl parallelle schrijf- en toewijzingsbewerkingen extern moeten worden beschermd. Vraag Q-9582ce9a82b9b833 (open)

Gebruikspad

Het typische verloop voor het gebruik van ara::com::ServiceVersionType in een toepassing is onderverdeeld in de volgende stappen:

1. Versie opvragen: De toepassing benadert de versie-informatie van een service, bijvoorbeeld via de statische constante serviceVersion van een interface (AUTOSAR_AP_SWS_CommunicationManagement p. 320).
2. Compatibiliteitscontrole: De toepassing vergelijkt de versie met een verwachte versie via operator== ([SWS_CM_11516]). Voor volgordevergelijkingen of voor opslag in gesorteerde standaardcontainers wordt operator< gebruikt ([SWS_CM_11517]).
3. Beheer en opslag: Voor het doorgeven of lokaal opslaan van versiestanden gebruikt de toepassing de toewijzingsoperator operator= ([SWS_CM_11518]).
4. Logging: Voor diagnoseberichten of log-uitvoer genereert de toepassing via de methode ToString() een tekstuele representatie als ara::core::StringView ([SWS_CM_11519], AUTOSAR_AP_SWS_CommunicationManagement §8.11.1.1.2.1 “ToString”).

Foutscenario's

Bij het gebruik van de interface moeten specifieke randvoorwaarden in acht worden genomen:

• Exceptieveiligheid: Alle gespecificeerde functies – operator= ([SWS_CM_11518]), operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) en ToString ([SWS_CM_11519]) – zijn in de specificatie expliciet gedeclareerd als not exception safe. Toepassingen mogen in geval van fouten (zoals bij geheugenallocaties in providerspecifieke implementaties) niet vertrouwen op automatische herstelgaranties.
• Geldigheid van de string-view: De methode ToString() levert een ara::core::StringView ([SWS_CM_11519]). Interpretation: Aangezien een StringView geen eigen geheugen beheert, zal de levensduur van de gerefereerde tekenreeks vermoedelijk gekoppeld zijn aan de onderliggende instantie of aan statisch geheugen; gebruik na afloop van de geldigheid van de gegevensbron leidt tot ongedefinieerd gedrag. Vraag Q-fdb6e821db46af00 (open)