klasse ara::rds::ReadDataResult

De structuur ara::rds::ReadDataResult kapselt het resultaat van een leesbewerking uit een ruwe datastroom van het AUTOSAR Adaptive Platform in (AUTOSAR_AP_SWS_RawDataStream, p. 1). Zij wordt gegenereerd door de methoden ReadData en stelt de gelezen binaire gegevens in de buffer data samen met het daadwerkelijke aantal bytes numberOfBytes beschikbaar [SWS_RDS_11301]. Aangezien de buffer wordt beheerd als std::unique_ptr, draagt de structuur vermoedelijk het exclusieve eigenaarschap over aan de aanroeper en sluit kopiëren uit. Vraag (open) Fouten worden gemeld via de omsluitende ara::core::Result, waardoor het resultaat vóór toegang tot de gegevens gevalideerd moet worden.

meer ›

Context

De klasse ara::rds::ReadDataResult fungeert in de module rds (RawDataStream) van het AUTOSAR Adaptive Platform als gestructureerde resultaatcontainer voor het ophalen van gegevens uit datastromen (AUTOSAR_AP_SWS_RawDataStream, p. 1). Haar primaire verantwoordelijkheid bestaat erin de door een ruwe datastroom gelezen ruwe databytes samen met het daadwerkelijk overgedragen aantal bytes over te dragen aan de aanroepende applicatie. Als interactiepartners treden in het systeemverband de stream-instanties op, die de leesmethoden ReadData aanbieden, evenals de desbetreffende applicatiecomponent die de datastroom evalueert en de gegevens verder verwerkt [SWS_RDS_10486], [SWS_RDS_11322].

Levenscyclus

Instanties van ara::rds::ReadDataResult ontstaan in het kader van synchrone of tijdgebonden leesoperaties. De aanmaak wordt geïnitieerd wanneer een aanroeper de methode ReadData(std::size_t maxLength) [SWS_RDS_10486], [SWS_RDS_11322] of de overbelasting met tijdsbewaking ReadData(std::size_t maxLength, std::chrono::milliseconds timeout) [SWS_RDS_11309], [SWS_RDS_11323] aanroept.

De eigendomsverhoudingen en de levenscyclus van het geheugen worden in belangrijke mate bepaald door het opgenomen data-element data, dat gedeclareerd is als std::unique_ptr<ara::core::Byte[]> [SWS_RDS_11301]. Dit betekent volgens gangbare C++-interpretatie dat ReadDataResult vermoedelijk ontworpen is als move-only type en zodoende niet gekopieerd, maar uitsluitend verplaatst kan worden. Vraag Q-fe4b113c5852b5aa (open) Het aanroepende programma neemt met de ontvangst van het object het exclusieve eigenaarschap van de gealloceerde databuffer over. De vernietiging van de instantie leidt automatisch tot de vrijgave van het gereserveerde heapgeheugen van de byte-array, voor zover de pointer niet voordien expliciet uit het object is gehaald. Met betrekking tot concurrency bestaat er geen interne synchronisatie; gelijktijdige toegang tot een instantie vanuit meerdere threads zonder externe locks is niet thread-safe.

Gebruikspad

Het reguliere verloop voor het gebruik van ara::rds::ReadDataResult is onderverdeeld in de volgende deelstappen:

• Aanvraag van de leesbewerking: De applicatie roept op de stream ReadData aan met de maximaal gewenste hoeveelheid data maxLength [SWS_RDS_10486], [SWS_RDS_11322], optioneel aangevuld met een time-outwaarde [SWS_RDS_11309], [SWS_RDS_11323].
• Teruggave van de resultaatcontainer: De stream leest de binaire gegevens uit het kanaal en levert bij succes een gevuld object van het type ara::core::Result<ReadDataResult> terug (AUTOSAR_AP_SWS_RawDataStream, p. 1).
• Groottebepaling: De applicatie leest het veld numberOfBytes uit [SWS_RDS_11302]. Interpretatie: Deze waarde geeft vermoedelijk de daadwerkelijk in de buffer beschikbaar gestelde hoeveelheid bytes aan, die kleiner dan of gelijk aan het aangevraagde maxLength kan zijn. Vraag Q-12bde8c67452a632 (open)
• Gegevensverwerking: De buffer data wordt gederefereerd [SWS_RDS_11301] om de ontvangen bytes te verwerken of via move-semantiek over te dragen naar applicatie-eigen structuren.

Sequentiediagram: Typisch verloop van een leesbewerking met ontvangst en evaluatie van ReadDataResult. Bronnen: [SWS_RDS_10486], [SWS_RDS_11301], [SWS_RDS_11302], AUTOSAR_AP_SWS_RawDataStream, p. 1

Foutscenario's

De methoden voor het genereren van een ReadDataResult zijn gedeclareerd met noexcept [SWS_RDS_10486], [SWS_RDS_11309], [SWS_RDS_11322], [SWS_RDS_11323], waardoor in geval van fouten geen C++-exceptions worden geworpen. In plaats daarvan wordt de foutafhandeling volledig afgehandeld via het retourobject ara::core::Result (AUTOSAR_AP_SWS_RawDataStream, p. 1).

Typische foutscenario's omvatten streamonderbrekingen, ongeldige leesaanvragen of het verstrijken van de wachttijd bij tijdoverwaakte leesaanroepen [SWS_RDS_11309], [SWS_RDS_11323]. Interpretatie: Bij dergelijke mislukkingen bevat de ara::core::Result vermoedelijk geen valide ReadDataResult-object, maar een overeenkomstige foutcode. Vraag Q-f3f971c4789fe8e7 (open) Voor de applicatie betekent dit als randvoorwaarde voor toegang tot data [SWS_RDS_11301] en numberOfBytes [SWS_RDS_11302] dat altijd eerst de succestoestand van het bovenliggende Result-object gecontroleerd moet worden, om toegang tot niet-geïnitialiseerde pointers of ongeldige geheugengebieden te voorkomen.