klasse ara::diag::DiagnosticSovdContentElementDataWithKey

De klasse dient voor het inkapselen van een SOVD-diagnose-inhoudselement samen met een unieke sleutel-identifier [SWS_DM_02375]. Zij wordt door Diagnostic Management bij schrijftoegang conform ASAM SOVD gevuld en doorgegeven aan GenericDiagnosticSovdContent::Write [SWS_DM_02166]. Alle memberfuncties zijn thread-safe en uitzonderingsveilig gespecificeerd, waarbij foutieve toewijzingen via ara::core::Result met DiagErrc::kInvalidArgument worden gemeld [SWS_DM_02381].

meer ›

Context

De klasse ara::diag::DiagnosticSovdContentElementDataWithKey dient binnen het Adaptive Platform als datakapsel voor een afzonderlijk diagnose-inhoudselement in de context van ASAM SOVD (Service-Oriented Vehicle Diagnostics) en koppelt een unieke sleutel-identifier aan een payload-object [SWS_DM_02375]. SOVD-data worden gestructureerd via het modelelement DiagnosticSovdContent, dat is samengesteld uit ten minste één DiagnosticSovdContentElement AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 “SOVD Data – Conversion”. Terwijl leesopvragingen via GenericDiagnosticSovdContent::Read worden afgehandeld [SWS_DM_01432], interacteert de klasse primair met Diagnostic Management (DM) en de service-interface GenericDiagnosticSovdContent::Write om gestructureerde schrijftoegang tot databronnen uit te voeren [SWS_DM_01431], [SWS_DM_02166].

Levenscyclus

De instantiëring en vernietiging van ara::diag::DiagnosticSovdContentElementDataWithKey vinden plaats met inachtneming van het RAII-principe. Zowel de destructor als de bijbehorende kopieer- en verplaatsoperaties (move-/copy-constructors en toewijzingsoperatoren) zijn expliciet als noexcept gedeclareerd [SWS_DM_02376]. Wat de eigendomsverhouding betreft, neemt de klasse de payload-inhoud over via doorgifte per waarde in SetContent [SWS_DM_02381], terwijl de sleutelnaam als ara::core::StringView wordt doorgegeven [SWS_DM_02378]. Diagnostic Management zal intern vermoedelijk waarborgen dat de onderliggende tekenreeks gedurende de toegang geldig blijft of naar intern geheugen wordt gekopieerd. Vraag Q-f00f62f43629a773 (open) Alle memberfuncties van de klasse zijn volgens de specificatie thread-safe en uitzonderingsveilig ontworpen [SWS_DM_02376], [SWS_DM_02377], [SWS_DM_02378], [SWS_DM_02379], [SWS_DM_02380], [SWS_DM_02381].

Gebruikspad

Het typische gebruikspad treedt op bij ontvangst van een SOVD-schrijfverzoek voor een entiteits-databron [SWS_DM_01431]. Diagnostic Management maakt of gebruikt een instantie en stelt eerst met SetName de shortName van het betreffende DiagnosticSovdContentElement in [SWS_DM_02166], [SWS_DM_02378]. Vervolgens wordt de binnenkomende waarde aan de hand van de conversieregels getransformeerd AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 “SOVD Data – Conversion” en via SetContent toegewezen [SWS_DM_02166], [SWS_DM_02381]. De op deze wijze geaggregeerde data worden daarna doorgegeven aan GenericDiagnosticSovdContent::Write [SWS_DM_02166]. Afnemers kunnen de sleutelnaam via GetName opvragen [SWS_DM_02377] en de data-inhoud via de constante of niet-constante overload van GetContent inspecteren respectievelijk manipuleren [SWS_DM_02379], [SWS_DM_02380].

Sequentiediagram: Aanroep- en datastroom bij de verwerking van een SOVD-schrijfverzoek met gebruik van DiagnosticSovdContentElementDataWithKey. Bronnen: [SWS_DM_01431], [SWS_DM_02166], [SWS_DM_02378], [SWS_DM_02381].

Foutscenario's

In geval van fouten maakt de klasse geen gebruik van C++-exceptions en meldt mislukkingen in plaats daarvan via het retourtype ara::core::Result<void> van SetContent [SWS_DM_02381]. Mislukt het instellen van de inhoud – bijvoorbeeld wanneer het doorgegeven inhoudstype niet past bij de doelstructuur of ongeldig is –, dan wordt de foutcode DiagErrc::kInvalidArgument geretourneerd [SWS_DM_02381]. De aanroeper moet het geretourneerde resultaat controleren voordat het object aan GenericDiagnosticSovdContent::Write wordt overgedragen [SWS_DM_02166].