klasse ara::diag::DataTransferWriteSession

De klasse ara::diag::DataTransferWriteSession kapselt schrijvende diagnose-gegevensoverdrachten in en coördineert de doorzending naar applicatiespecifieke schrijf-handlers ([SWS_DM_01555]). Bij binnenkomende UDS-services zoals TransferData (0x36) of RequestTransferExit (0x37) roept de diagnoseserver-instantie de overeenkomstige Write- respectievelijk Exit-methoden van de geregistreerde handlers aan ([SWS_DM_01317]). Aangezien standaard- en kopieerconstructie verwijderd zijn, bestaat de sessie als een uitzonderingsveilig uniek exemplaar, waarvan de creatie vermoedelijk via template-constructors plaatsvindt. Vraag (open)

meer ›

Context

De klasse ara::diag::DataTransferWriteSession kapselt alle varianten van schrijvende gegevensoverdrachten binnen het functionele domein Adaptive Platform Diagnostics ([SWS_DM_01555]) in. Ze fungeert als verbindend element tussen de diagnoseserver-instantie van het platform en de applicatiespecifieke implementaties die de daadwerkelijke schrijftransfer uitvoeren.

In het kader van diagnostische services zoals RequestFileTransfer (bijvoorbeeld bij de bedrijfsmodus ReplaceFile (0x03) conform [SWS_DM_01313]) neemt de diagnoseserver-instantie overdrachtsaanvragen in ontvangst. Komen in het verdere verloop diagnostische verzoeken van de UDS-service TransferData (0x36) binnen, dan delegeert de server deze naar de Write-methode van die handlerklasse die aan de betreffende DataTransferWriteSession is gebonden ([SWS_DM_01317]). Na overdracht van alle datablokken signaleert de service RequestTransferExit (0x37) de voltooiing, waarna de diagnoseserver-instantie de Exit-methode van de geregistreerde handler aanroept ([SWS_DM_01318]).

Contextdiagram: samenspel tussen diagnoseserver, DataTransferWriteSession en applicatiespecifieke handlerklasse. Bronnen: [SWS_DM_01555], [SWS_DM_01317], [SWS_DM_01318].

Levenscyclus

De levenscyclus van een DataTransferWriteSession is onderworpen aan de voorschriften uit het headerbestand ara/diag/data_transfer.h ([SWS_DM_01339]). De standaardconstructie is expliciet verwijderd (DataTransferWriteSession() = delete, [SWS_DM_01339]). Een instantiëring vindt daarom vermoedelijk plaats via template-constructors waarmee specifieke handlerklassen aan het sessieobject worden gebonden (AUTOSAR_AP_SWS_Diagnostics §8.10 “Context of RequestFileTransfer”). Vraag Q-4575aa1e5d0889b3 (open)

Om een eenduidig eigenaarschap af te dwingen is DataTransferWriteSession noch kopieerbaar noch toewijsbaar via kopiëren: zowel de kopieerconstructor ([SWS_DM_01559]) als de kopieertoewijzingsoperator ([SWS_DM_01560]) zijn gedeclareerd als delete. Instanties bestaan bijgevolg als exclusieve unieke exemplaren.

Daarentegen ondersteunt de klasse volledige verplaatsingssemantiek: de verplaatsingsconstructor ([SWS_DM_01557]) en de verplaatsingstoewijzingsoperator ([SWS_DM_01558]) zijn gedeclareerd als standaardimplementatie en gespecificeerd als noexcept en uitzonderingsveilig (“exception safe”). Ze maken de efficiënte overdracht van de sessietoestand tussen programmacontexten mogelijk. De vernietiging vindt plaats via de uitzonderingsveilige standaarddestructor (~DataTransferWriteSession() noexcept = default, [SWS_DM_01556]). Wat betreft gelijktijdigheid zal het gebruik vermoedelijk primair sequentieel binnen de uitvoerende serverthread plaatsvinden, aangezien er geen synchronisatiemechanismen voor gelijktijdige toegang zijn gedocumenteerd. Vraag Q-2c2278884fa11b21 (open)

Gebruikspad

Het reguliere verloop van een schrijvende overdracht voltrekt zich in de volgende stappen:

1. Initialisatie: Bij ontvangst van een schrijfverzoek (bijvoorbeeld RequestFileTransfer met kReplace conform [SWS_DM_01313]) wordt een DataTransferWriteSession opgezet. Hierbij wordt de applicatiespecifieke handler voor schrijfoperaties via template-constructors geregistreerd (AUTOSAR_AP_SWS_Diagnostics §8.10 “Context of RequestFileTransfer”).
2. Gegevensoverdracht per blok: Voor elk binnenkomend verzoek van de UDS-dienst TransferData (0x36) roept de diagnoseserver-instantie de Write-methode van de geregistreerde handler-klasse aan ([SWS_DM_01317]). Deze stap wordt cyclisch herhaald voor alle blokken van de overdracht.
3. Beëindiging van de sessie: Na de volledige overdracht ontvangt de diagnoseserver RequestTransferExit (0x37) en roept vervolgens de Exit-methode van de handler-klasse aan ([SWS_DM_01318]).
4. Opschoning: Na succesvolle afronding of bij voortijdige afbreking wordt het sessie-object vernietigd ([SWS_DM_01556]).

Sequentiediagram: Typisch verloop van een schrijvende gegevensoverdracht via de betrokken instanties. Bronnen: [SWS_DM_01317], [SWS_DM_01318], [SWS_DM_01556].

Foutscenario's

Foutafhandeling en betrouwbaarheid steunen bij ara::diag::DataTransferWriteSession in belangrijke mate op statische typeveiligheid en uitzonderingsveiligheid:

• Vermijden van ongeldige objecttoestanden: Het verwijderen van de default-constructor ([SWS_DM_01339]) voorkomt dat er ongeïnitialiseerde sessie-objecten zonder gekoppelde handler kunnen bestaan. Het verbod op kopieeroperaties ([SWS_DM_01559], [SWS_DM_01560]) sluit inconsistente toestanden door meervoudig eigenaarschap reeds tijdens compilatietijd uit.
• Uitzonderingsveiligheid bij verplaatsen en vernietigen: De declaratie van move-constructor ([SWS_DM_01557]), move-toewijzingsoperator ([SWS_DM_01558]) en destructor ([SWS_DM_01556]) als noexcept garandeert dat er bij overdrachten van resources en bij de afbouw van de sessie tijdens runtime geen uitzonderingen worden gegenereerd.
• Voortijdige afbreking: Mocht een overdracht voortijdig mislukken, dan waarborgt de noexcept-destructor dat het sessie-object ook in het kader van exception-unwinding betrouwbaar kan worden opgeruimd ([SWS_DM_01556]).