klasse ara::diag::DiagnosticSovdRecordContentElementDataConstView

De klasse biedt een onveranderlijke weergave op gestructureerde SOVD-record-inhoudselementen voor efficiënte en alleen-lezen evaluatie in diagnose-applicaties ([SWS_DM_02295]). Gebruikers kunnen de foutstatus controleren via resultaatobjecten, record-elementen gericht per sleutel adresseren of de gehele inhoud sequentieel doorlopen met behulp van constante iterators ([SWS_DM_02300]). Alle interfaces zijn volledig thread-veilig en gedeclareerd als uitzonderingsveilig, maar vereisen wel dat het gereferentieerde inhoudselement overeenkomt met het verwachte record-type.

meer ›

Context

De klasse ara::diag::DiagnosticSovdRecordContentElementDataConstView definieert een onveranderlijke weergave (Const View) op diagnostische SOVD-inhoudselementen van het record-gegevenstype ([SWS_DM_02295], AUTOSAR_AP_SWS_Diagnostics §8.60.9 “Class: DiagnosticSovdRecordContentElementDataConstView”). De interface wordt beschikbaar gesteld via de header #include "ara/diag/diagnostic_sovd_content_element_data.h" ([SWS_DM_02298]). Deze stelt diagnose-applicaties in staat om hiërarchisch gestructureerde gegevensvelden van een SOVD-inhoudselement gericht en gestructureerd uit te lezen, zonder kopieën van de payload te hoeven maken of modificerende operaties te hoeven uitvoeren.

Tot de primaire interactiepartners behoren de aanroepende diagnosecomponent, het onderliggende object van het type DiagnosticSovdContentElementData en de via dit object geadresseerde individuele elementen, die als constante referentiewrapper std::reference_wrapper<DiagnosticSovdContentElementData const> of via constante iterators beschikbaar worden gesteld ([SWS_DM_02300], [SWS_DM_02301]).

Levenscyclus

Als weergavetype bezit ara::diag::DiagnosticSovdRecordContentElementDataConstView vermoedelijk geen eigen eigendom (ownership) van de onderliggende payload; de geldigheid van de weergave is vermoedelijk gebonden aan de levensduur van het gereferentieerde DiagnosticSovdContentElementData-object. Vraag Q-4aca4f6f723cd3f5 (open) De vernietiging van de view-instantie geeft enkel de weergavedescriptor vrij, maar laat de onderliggende gegevensstructuur ongemoeid.

Wat betreft gelijktijdigheid zijn alle elementfuncties van de klasse expliciet gespecificeerd als thread-veilig en uitzonderingsveilig (noexcept) ([SWS_DM_02296], [SWS_DM_02298]). Meerdere threads hebben zodoende parallel en zonder synchronisatie leestoegang tot de interface, mits de gereferentieerde gegevensstructuur tijdens de toegang niet gelijktijdig wordt gewijzigd.

Gebruikspad

Een typisch verloop voor de evaluatie van een record-element is onderverdeeld in foutcontrole, dimensiecontrole en elementtoegang:

1. Fouttoestand controleren: Vóór de verwerking wordt via HasError() gevalideerd of de inhoud foutloos aanwezig is ([SWS_DM_02296]).
2. Bezetting opvragen: Via Empty() kan worden gecontroleerd of het record leeg is ([SWS_DM_02299], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.5 “Empty”). De methoden Size() en Capacity() leveren het aantal elementen en de capaciteit van het record op ([SWS_DM_02297], [SWS_DM_02298], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.4 “Capacity”).
3. Gerichte elementtoegang: Vóór de toegang tot een benoemd veld kan met HasContentElement() de aanwezigheid van een sleutel worden gecontroleerd ([SWS_DM_02305]). De willekeurige toegang vindt vervolgens plaats via operator[] onder doorgifte van een ara::core::StringView, die een referentie naar het subelement retourneert ([SWS_DM_02300]). Als alternatief levert Find() een iterator naar het gevonden element op ([SWS_DM_02306]).
4. Sequentiële iteratie: Voor de volledige traversering van alle subelementen staan de iterator-methoden Begin() / End() en CBegin() / CEnd() ter beschikking, die instanties van DiagnosticSovdRecordContentElementDataConstIterator retourneren ([SWS_DM_02301], [SWS_DM_02302], [SWS_DM_02303], [SWS_DM_02304], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.1 “Begin”, AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.2 “CBegin”, AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.3 “CEnd”).

Sequentiediagram: Aanroepvolgorde voor foutcontrole en sleutelgebaseerde elementopvraag. Bronnen: [SWS_DM_02296], [SWS_DM_02300], [SWS_DM_02305].

Foutscenario's

De klasse gebruikt voor foutafhandeling het retourtype ara::core::Result in plaats van C++-excepties:

• Interne fouttoestand: Vertoont het onderliggende SOVD-inhoudselement een fout, dan retourneert HasError() een ara::core::Result<void> die de foutcode ara::diag::DiagSovdErrc bevat ([SWS_DM_02296]).
• Ontbrekende sleutel of typeconflict: Bij toegang via operator[] of bij controle met HasContentElement() levert de retourwaarde een fout-Result op als het DiagnosticSovdContentElementData niet van het type RecordContentElementData of ContentData is of als de opgegeven sleutel niet bestaat ([SWS_DM_02300], [SWS_DM_02305]).
• Schending van randvoorwaarden: Voor de methoden Begin(), End(), CBegin(), CEnd(), Size(), Capacity(), Empty() en Find() geldt als randvoorwaarde dat het gereferentieerde inhoudselement van het type RecordContentElementData of ContentData moet zijn ([SWS_DM_02297], [SWS_DM_02298], [SWS_DM_02299], [SWS_DM_02301], [SWS_DM_02302], [SWS_DM_02303], [SWS_DM_02304], [SWS_DM_02306]).