class ara::diag::DiagnosticSovdContentElementDataWithKey

Die Klasse dient der Kapselung eines SOVD-Diagnoseinhaltselements zusammen mit einem eindeutigen Schlüsselbezeichner [SWS_DM_02375]. Sie wird vom Diagnostic Management bei Schreibzugriffen nach ASAM SOVD befüllt und an GenericDiagnosticSovdContent::Write weitergereicht [SWS_DM_02166]. Alle Elementfunktionen sind threadsicher und exceptionsicher spezifiziert, wobei fehlerhafte Zuweisungen über ara::core::Result mit DiagErrc::kInvalidArgument gemeldet werden [SWS_DM_02381].

mehr ›

Kontext

Die Klasse ara::diag::DiagnosticSovdContentElementDataWithKey dient innerhalb der Adaptive Platform als Datenkapsel für ein einzelnes Diagnose-Inhaltselement im Kontext von ASAM SOVD (Service-Oriented Vehicle Diagnostics) und ordnet einem Nutzdatenobjekt einen eindeutigen Schlüsselbezeichner zu [SWS_DM_02375]. SOVD-Daten werden über das Modellelement DiagnosticSovdContent strukturiert, welches sich aus mindestens einem DiagnosticSovdContentElement zusammensetzt AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 „SOVD Data – Conversion“. Während Leseabfragen über GenericDiagnosticSovdContent::Read abgewickelt werden [SWS_DM_01432], interagiert die Klasse primär mit dem Diagnostic Management (DM) und der Serviceschnittstelle GenericDiagnosticSovdContent::Write, um strukturierte Schreibzugriffe auf Datenressourcen auszuführen [SWS_DM_01431], [SWS_DM_02166].

Lebenszyklus

Die Instanziierung und Zerstörung von ara::diag::DiagnosticSovdContentElementDataWithKey erfolgt unter Einhaltung des RAII-Prinzips. Der Destruktor sowie die zugehörigen Kopier- und Verschiebeoperationen (Move-/Copy-Konstruktoren und Zuweisungsoperatoren) sind explizit als noexcept deklariert [SWS_DM_02376]. Bezüglich des Besitzverhältnisses übernimmt die Klasse den Nutzdateninhalt per Wertübergabe in SetContent [SWS_DM_02381], während der Schlüsselname als ara::core::StringView übergeben wird [SWS_DM_02378]. Das Diagnostic Management dürfte intern sicherstellen, dass die zugrunde liegende Zeichenkette während des Zugriffs gültig bleibt oder in internen Speicher kopiert wird. Frage Q-f00f62f43629a773 (offen) Alle Elementfunktionen der Klasse sind laut Spezifikation threadsicher und exceptionsicher ausgelegt [SWS_DM_02376], [SWS_DM_02377], [SWS_DM_02378], [SWS_DM_02379], [SWS_DM_02380], [SWS_DM_02381].

Nutzungspfad

Der typische Nutzungspfad tritt beim Empfang einer SOVD-Schreibanforderung für eine Entitäts-Datenressource auf [SWS_DM_01431]. Das Diagnostic Management erzeugt oder nutzt eine Instanz und setzt zunächst mit SetName den shortName des jeweiligen DiagnosticSovdContentElement [SWS_DM_02166], [SWS_DM_02378]. Anschließend wird der eingehende Wert anhand der Konvertierungsregeln transformiert AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 „SOVD Data – Conversion“ und über SetContent zugewiesen [SWS_DM_02166], [SWS_DM_02381]. Die auf diese Weise aggregierten Daten werden danach an GenericDiagnosticSovdContent::Write weitergereicht [SWS_DM_02166]. Konsumenten können den Schlüsselnamen über GetName abfragen [SWS_DM_02377] und den Dateninhalt über die konstante oder nicht-konstante Überladung von GetContent inspizieren bzw. manipulieren [SWS_DM_02379], [SWS_DM_02380].

Sequenzdiagramm: Aufruf- und Datenfluss bei der Verarbeitung einer SOVD-Schreibanforderung unter Verwendung von DiagnosticSovdContentElementDataWithKey. Quellen: [SWS_DM_01431], [SWS_DM_02166], [SWS_DM_02378], [SWS_DM_02381].

Fehlerszenarien

Im Fehlerfall verzichtet die Klasse auf C++-Exceptions und meldet Fehlschläge stattdessen über den Rückgabetyp ara::core::Result<void> von SetContent [SWS_DM_02381]. Schlägt das Setzen des Inhalts fehl – beispielsweise wenn der übergebene Inhaltstyp nicht zur Zielstruktur passt oder ungültig ist –, wird der Fehlercode DiagErrc::kInvalidArgument zurückgegeben [SWS_DM_02381]. Der Aufrufer muss das zurückgegebene Ergebnis prüfen, bevor das Objekt an GenericDiagnosticSovdContent::Write übergeben wird [SWS_DM_02166].