class ara::diag::DiagUdsNrcErrorDomain

Der parameterlose Standardkonstruktor initialisiert eine Instanz der Fehlerdomäne ara::diag::DiagUdsNrcErrorDomain synchron und ohne Übergabeparameter [SWS_DM_00532]. Durch die Qualifizierung als constexpr kann die Instanziierung bereits zur Kompilierzeit stattfinden AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.1.1 „Default Constructor“. In der praktischen Umsetzung dürfte eine direkte manuelle Instanziierung der Domänenklasse [SWS_DM_00529] durch Anwendungscode jedoch selten erforderlich sein, da standardmäßig die globale Referenz über die Funktion GetDiagUdsNrcDomain() [SWS_DM_00536] bezogen wird. Frage Q-22c33afd620b536e (offen)

Hinsichtlich Nebenläufigkeit und Exception-Sicherheit ist der Konstruktor als thread-safe und exception safe spezifiziert [SWS_DM_00532]. Er ist als noexcept deklariert und wirft selbst keinerlei Ausnahmen. Die Domäne verwaltet Fehlercodes des Enumerationstyps DiagUdsNrcErrc über den Alias Errc [SWS_DM_00530], welche mittels MakeErrorCode() [SWS_DM_00537] erzeugt werden. Zudem stellt die Klasse Methoden wie Name() [SWS_DM_00533], Message() [SWS_DM_00534] sowie ThrowAsException() [SWS_DM_00535] im Rahmen von DiagUdsNrcException [SWS_DM_00531] bereit.

Im Zusammenspiel mit dem Diagnostic Management steuern Fehler dieser Domäne die negative Antwortbehandlung. Gibt eine ara::diag-Schnittstelle einen Fehler der DiagUdsNrcErrorDomain zurück, leitet der Diagnostic Server daraus eine negative UDS-Antwort (NRC) mit dem Wert des Fehlercodes im gültigen Bereich von 0x01 bis 0xFE ab [SWS_DM_02059], [SWS_DM_02060]. Tritt ein solcher Fehler beim Abrufen eines Umgebungselements auf, wertet der Server die betreffende Bedingung als nicht erfüllt und setzt eine Log-and-Trace-Nachricht ab [SWS_DM_00970].

Verwendung

Die synchrone Elementfunktion Message der Klasse ara::diag::DiagUdsNrcErrorDomain wandelt einen numerischen Fehlercode in eine lesbare Zeichenkette um [SWS_DM_00534]. Als Parameter wird der Fehlerwert errorCode vom Typ ara::core::ErrorDomain::CodeType übergeben. Der Aufruf liefert einen konstanten Zeiger (const char *) auf die entsprechende Meldung zurück, wobei garantiert ist, dass der Rückgabewert niemals nullptr ist [SWS_DM_00534].

Fehlerbehandlung und Nebenläufigkeit

Die Methode ist als noexcept deklariert und gewährleistet vollständige Ausnahmesicherheit (exception safe) [SWS_DM_00534]. Es werden keine Exceptions ausgelöst. Selbst bei unbekannten oder ungültigen Werten für errorCode dürfte die Implementierung vermutlich eine statische Fallback-Nachricht liefern, da ein Nullzeiger explizit ausgeschlossen ist [SWS_DM_00534]. Frage Q-e9724baf4aedc3ff (offen) Zudem ist die Funktion als threadsicher (thread-safe) spezifiziert und kann ohne externe Synchronisation parallel aus mehreren Threads aufgerufen werden [SWS_DM_00534].

Zusammenspiel im Diagnostic Management

Innerhalb des Diagnostic Managements implementiert Message das standardisierte Überschreiben der Fehlermeldungsauflösung speziell für UDS Negative Response Codes (NRC) [SWS_DM_00534]. Sie korrespondiert mit gleichartigen Funktionen anderer Diagnose-Fehlerdomänen wie DiagErrorDomain [SWS_DM_00522], DiagOfferErrorDomain [SWS_DM_00994], DiagReportingErrorDomain [SWS_DM_01001] und DiagSovdErrorDomain [SWS_DM_01814].

Verwendung

Die Elementfunktion Name der Klasse ara::diag::DiagUdsNrcErrorDomain liefert den Kurznamen (ApApplicationErrorDomain.SN) dieser spezifischen Diagnose-Fehlerdomäne zurück [SWS_DM_00533]. Der Aufruf erfolgt synchron und ist über den Header ara/diag/diag_uds_nrc_error_domain.h deklariert. Die Methode nimmt keine Übergabeparameter entgegen und gibt einen Zeiger vom Typ const char * auf eine nullterminierte Zeichenkette zurück [SWS_DM_00533].

Fehlerbehandlung

Die Funktion ist als noexcept deklariert und besitzt die Eigenschaft exception safe [SWS_DM_00533]. Sie wirft keine Ausnahmen und gibt keine Fehlercodes zurück. Ein Fehlschlagen der Abfrage ist im Schnittstellendesign nicht vorgesehen, weshalb keine gesonderten Fehlermeldungen existieren.

Nebenläufigkeit und Einschränkungen

Gemäß Spezifikation ist Name als thread-safe eingestuft [SWS_DM_00533]. Sie kann reentrant und ohne externe Synchronisationsmechanismen parallel von mehreren Threads aufgerufen werden. Die referenzierte Zeichenkette dürfte statisch allozierte Daten darstellen, sodass der Zeiger über die gesamte Lebensdauer der Anwendung unverändert gültig bleiben dürfte. Frage Q-d4a4d28af7a9c2df (offen) Besondere Reihenfolgebedingungen für den Aufruf bestehen nicht.

Zusammenspiel

Die Operation implementiert die einheitliche Namensabfrage für AUTOSAR-Adaptive-Fehlerdomänen im Diagnosekontext. Sie entspricht strukturell den gleichnamigen Schnittstellen verwandter Fehlerdomänen wie ara::diag::DiagErrorDomain::Name [SWS_DM_00521], ara::diag::DiagOfferErrorDomain::Name [SWS_DM_00993], ara::diag::DiagReportingErrorDomain::Name [SWS_DM_01000] sowie ara::diag::DiagSovdErrorDomain::Name [SWS_DM_01813]. Sie dient vor allem dazu, Fehler aus dem UDS-NRC-Umfeld für Diagnoseclients oder Logging-Komponenten lesbar zu identifizieren.

Die Elementfunktion ara::diag::DiagUdsNrcErrorDomain::ThrowAsException dient dazu, einen Fehler aus der UDS-NRC-Fehlerdomäne synchron in eine C++-Exception zu überführen [SWS_DM_00535]. Als Parameter wird die Instanz errorCode vom Typ const ara::core::ErrorCode& übergeben. Die Funktion besitzt keinen Rückgabewert, sondern wirft direkt den dem Fehlercode zugeordneten Exception-Typ AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 „ThrowAsException“.

Hinsichtlich des Fehler- und Laufzeitverhaltens ist die Methode mit noexcept(false) deklariert und als nicht ausnahmesicher (not exception safe) klassifiziert, da das Auslösen der Exception ihre primäre Semantik darstellt [SWS_DM_00535]. Für den nebenläufigen Aufrufkontext ist die Funktion als threadsicher (thread-safe) spezifiziert [SWS_DM_00535].

Bei der Einbindung und Systemkonfiguration gelten folgende Bedingungen und Entwurfsbezüge:

• Compiler-Einschränkung: Sind C++-Exceptions im Compiler-Toolchain deaktiviert, nimmt diese Funktion gemäß [SWS_CORE_10304] nicht an der Überladungsauflösung (overload resolution) teil [SWS_DM_00535].
• Zusammenspiel mit Fehlerdomänen: Das identische Schema zur Exception-Auslösung wird einheitlich in weiteren diagnostischen Domänen umgesetzt, wie etwa in DiagErrorDomain [SWS_DM_00523], DiagOfferErrorDomain [SWS_DM_00995], DiagReportingErrorDomain [SWS_DM_01002] und DiagSovdErrorDomain [SWS_DM_01815].