class ara::diag::DiagOfferErrorDomain

Der parameterlose Standardkonstruktor [SWS_DM_00992] dient der Erzeugung einer Instanz der Klasse ara::diag::DiagOfferErrorDomain (SWS Diagnostics §8.11.5 „Class: DiagOfferErrorDomain“). Er ist über die Header-Datei ara/diag/diag_error_domain.h deklariert und besitzt die Signatur constexpr DiagOfferErrorDomain() noexcept; (SWS Diagnostics §8.11.5.2.1.1 „Default Constructor“). Der Aufruf erfolgt synchron, verarbeitet keine Eingabeparameter und liefert konstruktortypisch keinen Rückgabewert [SWS_DM_00992].

Hinsichtlich Nebenläufigkeit und Fehlersicherheit ist die Funktion als thread-safe sowie exception safe spezifiziert [SWS_DM_00992]. Durch die noexcept-Spezifikation ist garantiert, dass während der Ausführung keine Exceptions geworfen werden [SWS_DM_00992]. Spezifische Fehlercodes oder Benachrichtigungen über DET oder DEM sind für diesen Konstruktor nicht vorgesehen.

Im Modulkontext repräsentiert die Domäne Fehlerzustände rund um Diagnose-Dienste, deren Fehlercodes in der Enumeration DiagOfferErrc definiert sind [SWS_DM_00559] und über den Typalias Errc referenziert werden können [SWS_DM_00990]. Die Klasse stellt Standardmethoden wie Name() [SWS_DM_00993], Message() [SWS_DM_00994] und ThrowAsException() [SWS_DM_00995] bereit. In Anwendungsfällen dürfte ein direkter Aufruf des Konstruktors selten erforderlich sein (Interpretation), da mit der Funktion ara::diag::GetDiagOfferDomain() bereits eine globale Referenz auf die Instanz zur Verfügung steht [SWS_DM_01003], die unter anderem von ara::diag::MakeErrorCode() genutzt wird [SWS_DM_01005]. Frage Q-a98886da9b649096 (offen)

Die synchrone Elementfunktion Message der Klasse ara::diag::DiagOfferErrorDomain dient der Übersetzung eines numerischen Fehlercodes in eine beschreibende Textnachricht [SWS_DM_00994]. Entwickler binden die Schnittstelle über die Header-Datei ara/diag/diag_error_domain.h ein [SWS_DM_00994].

Für die Verwendung und den Aufrufkontext gelten folgende Vorgaben:

• Parameter und Rückgabewert: Der Funktion wird der abzufragende Fehlerwert als ara::core::ErrorDomain::CodeType errorCode übergeben. Sie gibt einen Zeiger auf eine konstante Zeichenkette (const char*) zurück, der laut Spezifikation niemals nullptr ist [SWS_DM_00994].
• Fehler- und Ausnahmesicherheit: Die Funktion ist als noexcept deklariert und als exception safe spezifiziert, sodass sie keine C++-Ausnahmen wirft [SWS_DM_00994]. Unbekannte oder ungültige Fehlercodes dürften auf vordefinierte Standardmeldungen abgebildet werden, um die Nullzeiger-Garantie einzuhalten. Frage Q-73eb1822df6a995d (offen)
• Nebenläufigkeit: Die Operation ist als const-Methode deklariert und explizit als thread-safe klassifiziert, wodurch nebenläufige Aufrufe aus mehreren Threads ohne externe Synchronisierung zulässig sind [SWS_DM_00994].

Die Methode überschreibt eine Basisschnittstelle und folgt dem einheitlichen Fehlermeldungsmuster des Diagnosemoduls, das analog auch in anderen Fehlerdomänen wie ara::diag::DiagErrorDomain [SWS_DM_00522], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00534], ara::diag::DiagReportingErrorDomain [SWS_DM_01001] und ara::diag::DiagSovdErrorDomain [SWS_DM_01814] verwendet wird.

Die Methode Name() der Klasse ara::diag::DiagOfferErrorDomain dient der synchronen Ermittlung des eindeutigen Kurznamens der Fehlerdomäne ([SWS_DM_00993]). Sie ist über die Header-Datei ara/diag/diag_error_domain.h verfügbar und überschreibt die Basismethode zur Domänenidentifikation im Adaptive-Framework ([SWS_DM_00993]).

Verwendung und Semantik:

• Aufrufkontext und Parameter: Der Aufruf erfolgt synchron, parameterlos und ohne Vorbedingungen direkt an der Instanz von ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]).
• Rückgabewert: Die Funktion liefert einen const char* zurück, der den Bezeichner ApApplicationErrorDomain.SN der Fehlerdomäne darstellt ([SWS_DM_00993]). Interpretation: Der zurückgegebene Zeiger dürfte auf eine unveränderliche, statische Zeichenkette verweisen, die über die gesamte Programmlaufzeit gültig bleibt. Frage Q-86836b3715182080 (offen)
• Fehlerbehandlung: Die Methode ist als noexcept deklariert und als exception safe spezifiziert ([SWS_DM_00993]). Sie meldet weder Fehlercodes noch wirft sie Ausnahmen.
• Nebenläufigkeit: Die Ausführung ist als thread-safe klassifiziert ([SWS_DM_00993]), sodass parallele Aufrufe aus mehreren Threads ohne externe Synchronisation zulässig sind.

Zusammenspiel: Das Verhalten entspricht dem allgemeinen Architekturmuster für Fehlerdomänen im Diagnostic Management. Identisch spezifizierte Name()-Methoden existieren für verwandte Domänen wie ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) sowie ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

Die Elementfunktion ThrowAsException der Fehlerdomäne ara::diag::DiagOfferErrorDomain dient gemäß [SWS_DM_00995] dazu, einen übergebenen Fehlercode des Typs ara::core::ErrorCode in eine entsprechende C++-Exception umzuwandeln und auszulösen (AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 „ThrowAsException“).

Hinsichtlich Semantik und Schnittstellengestaltung gelten folgende Eigenschaften:

• Aufruf und Parameter: Die Methode nimmt eine konstante Referenz auf eine Instanz von ara::core::ErrorCode entgegen, besitzt keinen Rückgabewert (void) und ist mit noexcept(false) deklariert, da sie definitionsgemäß eine Ausnahme wirft [SWS_DM_00995].
• Übersetzungsrestriktion: Gemäß [SWS_CORE_10304] nimmt die Funktion nicht an der Überladungsauflösung (Overload Resolution) teil, wenn C++-Exceptions in der Toolchain des Compilers deaktiviert sind [SWS_DM_00995].
• Sicherheit und Nebenläufigkeit: Die Funktion ist als thread-safe spezifiziert, wodurch parallele Aufrufe über Thread-Grenzen hinweg zulässig sind; sie ist jedoch explizit als not exception safe ausgewiesen [SWS_DM_00995].
• Zusammenspiel: Das Konzept entspricht dem standardisierten Fehlermodell für Diagnosefehlerdomänen, wie es analog auch in ara::diag::DiagErrorDomain [SWS_DM_00523], ara::diag::DiagReportingErrorDomain [SWS_DM_01002], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00535] sowie ara::diag::DiagSovdErrorDomain [SWS_DM_01815] implementiert ist. Eingebunden wird die Definition über die Header-Datei #include "ara/diag/diag_error_domain.h" [SWS_DM_00995].

Aufgrund der Einstufung als not exception safe dürfte beim Auslösevorgang im Systemkontext keine zusätzliche interne Fehlerabsicherung innerhalb der Methode greifen (Interpretation: Entwickler müssen Ausnahmen im aufrufenden Anwendungskontext abfangen). Frage Q-72152cb488c24026 (offen)