class ara::idsm::IdsmException

Die Klasse ara::idsm::IdsmException dient als standardisierte C++-Ausnahmeklasse zur Repräsentation von Fehlern der IdsM-Programmierschnittstellen [SWS_AIDSM_10704]. Sie leitet von ara::core::Exception ab und kapselt einen spezifischen Fehlercode zur Ursachenanalyse. Die Instanziierung erfolgt über einen expliziten Konstruktor mit einem ara::core::ErrorCode, der threadsicher und als noexcept garantiert ist [SWS_AIDSM_10705]. Damit ermöglicht die Klasse eine deterministische und sichere Ausnahmebehandlung in fehlgeschlagenen IdsM-Abläufen.

mehr ›

Kontext

Die Klasse ara::idsm::IdsmException fungiert als dedizierte Exception-Klasse zur Signalisierung und Behandlung von Fehlern der Programmierschnittstellen des Intrusion Detection System Managers (IdsM) [SWS_AIDSM_10704]. Sie ist im Header ara/idsm/idsm_error_domain.h definiert und leitet öffentlich von der Basisklasse ara::core::Exception ab [SWS_AIDSM_10704]. Innerhalb der AUTOSAR Adaptive Platform interagiert die Klasse primär mit anwendenden Funktionsclustern sowie den Schnittstellen des IdsM-Moduls. Sie bietet Entwicklern einen standardisierten C++-Ausnahmemechanismus, um Fehlerzustände strukturiert abzufangen, anstatt Fehlermeldungen ausschließlich über Rückgabewerte zu propagieren.

Lebenszyklus

Die Instanziierung von ara::idsm::IdsmException erfolgt über einen expliziten Konstruktor, der die Übergabe eines ara::core::ErrorCode verlangt [SWS_AIDSM_10705]. Dieser Konstruktor ist mit dem Spezifizierer noexcept deklariert, wodurch garantiert ist, dass während der Konstruktion des Ausnahmeobjekts keine weiteren Ausnahmen ausgelöst werden [SWS_AIDSM_10705]. Hinsichtlich der Nebenläufigkeit ist die Konstruktion ausdrücklich als threadsicher (thread-safe) spezifiziert [SWS_AIDSM_10705], sodass Ausnahmeobjekte auch in multithreaded Ausführungskontexten ohne zusätzliche Synchronisation sicher instanziiert werden können.

Als Ausnahmeobjekt unterliegt IdsmException der typischen C++-Wertsemantik. Die Erzeugung findet unmittelbar beim Erkennen einer Fehlbedingung oder beim Auspacken eines fehlerhaften Operationsergebnisses statt. Die Lebensdauer ist an die Auswertung im zugehörigen catch-Block gekoppelt; nach dessen Beendigung wird das Ausnahmeobjekt durch das Laufzeitsystem automatisch zerstört.

Nutzungspfad

Der typische Einsatz der Klasse erfolgt im Rahmen synchroner IdsM-Dienstaufrufe. Eine Anwendung ruft eine Funktion des Moduls idsm auf. Stellt die IdsM-Laufzeitumgebung eine ungültige Operation oder einen internen Fehler fest, erzeugt sie einen entsprechenden ara::core::ErrorCode und instanziiert damit eine ara::idsm::IdsmException [SWS_AIDSM_10705]. Diese Ausnahme wird ausgelöst und unterbricht den regulären Kontrollfluss [SWS_AIDSM_10704].

Die aufrufende Anwendung fängt das Objekt spezifisch als ara::idsm::IdsmException oder allgemein als ara::core::Exception ab. Im Ausnahme-Handler kann der gekapselte Fehlercode extrahiert und für Diagnoselogging, Fallback-Strategien oder deterministische Wiederanläufe ausgewertet werden.

Sequenzdiagramm: Typischer Ablauf der Fehlerbehandlung mit IdsmException bei einem API-Aufruf. Quellen: [SWS_AIDSM_10704], [SWS_AIDSM_10705]

Fehlerszenarien

Die Klasse ara::idsm::IdsmException dient der Repräsentation von IdsM-API-Fehlern und kommt dann zum Einsatz, wenn Funktionsaufrufe fehlschlagen und dieser Zustand über den Exception-Pfad gemeldet wird [SWS_AIDSM_10704]. Wesentliche Vorbedingung für die Erzeugung ist das Vorliegen eines gültigen ara::core::ErrorCode-Objekts, welches die Fehlerursache präzise beschreibt [SWS_AIDSM_10705].

Ein sekundärer Fehlerzustand während der Objekterzeugung ist durch die noexcept-Zusicherung des Konstruktors ausgeschlossen [SWS_AIDSM_10705]. Dadurch wird vermieden, dass in bereits kritischen Fehlerbehandlungspfaden ein unerwarteter Programmabbruch über std::terminate provoziert wird. Nachbedingung des Konstruktoraufrufs ist ein initialisiertes Ausnahmeobjekt, das den Fehlercode unverändert für die weitere Diagnose bereithält.