struct ara::diag::SovdBulkData::BulkDataMetaDataDescriptor

De structuur ara::diag::SovdBulkData::BulkDataMetaDataDescriptor dient als datatransferobject voor het beschrijven van massadata voor de SOVD-diagnosecommunicatie in AUTOSAR Adaptive ([SWS_DM_01830]). Deze bundelt identificatie-, lokalisatie- en type-informatie zoals id, file_name en mimetype evenals controlesommen en optionele groottegegevens (SWS Diagnostics §8.53.2 “Struct: BulkDataMetaDataDescriptor”). De instantie wordt door de leverende diagnosetoepassing van metadata voorzien en overgedragen aan het SOVD-subsysteem. Als passieve C++-structuur zonder eigen synchronisatie moeten gelijktijdige schrijfacties extern worden beveiligd door de aanroepende applicatie.

meer ›

Context

De datastructuur ara::diag::SovdBulkData::BulkDataMetaDataDescriptor maakt deel uit van de module diag van het AUTOSAR Adaptive Platform en wordt beschikbaar gesteld via de header #include "ara/diag/sovd_bulk_data.h" ([SWS_DM_01830]). Deze definieert de metadatadescriptor voor diagnose-massadata (bulk data) die worden overgedragen in het kader van SOVD (Service-Oriented Vehicle Diagnostics) (SWS Diagnostics §8.53.2 “Struct: BulkDataMetaDataDescriptor”). Bij diagnosescenario’s zoals het uitlezen van omvangrijke logbestanden, trace-buffers of updatepakketten hebben diagnoseclients naast de binaire datastroom gestructureerde begeleidende informatie nodig. De structuur bundelt deze metadata voor eenduidige identificatie, interpretatie en integriteitscontrole.

In de wisselwerking tussen diagnostische applicatie, het runtimesysteem ara::diag en externe diagnosetesters fungeert de structuur als passief datatransferobject (DTO). Het veld id legt de unieke identificatie van de massadata vast ([SWS_DM_01831]). Voor de naamgeving zijn file_name voor de bestandsnaam ([SWS_DM_01836]), name voor de logische aanduiding ([SWS_DM_01833]) en translation_id voor lokalisatiedoeleinden beschikbaar ([SWS_DM_01834]). Het mediatype wordt gedeclareerd door mimetype ([SWS_DM_01832]). Voor de integriteitsborging zorgen hash ([SWS_DM_01839]) en hash_algorithm ([SWS_DM_01840]), terwijl creation_date ([SWS_DM_01837]) en last_modified ([SWS_DM_01838]) de temporele ordening definiëren (SWS Diagnostics §8.53.2.1 “Public Member Variables”).

Levenscyclus

Als C++-structuur beschikt BulkDataMetaDataDescriptor over puur publieke attributen zonder eigen businesslogische constructors ([SWS_DM_01830]). Interpretatie: De structuur wordt vermoedelijk primair door de gegevensverstrekkende diagnoseapplicatie als waarde-object op de stack of heap geïnstantieerd en gevuld, om aansluitend aan het SOVD-subsysteem te worden overgedragen. Vraag Q-4a0434afda63d047 (open) De levensduur volgt de reguliere regels voor C++-objecten; opgenomen leden van het type ara::core::String evenals het optionele grootteveld ara::core::Optional<std::uint64_t> worden bij vernietiging van de instantie deterministisch vrijgegeven ([SWS_DM_01835]).

De structuur zelf bezit geen interne toestanden of toestandsovergangen. In multithreading-omgevingen is het gelijktijdig lezen van een instantie niet kritisch; schrijfacties op de publieke variabelen moeten echter extern worden gesynchroniseerd door de aanroepende applicatie, aangezien er geen geïntegreerde beschermingsmechanismen bestaan.

Gebruikspad

De typische aanroepvolgorde voor het gebruik van de metadatadescriptor in het kader van een SOVD-massaoverdracht bestaat uit de volgende stappen:

1. Instantiëring: De diagnoseapplicatie creëert een instantie van BulkDataMetaDataDescriptor ([SWS_DM_01830]).
2. Identificatie en naamgeving toekennen: Het massadata-object wordt beschreven via id ([SWS_DM_01831]), name ([SWS_DM_01833]) en file_name ([SWS_DM_01836]). Indien nodig wordt translation_id vastgelegd ([SWS_DM_01834]).
3. MIME-type en tijdstempels invullen: Het formaat wordt vastgelegd via mimetype ([SWS_DM_01832]). De datumgegevens creation_date ([SWS_DM_01837]) en last_modified ([SWS_DM_01838]) worden in de praktijk vermoedelijk geformatteerd als ISO-8601-conforme tijdstempelreeksen. Vraag Q-fa352dc221e9452a (open)
4. Controlewaarden en bytegrootte registreren: Na het genereren van de payload worden de controlesom in hash ([SWS_DM_01839]) en het algoritme in hash_algorithm ([SWS_DM_01840]) ingevuld. Voor zover het aantal bytes vooraf bekend is, wordt size ingevuld ([SWS_DM_01835]); blijft het optionele veld leeg, dan signaleert dit vermoedelijk een op het moment van beschikbaarstelling nog variabele bestandsgrootte. Vraag Q-03f717e53701c9c0 (open)
5. Overdracht aan het SOVD-subsysteem: De geïnitialiseerde descriptor wordt overgedragen aan ara::diag, zodat externe SOVD-clients de metadata kunnen opvragen.

Sequentiediagram: Typisch verloop van het aanmaken, invullen en beschikbaar stellen van BulkDataMetaDataDescriptor in de SOVD-diagnosecontext. Bronnen: SWS Diagnostics §8.53.2 “Struct: BulkDataMetaDataDescriptor”, [SWS_DM_01830].

Foutscenario's

Aangezien BulkDataMetaDataDescriptor een passieve datastructuur is, worden er geen foutcodes direct door de structuur geretourneerd. Fouten worden zichtbaar bij de aansluitende verwerking door ara::diag of de client:

• Controlesomdiscrepantie: Komt de in hash ([SWS_DM_01839]) opgegeven hash niet overeen met de daadwerkelijke inhoud of is hash_algorithm ([SWS_DM_01840]) onbekend, dan mislukt de verificatie bij de client.
• Afwijkende bytegrootte: Als het optionele veld size ([SWS_DM_01835]) is ingesteld en afwijkt van het reëel ontvangen aantal bytes, meldt de ontvanger een overdrachtsfout.
• Ongeldig mediatype: Een foutieve of lege mimetype ([SWS_DM_01832]) leidt tot interpretatiefouten in de clienttool.
• Ontbrekende verplichte identificatie: Worden id ([SWS_DM_01831]) of file_name ([SWS_DM_01836]) niet ingevuld, dan kan de dataset binnen het SOVD-framework niet eenduidig worden geadresseerd.