class ara::diag::DiagErrorDomain

Der Standardkonstruktor DiagErrorDomain() initialisiert eine Instanz der diagnostischen Fehlerdomäne ara::diag::DiagErrorDomain ([SWS_DM_00520], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.1.1 „Default Constructor“). Er ist als constexpr und noexcept deklariert, nimmt keine Parameter entgegen und liefert keinen Rückgabewert ([SWS_DM_00520]). Der Aufruf erfolgt synchron und kann sowohl zur Übersetzungszeit als auch zur Laufzeit ausgeführt werden.

Hinsichtlich Ausführungssicherheit und Nebenläufigkeit gelten folgende Eigenschaften:

• Fehler- und Ausnahmesicherheit: Die Funktion ist als exception safe spezifiziert und kann aufgrund von noexcept keine Exceptions auslösen ([SWS_DM_00520]). Spezifische Fehlercodes oder Meldungen an DET oder DEM sind für die Konstruktion nicht definiert.
• Thread-Sicherheit: Die Instanziierung ist als thread-safe eingestuft ([SWS_DM_00520]) und unterliegt keinen Einschränkungen bezüglich des Aufrufkontexts.

Im Zusammenspiel mit dem Modul Diagnostics repräsentiert die Klasse DiagErrorDomain ([SWS_DM_00517], AUTOSAR_AP_SWS_Diagnostics §8.11.3 „Class: DiagErrorDomain“) die Domäne diagnostischer Fehler. Sie stellt zentrale Typaliase wie Errc ([SWS_DM_00518]) und Exception ([SWS_DM_00519]) bereit. Instanzen der Domäne bieten zudem Methoden zur Namensabfrage ([SWS_DM_00521]), zur Übersetzung von Fehlercodes in Meldungstexte via Message() ([SWS_DM_00522]) sowie zur Auslösung domänenspezifischer Ausnahmen über ThrowAsException() ([SWS_DM_00523]).

In der praktischen Anwendung dürfte eine direkte manuelle Instanziierung über diesen Konstruktor selten erforderlich sein (Interpretation), da mit der Funktion ara::diag::GetDiagDomain() ([SWS_DM_00524]) bereits eine globale Instanzreferenz zur Verfügung steht, die unter anderem von ara::diag::MakeErrorCode() ([SWS_DM_00525]) zur Erzeugung von Fehlercodes verwendet wird. Frage Q-95d533b0920260e0 (offen)

Die Methode Message der Klasse ara::diag::DiagErrorDomain dient der synchronen Übersetzung eines numerischen Fehlercodes in eine lesbare Textnachricht ([SWS_DM_00522]). Sie überschreibt die Basisfunktion des Fehlerdomänen-Konzepts und wird über den Header ara/diag/diag_error_domain.h bereitgestellt ([SWS_DM_00522]).

Aufrufkontext und Semantik

Als Eingabeparameter erwartet die Funktion errorCode vom Typ ara::core::ErrorDomain::CodeType ([SWS_DM_00522]). Der Rückgabewert ist ein Zeiger vom Typ const char * auf die entsprechende Fehlermeldung ([SWS_DM_00522]). Die Spezifikation garantiert verbindlich, dass dieser Rückgabewert niemals nullptr ist ([SWS_DM_00522]). Interpretation: Die gelieferte Zeichenkette dürfte auf statische Zeichenkettenliterale verweisen, da die Schnittstelle keine dynamische Speicherfreigabe vorsieht und nicht fehlschlagen darf. Frage Q-a54b3a5f746357a8 (offen)

Fehlerbehandlung und Nebenläufigkeit

Für die Ausführung gelten strenge Zusicherungen hinsichtlich Robustheit und Nebenläufigkeit:

• Ausnahmesicherheit: Die Operation ist als noexcept deklariert und als vollständig ausnahmesicher (exception safe) spezifiziert ([SWS_DM_00522]). Sie löst im Fehlerfall keine C++-Exceptions aus.
• Thread-Sicherheit: Die Funktion ist explizit als thread-safe eingestuft ([SWS_DM_00522]). Sie kann daher ohne externe Synchronisationsmechanismen sicher von mehreren Threads parallel aufgerufen werden.

Zusammenspiel im Diagnosemodul

Die Funktion ist Teil der einheitlichen Fehlerberichterstattung im AUTOSAR Adaptive Diagnostic Management. Identische Übersetzungsfunktionen existieren für weitere fachspezifische Domänen des Moduls:

• ara::diag::DiagUdsNrcErrorDomain::Message zur Textauflösung von UDS-NRCs ([SWS_DM_00534]),
• ara::diag::DiagOfferErrorDomain::Message zur Beschreibung von Fehlern bei Diagnoseangeboten ([SWS_DM_00994]),
• ara::diag::DiagReportingErrorDomain::Message zur Auflösung von Reporting-Fehlercodes ([SWS_DM_01001]),
• ara::diag::DiagSovdErrorDomain::Message für SOVD-spezifische Fehlercodes ([SWS_DM_01814]).

Die Methode ara::diag::DiagErrorDomain::Name dient der standardisierten Abfrage des Bezeichners der Diagnose-Fehlerdomäne ([SWS_DM_00521]). Sie wird über den Header ara/diag/diag_error_domain.h bereitgestellt und liefert synchron den Kurznamen ApApplicationErrorDomain.SN als nullterminierten C-String vom Typ const char * zurück ([SWS_DM_00521]). Der Aufruf erfolgt ohne Übergabeparameter. Interpretation: Der zurückgegebene Zeiger dürfte auf ein statisch persistiertes Zeichenketten-Literal verweisen, da die Spezifikation keine Freigabemechanismen vorsieht. Frage Q-1ca098627210deb0 (offen)

In Bezug auf die Fehlerbehandlung ist die Funktion als noexcept deklariert sowie als ausnahmesicher (exception safe) spezifiziert ([SWS_DM_00521]). Es werden weder Fehlercodes noch Exceptions gemeldet; ein Aufruf führt stets zu einem gültigen Ergebnis.

Hinsichtlich Nebenläufigkeit und Randbedingungen ist die Methode als thread-safe definiert ([SWS_DM_00521]). Da sie zustandslos und als const qualifiziert ist, arbeitet sie reentrant und kann ohne externe Synchronisation nebenläufig aus beliebigen Threads ausgeführt werden.

Im architektonischen Zusammenspiel reiht sich die Funktion in das Diagnose-Management ein (AUTOSAR_AP_SWS_Diagnostics S. 68). Gleichartige Name-Methoden zur Domänen-Identifikation existieren für die verwandten Klassen ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) und ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

Die Elementfunktion ThrowAsException der Klasse ara::diag::DiagErrorDomain dient dem synchronen Auslösen einer C++-Exception auf Basis eines übergebenen Fehlercodes ([SWS_DM_00523], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 „ThrowAsException“). Die Methode erwartet als Eingabeparameter eine konstante Referenz auf eine Instanz von ara::core::ErrorCode und besitzt keinen Rückgabewert ([SWS_DM_00523]). Da der primäre Zweck im Werfen einer Ausnahme besteht, ist die Operation mit noexcept(false) sowie als nicht ausnahmesicher (not exception safe) deklariert ([SWS_DM_00523]).

Hinsichtlich der Nebenläufigkeit ist die Methode als threadsicher (thread-safe) spezifiziert und kann somit ohne zusätzliche Synchronisation aus mehreren Ausführungskontexten heraus aufgerufen werden ([SWS_DM_00523]). Eine wesentliche Randbedingung betrifft Umgebungen ohne Exception-Unterstützung: Gemäß [SWS_CORE_10304] nimmt die Funktion nicht an der Überladungsauflösung teil, wenn C++-Exceptions in der verwendeten Compiler-Toolchain deaktiviert sind ([SWS_DM_00523]).

Dieses funktionale Schema wird konsistent über verschiedene Fehlerdomänen des Diagnosemoduls hinweg angewendet. Analoge Implementierungen von ThrowAsException finden sich unter anderem in ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 „ThrowAsException“), ara::diag::DiagOfferErrorDomain ([SWS_DM_00995]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01002]) sowie ara::diag::DiagSovdErrorDomain ([SWS_DM_01815]). Interpretation: Durch die Spezifikation mit override dürfte die Methode eine gemeinsame Schnittstellenoperation zur polymorphen Ausnahmebehandlung abbilden. Frage Q-9c1e35e079af639d (offen)