class ara::shwa::ShwaException

Die Klasse ara::shwa::ShwaException leitet von ara::core::Exception ab und dient im Modul shwa der Signalisierung von Fehlersituationen über den C++-Ausnahmemechanismus. Bei der Instanziierung übernimmt der explizite Konstruktor einen ara::core::ErrorCode, der die Fehlerursache kapselt und zur Diagnose im Fangblock bereitstellt [AP_SWS_SHWA_01303]. Die Erzeugung ist gemäß [AP_SWS_SHWA_01303] als noexcept, ausnahmesicher und threadsicher spezifiziert. Interpretation: Aufrufer sollten die Ausnahme strukturiert abfangen und den Fehlercode auswerten, um unbehandelte Prozessabbrüche zu vermeiden. Frage (offen)

mehr ›

Kontext

Die Klasse ara::shwa::ShwaException stellt im Modul shwa der AUTOSAR Adaptive Platform die spezialisierte Ausnahmeklasse zur Signalisierung modulspezifischer Fehlersituationen dar. Der Typ leitet laut Klassensyntax öffentlich von ara::core::Exception ab und fügt sich damit in die einheitliche Ausnahmehierarchie der Adaptive Platform ein. In der Systemarchitektur fungiert die Klasse als Brücke zwischen den internen Komponenten des Moduls shwa und den aufrufenden Anwendungsschichten. Ihr primärer Zweck ist der Transport eines ara::core::ErrorCode über den C++-Ausnahmemechanismus, wie durch die Konstruktordeklaration nach [AP_SWS_SHWA_01303] belegt ist. Anwendungscode dürfte die Klasse als Fangtyp einsetzen, um Fehler aus dem Modul shwa gezielt von generischen Plattformausnahmen zu unterscheiden. Frage Q-c74c928a939e73ad (offen)

Lebenszyklus

Der Lebenszyklus einer Instanz von ara::shwa::ShwaException beginnt mit ihrer Erzeugung im Kontext einer Fehlererkennung. Gemäß [AP_SWS_SHWA_01303] erfolgt die Erzeugung über den Konstruktor explicit ShwaException(ara::core::ErrorCode errorCode) noexcept. Die Initialisierung bindet den übergebenen Fehlercode direkt an das Ausnahmeobjekt. Die Spezifikation sichert für diese Deklaration vollständige Ausnahmesicherheit (exception safe) sowie Threadsicherheit (thread-safe) zu [AP_SWS_SHWA_01303]. Da der Konstruktor als noexcept deklariert ist, kann die Objekterzeugung selbst garantiert keine Sekundärausnahmen auslösen.

Nach dem Erzeugen wird das Objekt über eine throw-Anweisung an das C++-Laufzeitsystem übergeben. Das Laufzeitsystem übernimmt die Verwaltung während des Stack-Unwindings, bis das Objekt in einem kompatiblen catch-Block gebunden wird. Nach dem Verlassen des Ausnahmeblocks endet die Lebensdauer und das Objekt wird automatisch zerstört. Da die Erzeugung threadsicher spezifiziert ist [AP_SWS_SHWA_01303], können mehrere Ausführungsthreads unabhängig voneinander Instanzen erzeugen und werfen.

Nutzungspfad

Ein typischer Nutzungspfad beginnt mit dem Aufruf einer Funktion des Moduls shwa durch eine Anwendung. Schlägt die Operation fehl und sieht die modulspezifische Semantik eine Ausnahme vor, instanziiert die ausführende Komponente ara::shwa::ShwaException unter Übergabe des zutreffenden ara::core::ErrorCode [AP_SWS_SHWA_01303]. Anschließend wird die Ausnahme ausgelöst.

Der aufrufende Anwendungscode fängt die Ausnahme entweder als ara::shwa::ShwaException oder über die Basisklasse ara::core::Exception ab. Im Fangblock kann der gekapselte Fehlercode ausgelesen werden, um die Ursache zu analysieren, Protokolleinträge zu verfassen oder Wiederherstellungsmaßnahmen einzuleiten. Der nachfolgende Ablauf veranschaulicht diesen Pfad.

Sequenzdiagramm: Typischer Ablauf der Ausnahmeerzeugung und -behandlung bei Funktionsaufrufen im Modul shwa. Quellen: [AP_SWS_SHWA_01303]

Fehlerszenarien

Als Ausnahmeklasse dient ara::shwa::ShwaException selbst der Signalisierung von Fehlerszenarien. Die Konstruktion verlangt als einzige Vorbedingung die Übergabe eines ara::core::ErrorCode [AP_SWS_SHWA_01303]. Durch die Kennzeichnung des Konstruktors mit explicit werden unbeabsichtigte implizite Typkonvertierungen zur Übersetzungszeit verhindert.

Fehlerzustände während der Konstruktion der Ausnahme sind ausgeschlossen, da der Konstruktor nach [AP_SWS_SHWA_01303] mit noexcept deklariert ist. Die Instanziierung ist somit robust und führt nicht zu Allokationsfehlern oder Laufzeitabbrüchen. Ein kritisches Fehlerszenario entsteht auf Systemebene erst dann, wenn eine geworfene Ausnahme vom aufrufenden Kontext nicht abgefangen wird: Dies führt über den Standardmechanismus von C++ zu einem Aufruf von std::terminate. Interpretation: Aufrufer sollten den Ausnahmebereich absichern und den Fehlercode behandeln, um die Prozessstabilität zu gewährleisten. Frage Q-0b08103bdf1368b7 (offen)