struct ara::diag::SovdConfiguration::SovdConfigurationMetaInfo

De structuur ara::diag::SovdConfiguration::SovdConfigurationMetaInfo dient als gegevensoverdrachtsobject voor metainformatie bij de overdracht van SOVD-configuratiegegevens in AUTOSAR Adaptive [SWS_DM_01861]. Deze bundelt het MIME-type in mimetype en optioneel de totale lengte van de configuratiegegevens in size, die vóór de overdracht aan de transfermethoden door de applicatie worden ingevuld [SWS_DM_01863]. Als passieve C++-gegevensstructuur zonder eigen methoden bezit deze noch thread-safety noch validatielogica, zodat consistentiecontroles pas door de verwerkende platformdiensten worden uitgevoerd.

meer ›

Context

De structuur ara::diag::SovdConfiguration::SovdConfigurationMetaInfo dient als gestandaardiseerde metadatacontainer voor de overdracht van SOVD-configuratiegegevens (Service-Oriented Vehicle Diagnostics) in het AUTOSAR Adaptive Platform [SWS_DM_01861]. Deze is gedeclareerd in de header ara/diag/sovd_configuration.h en organisatorisch direct toegewezen aan de interfaceklasse ara::diag::SovdConfiguration AUTOSAR_AP_SWS_Diagnostics §8.54.2 “Struct: SovdConfigurationMetaInfo”. De kernverantwoordelijkheid ervan bestaat uit het beschikbaar stellen van de voor de diagnostische configuratieoverdracht vereiste metainformatie, zoals het inhoudstype en de omvang van de gegevens [SWS_DM_01862], [SWS_DM_01863].

Tot de primaire interactiepartners behoren enerzijds de toepassende diagnosetoepassing, die configuratiegegevens genereert, wijzigt of verwerkt, en anderzijds het diagnostische managementsysteem van AUTOSAR Adaptive. De structuur fungeert als gegevensoverdrachtsobject (Data Transfer Object, DTO) dat bemiddelt tussen de applicatiespecifieke logica en de gestandaardiseerde overdrachtsdiensten van het diagnoseplatform. Via de aangeboden velden kunnen zender en ontvanger overeenkomen in welk formaat de configuratiegegevens beschikbaar zijn en hoeveel bytes in het transmissiekanaal worden verwacht.

Levenscyclus

Als zuiver passief C++-gegevenstype (struct) is SovdConfigurationMetaInfo niet onderhevig aan complexe platformgestuurde levenscyclusfasen [SWS_DM_01861]. De aanmaak vindt gewoonlijk direct plaats door de Adaptive Application op de stack of op de heap, onmiddellijk voordat een configuratieoverdracht wordt geïnitieerd of een ontvangen metadataset wordt geëvalueerd. De structuur volgt de reguliere waardesemantiek van C++; de bezittende component draagt de verantwoordelijkheid voor instantiëring en levensduur.

Wat betreft de interne toestand bezit de structuur geen toestandsmachine en geen discrete bedrijfsmodi. Na initialisatie van de publieke variabelen blijven de gegevens tot aan de vernietiging van de instantie ongewijzigd in het geheugen, tenzij ze door de bezittende applicatie expliciet worden overschreven. De vrijgave van de instantie vindt automatisch plaats volgens het RAII-patroon bij het verlaten van de scope, waarbij het dynamisch gealloceerde geheugen van de opgenomen string wordt vrijgegeven [SWS_DM_01863].

Wat betreft gelijktijdigheid biedt SovdConfigurationMetaInfo geen geïntegreerde thread-safety. Meerdere threads mogen een instantie gelijktijdig lezend verwerken, bijvoorbeeld voor inspectie van de configuratieparameters. Gelijktijdige schrijftoegang tot dezelfde instantie vereist echter externe synchronisatiemaatregelen, aangezien concurrerende wijzigingen aan de lidvariabelen leiden tot inconsistenties in de gegevens.

Gebruikspad

Een typische usecase bestaat uit het voorbereiden en beschikbaar stellen van metadata voorafgaand aan de daadwerkelijke configuratieoverdracht. De applicatie instantieert eerst de structuur en wijst aan het veld mimetype een tekenreeks toe die het mediatype van het configuratiebestand beschrijft [SWS_DM_01863], AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.1 “mimetype”. Dit stelt de ontvanger in staat om de gegevens toe te wijzen aan een parser of schema, bijvoorbeeld voor JSON- of XML-gebaseerde configuraties.

In de volgende stap wordt gecontroleerd of de exacte bestandsgrootte van de payload vooraf kan worden bepaald. Is dit het geval, dan wordt het attribuut size ingesteld op de corresponderende geheeltallige bytewaarde [SWS_DM_01862], AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.2 “size”. Als de grootte voorafgaand aan de overdracht onbekend is, blijft de variabele niet-ingesteld. Vervolgens wordt het voorbereide object als argument doorgegeven aan de overdrachtsfunctie van de klasse ara::diag::SovdConfiguration.

Sequentiediagram: typisch verloop van de initialisatie en overdracht van SovdConfigurationMetaInfo in het kader van de configuratieoverdracht. Bronnen: [SWS_DM_01861], [SWS_DM_01862], [SWS_DM_01863], AUTOSAR_AP_SWS_Diagnostics §8.54.2 “Struct: SovdConfigurationMetaInfo”.

Foutscenario's

Omdat SovdConfigurationMetaInfo is ontworpen als zuivere gegevensstructuur zonder lidfuncties, definieert deze geen eigen retourwaarden, foutcodes of excepties [SWS_DM_01861]. Mogelijke foutcondities komen primair voort uit onvolledige of inconsistente gegevensinvullingen, die worden gedetecteerd door de verwerkende platformdiensten in ara::diag::SovdConfiguration.

Interpretatie: Een eerste foutscenario betreft niet-toegestane MIME-types. Vraag (open) Als in mimetype een lege tekenreeks of een niet-ondersteunde formaataanduiding wordt ingevoerd, zal de aangeroepen overdrachtsdienst de verwerking vermoedelijk weigeren en een bijbehorende foutcode terugmelden aan de applicatie. Een tweede foutscenario ligt in een discrepantie in de gegevensgrootte: wijkt de daadwerkelijk overgedragen gegevenshoeveelheid af van de in size gedeclareerde bytewaarde, dan breekt de diagnose-infrastructuur de overdracht vermoedelijk af wegens inconsistentie. Bovendien leidt een niet-ingesteld size-veld vermoedelijk tot overdrachtsfouten als het geselecteerde transportkanaal een vooraf bekende totale lengte dwingend vereist.