Maakt het uitlezen van complete bestanden of mappen mogelijk via gedeelde geheugengebieden bij diagnoseverzoeken.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 4c654c39d186HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Maakt het uitlezen van complete bestanden of mappen mogelijk via gedeelde geheugengebieden bij diagnoseverzoeken.
De klasse ara::diag::DataTransferReadSharedDataHandler dient voor de afhandeling van lezende diagnose-gegevensoverdrachten voor bestands- en mapinhoud via gedeeld geheugen ([SWS_DM_01497]). Na de start van de sessie stelt de applicatie-implementatie de volledige gegevens beschikbaar als Shared Data View via Read() en houdt de gealloceerde buffer vast tot de vrijgavemelding door de ReleaseHandler ([SWS_DM_01504]). Vóór de vernietiging van het handlerspecifieke object moet de overdrachtssessie dwingend via ExitRead() worden afgesloten. Het object is uitsluitend bestemd voor een afzonderlijke overdrachtssessie en mag daarom worden verplaatst, maar niet worden gekopieerd.
Context
De klasse ara::diag::DataTransferReadSharedDataHandler behoort tot het diagnosedomein van het AUTOSAR Adaptive Platform in de module diag (AUTOSAR_AP_SWS_Diagnostics §8.10.5 “Class: DataTransferReadSharedDataHandler”). Haar kerntaak bestaat uit de afhandeling van gegevensoverdrachten voor bestands- en mapinhoud die worden gestart door UDS-verzoeken zoals RequestReadFile of RequestReadDirectory ([SWS_DM_01497]). In plaats van afzonderlijke kopieerstappen voor elk overdrachtsblok stelt deze handler de applicatiespecifieke implementatie in staat om de volledige gegevens beschikbaar te stellen als een aaneengesloten, gedeeld geheugengebied.
In het totale systeemverloop werken drie hoofdactoren samen: de externe UDS-client verzendt het leesverzoek naar de regeleenheid. De diagnose-runtime-omgeving AraDiag neemt het verzoek in ontvangst en stuurt de uitvoering door naar de concrete implementatie van DataTransferReadSharedDataHandler ([SWS_DM_01497], [SWS_DM_01504]). Een derde partner, de ReleaseHandler, signaleert aan de applicatie zodra de gedeelde geheugenbronnen niet meer nodig zijn voor het platform en mogen worden vrijgegeven ([SWS_DM_01504]).
Contextdiagram: samenspel tussen UDS-client, AraDiag-runtime-omgeving en de handler-implementatie aan applicatiezijde. Bronnen: [SWS_DM_01497], [SWS_DM_01504], [SWS_DM_01505]
Voor de vernietiging van het object geldt een strikte preconditie: een instantie van deze klasse mag in geen geval worden vernietigd voordat de overdrachtssessie formeel is beëindigd door de aanroep van ExitRead() ([SWS_DM_01499], AUTOSAR_AP_SWS_Diagnostics §8.10.5.1.1.3 “Destructor”). Pas na voltooiing van deze afsluitende behandeling mag de virtuele destructor worden uitgevoerd ([SWS_DM_01499]).
Wat betreft gelijktijdigheid zijn de centrale methoden Read() en ExitRead() aangeduid als niet-thread-safe (not thread-safe), terwijl alle functies van de interface uitzonderingsveiligheid (exception safe) garanderen ([SWS_DM_01498], [SWS_DM_01504], [SWS_DM_01505]).
Gebruikspad
De typische aanroepvolgorde van een gegevensoverdracht met gedeelde geheugengebieden omvat meerdere stappen:
Beschikbaarstelling van de Shared Data:AraDiag roept de zuiver virtuele methode Read() aan en geeft een ReleaseHandler, MetaInfo en een CancellationHandler mee ([SWS_DM_01504]). De applicatie alloceert de volledige bestands- respectievelijk mapinhoud en geeft de gedeelde weergave daarvan als ara::core::Span<ara::core::Byte> via een ara::core::Future terug aan AraDiag ([SWS_DM_01504]).
Geheugenbehoud en vrijgave: de applicatie moet het gealloceerde geheugen dwingend intact houden totdat de ReleaseHandler signaleert dat het geheugengebied veilig kan worden vrijgegeven ([SWS_DM_01504]). De applicatie kan hiervoor een notifier-functie registreren bij de ReleaseHandler of de status ervan actief opvragen ([SWS_DM_01504]). Interpretatie: de signalering via de ReleaseHandler vindt vermoedelijk asynchroon plaats door AraDiag, zodra de gegevensblokken succesvol naar de UDS-client zijn verzonden. Vraag Q-0fbc1c5e667c9a68 (open)
Sessie-afsluiting: voor het beëindigen van de overdracht roept AraDiag de methode ExitRead() aan ([SWS_DM_01505], AUTOSAR_AP_SWS_Diagnostics §8.10.5.1.3.1 “ExitRead”). Naast de beëindigingsreden (DataTransferExitType) worden voertuigfabrikantspecifieke verzoekparameters meegegeven, waarvan de levensduur gegarandeerd is tot de vervulling van de resultaat-promise ([SWS_DM_01505]). De applicatie levert de antwoordgegevens via een ara::core::Future<ara::core::Vector<ara::core::Byte>> terug ([SWS_DM_01505]).
Objectvernietiging: na een succesvolle aanroep van ExitRead() mag de handler-instantie worden vrijgegeven en vernietigd ([SWS_DM_01499]).
Sequentiediagram: stappenvolgorde van de gegevensbeschikbaarstelling via Read() over de geheugenvrijgave tot de afsluiting via ExitRead(). Bronnen: [SWS_DM_01499], [SWS_DM_01504], [SWS_DM_01505]
Foutscenario's
Treden er bij het beschikbaar stellen van de gegevens of bij het beëindigen van de overdracht fouten op, dan worden deze via de desbetreffende ara::core::Future gemeld met een ara::core::ErrorCode uit het domein DiagUdsNrcErrc conform ISO 14229-1 ([SWS_DM_01504], [SWS_DM_01505]).
Een ander scenario vormt het afbreken van een lopende diagnoseconversatie. Beide methoden ontvangen een CancellationHandler ([SWS_DM_01504], [SWS_DM_01505]). De applicatie kan via cancellation_handler.IsCanceled() de afbreekstatus synchroon controleren of via cancellation_handler.SetNotifier() een meldingsfunctie instellen om bij voortijdig afbreken direct te reageren ([SWS_DM_01504], [SWS_DM_01505]).
Een schending van de preconditie met betrekking tot de destructor – wanneer het object wordt vernietigd voordat ExitRead() is aangeroepen – is in strijd met voorschrift [SWS_DM_01499] en leidt tot foutieve programmatoestanden.
Deze klassenhandleiding is gebaseerd op de specificatie AUTOSAR Adaptive Platform Release R25-11.
Provides the whole data to be read out from the application in form of a shared data view. The whole file/directory info content to be sent back to the UDS client will be allocated by the application and its shared ownership (view over the memory location) is passed as a result to AraDiag. The allocated memory must be kept until the ReleaseHandler’s notifier is invoked or the status polled, signalling that the memory, addressed by the Span now can safely be released.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 8bcba929adb6Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De interface ExitRead van de klasse ara::diag::DataTransferReadSharedDataHandler ([SWS_DM_01505]; header ara/diag/data_transfer.h) beëindigt een lopende gegevensoverdrachtsessie.
exit_type (DataTransferExitType): Specificeert de reden voor het beëindigen van de sessie.
transfer_request_parameter_record (ara::core::Span<const ara::core::Byte>): Bevat fabrikantspecifieke parameters ter ondersteuning van de overdracht. De gegevens blijven geldig totdat de bijbehorende Promise is vervuld of de verwerking wordt afgebroken.
meta_info (MetaInfo const&): Bevat aanvullende meta-informatie van het diagnoseverzoek.
cancellation_handler (CancellationHandler): Maakt de controle van de annuleringsstatus via cancellation_handler.IsCanceled() mogelijk, evenals de registratie van een notificatiefunctie via cancellation_handler.SetNotifier(), die wordt aangeroepen bij annulering van de conversatie.
Foutafhandeling en retourwaarden
Bij succesvolle afronding stelt de Future de uitvoergegevens (transferResponseParameterRecord) beschikbaar, die in het positieve antwoord achter de SID worden geplaatst [SWS_DM_01505]. In geval van een fout wordt de Future vervuld met een foutcode uit DiagUdsNrcErrc (toepasselijke NRC conform ISO 14229-1) [SWS_DM_01505].
Gelijktijdigheid en levenscyclus
De methode is gedeclareerd als noexcept (exception safe), maar expliciet gespecificeerd als not thread-safe[SWS_DM_01505]. Wat betreft de levenscyclus van het object geldt het voorschrift dat een instantie van DataTransferReadSharedDataHandler in geen geval vernietigd mag worden voordat ExitRead() is aangeroepen ([SWS_DM_01499]). Analoge beëindigingsfuncties en destructorvereisten bestaan voor de verwante klassen DataTransferReadByPullHandler ([SWS_DM_01514]) en DataTransferReadByPushHandler ([SWS_DM_01523]).
Deze gebruiksinstructie is opgesteld door een AI en is gebaseerd op de specificaties van het AUTOSAR Adaptive Platform.
This parameter record contains parameter(s), which are required
parameter_record
by the server to support the transfer of data. Format and length of this parameter(s) are vehicle manufacturer specific. Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
meta_info
contains additional meta information of the request.
cancellation_handler
This parameter is used to • Query the current cancellation status by calling cancellation_ handler.IsCanceled(). Returns true in case, the current conversation has been cancelled and false otherwise. • Register a notifier function by calling cancellation_handler.Set Notifier(). The registered notifier is called if the current conversation is cancelled.
Returns a Future, which either gets readied to OperationOutput (transferResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for an negative response message). Data in OperationOutput.response_data will be placed after SID as transferResponseParameterRecord in the positive response.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
Provides the whole data to be read out from the application in form of a shared data view. The whole file/directory info content to be sent back to the UDS client will be allocated by the application and its shared ownership (view over the memory location) is passed as a result to AraDiag. The allocated memory must be kept until the ReleaseHandler’s notifier is invoked or the status polled, signalling that the memory, addressed by the Span now can safely be released.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: cba844c9db1eHerkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De methode Read van de interface ara::diag::DataTransferReadSharedDataHandler stelt uit te lezen bestands- of directorydata beschikbaar voor de UDS-client via een gedeelde geheugenweergave ([SWS_DM_01504]). De aanroep vindt asynchroon plaats en geeft een ara::core::Future met een ara::core::Span<ara::core::Byte> terug ([SWS_DM_01504]).
Gebruik en levenscyclus
De implementerende applicatie alloceert de volledige inhoud zelf en draagt de view over aan AraDiag. Het onderliggende geheugengebied moet verplicht ongewijzigd beschikbaar blijven totdat de vrijgave via de overgedragen ReleaseHandler door de notifier ervan is gesignaleerd of via een statuscontrole is opgevraagd ([SWS_DM_01504]). De ReleaseHandler moet voor dezelfde UDS-client worden opgeslagen aan de hand van de MetaInfo ([SWS_DM_01504]). Via de CancellationHandler kan een lopende overdracht via IsCanceled() worden bewaakt of kan een annuleringsnotifier via SetNotifier() worden geregistreerd ([SWS_DM_01504]).
Foutafhandeling en gelijktijdigheid
In het geval van succes worden de data als transferResponseParameterRecord na het blockSequenceCounter verzonden ([SWS_DM_01504]). Als het uitlezen mislukt, moet de Future worden voltooid met een passende foutcode uit DiagUdsNrcErrc conform ISO 14229-1 ([SWS_DM_01504]). Als de interface van de applicatie nog niet of niet meer via offer() beschikbaar is gesteld, meldt de server NRC 0x94 (ResourceTemporarilyNotAvailable) ([SWS_DM_01257]). De functie is gespecificeerd als noexcept en uitzonderingsveilig, maar geldt als niet-thread-safe (not thread-safe) ([SWS_DM_01504]).
Afbakening
In tegenstelling tot DataTransferReadByPullHandler::Read, waarbij datablokken naar een vooraf bepaalde buffer worden gekopieerd ([SWS_DM_01513]), of DataTransferReadByPushHandler::Read, dat vectoren levert via eigendomsoverdracht ([SWS_DM_01522]), draagt deze handler de volledige inhoud over zonder bufferkopie via gedeeld geheugen ([SWS_DM_01504]).
Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de AUTOSAR-standaard.
The release shared resource handler to be stored and used by the application until a new one is passed for the same meta_info (UDS client).
meta_info
Contains additional meta information.
cancellation_handler
This parameter is used to • Query the current cancellation status by calling cancellation_ handler.IsCanceled(). Returns true in case, the current conversation has been cancelled and false otherwise. • Register a notifier function by calling cancellation_handler.Set Notifier(). The registered notifier is called if the current conversation is cancelled.
Returns a Future, which either gets readied to ReadSharedOutput (transferResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for an negative response message). Data in ReleaseSharedHandler.responseData will be placed after the blockSequenceCounter as transferResponseParameterRecord in the positive response.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · Duits origineel