struct ara::diag::FileTransferService::FileSizes

De structuur ara::diag::FileTransferService::FileSizes dient als gestandaardiseerd waarde-object voor het inkapselen van bestandsgroottegegevens binnen de diagnosemodule van het AUTOSAR Adaptive Platform [SWS_DM_01321]. Deze bundelt de ongecomprimeerde evenals de gecomprimeerde bytegrootte van een bestand in twee openbare 64-bits integer-variabelen voor de voorbereiding en monitoring van overdrachtsoperaties [SWS_DM_01322]. Als passief record bevat de structuur noch eigen methoden noch interne foutafhandeling, zodat de plausibiliteitscontrole van de doorgegeven waarden en de thread-safety door de aanroepende componenten gewaarborgd moeten worden.

meer ›

Context

De structuur ara::diag::FileTransferService::FileSizes is een integraal onderdeel van de diagnosemodule (diag) in het AUTOSAR Adaptive Platform [SWS_DM_01321]. Binnen de namespace van de bovenliggende service ara::diag::FileTransferService definieert deze een compact datamodel voor de representatie van volledige bestandsgroottegegevens AUTOSAR_AP_SWS_Diagnostics §8.18.2 “Struct: FileSizes”. Het type wordt gedeclareerd via het headerbestand ara/diag/file_transfer.h [SWS_DM_01322]. De primaire verantwoordelijkheid bestaat erin de voor bestandsoverdrachtsoperaties relevante grootte-informatie in een uniforme datastructuur te bundelen, zodat interagerende platform- en applicatiecomponenten bestandsgroottes consistent kunnen uitwisselen AUTOSAR_AP_SWS_Diagnostics p. 1126.

Functioneel registreert de datastructuur twee afzonderlijke groottegegevens: de ongecomprimeerde totale grootte van een bestand via het element uncompressed_size [SWS_DM_01322] en de gecomprimeerde totale grootte via het element compressed_size [SWS_DM_01323]. Beide waarden worden bijgehouden als niet-ondertekende 64-bits integers (std::uint64_t) in de maateenheid byte. Daardoor fungeert FileSizes als semantische informatiedrager tussen diagnose-clients, het Diagnostic Management en de concrete serviceproviders die bestandsoverdrachten op het adaptieve platform afhandelen.

Levenscyclus

De structuur ara::diag::FileTransferService::FileSizes is gemodelleerd als een zuiver record (Value Object) zonder eigen virtuele methoden of complexe overervingshiërarchieën AUTOSAR_AP_SWS_Diagnostics §8.18.2.1 “Public Member Variables”. Aanmaak vindt typisch direct op de call-stack plaats of als lid van een bovenliggende datastructuur. Omdat uitsluitend standaard integer-typen zijn opgenomen, is de structuur standaard vermoedelijk zowel kopieerbaar als verplaatsbaar en vereist deze geen dynamisch geheugenbeheer op de heap. Vraag Q-f9c6e76fc8c62463 (open)

Eigendomsverhoudingen zijn afhankelijk van de respectieve gebruikscontext: wordt een instantie aangemaakt door een diagnose-applicatie, dan blijft het eigendom bij deze applicatie of gaat het via doorgifte per waarde (pass-by-value) over naar aangeroepen interfacefuncties. De vernietiging van de instantie is triviaal en geschiedt automatisch bij het verlaten van de scope zonder aanvullende opschoningslogica. Aangezien het type niet voorziet in interne synchronisatiemechanismen, berust het gecoördineerde en thread-safe gebruik bij gelijktijdige toegang tot dezelfde instantie vermoedelijk volledig bij de betrokken diagnose- of applicatiecomponenten. Vraag Q-d2e83f9098c7f8c8 (open)

Gebruikspad

Het typische gebruik van de structuur valt uiteen in de fasen van initialisatie, parametertoewijzing en doorgifte aan overdrachtsroutines van de FileTransferService [SWS_DM_01321]. In een typische use case bepaalt een verzendende component vóór aanvang van een bestandsoverdracht de daadwerkelijke bestandsdimensies op het bestandssysteem of in het geheugen. Vervolgens instantieert deze FileSizes en wijst aan de twee openbare variabelen de gemeten bytewaarden toe:

• uncompressed_size: Specificeert de absolute grootte van het originele bestand in bytes [SWS_DM_01322].
• compressed_size: Specificeert de gecomprimeerde grootte van de over te dragen datastroom in bytes [SWS_DM_01323].

Wordt een bestand zonder voorafgaande compressie overgedragen, dan bevatten compressed_size en uncompressed_size vermoedelijk identieke waarden. Vraag Q-1edcb924fd5932ee (open) Na de initialisatie wordt de structuur overgedragen aan de desbetreffende methoden van de bestandsoverdracht, zodat tegenpartijen de geheugenbehoefte vooraf kunnen alloceren en de voortgang van de overdracht exact kunnen bewaken AUTOSAR_AP_SWS_Diagnostics p. 77.

Foutscenario's

In de specificatie van ara::diag::FileTransferService::FileSizes zijn geen eigen diagnostische foutcodes, retourwaarden of uitzonderingen gedefinieerd AUTOSAR_AP_SWS_Diagnostics §8.18.2 “Struct: FileSizes”. Als passief datatype genereert de structuur zelf geen foutmeldingen en valideert deze de ingevoerde waarden niet tijdens runtime.

Foutmogelijkheden komen vooral voort uit onjuiste pre- en postcondities bij het vullen van de parameters. Door het type std::uint64_t kunnen waarden tot $2^{64}-1$ bytes worden gerepresenteerd [SWS_DM_01322], [SWS_DM_01323]. Mocht een component onwaarschijnlijke groottes doorgeven – bijvoorbeeld een waarde van nul bytes voor bestaande bestanden of een gecomprimeerde grootte die zonder plausibele verklaring de ongecomprimeerde grootte drastisch overschrijdt –, dan moet dit worden opgevangen door de voor- of nageschakelde verwerkingslogica van de FileTransferService. Ook een overloop van het beschikbare doelgeheugen vormt een overkoepelend foutscenario, dat op basis van de in FileSizes verzonden bytewaarden vóór aanvang van de gegevensoverdracht moet worden gedetecteerd.