klasse ara::idsm::IdsmException

De klasse ara::idsm::IdsmException dient als gestandaardiseerde C++-exceptieklasse voor de representatie van fouten in de IdsM-programmeerinterfaces [SWS_AIDSM_10704]. Deze leidt af van ara::core::Exception en kapselt een specifieke foutcode in voor oorzakenanalyse. De instantiëring vindt plaats via een expliciete constructor met een ara::core::ErrorCode, die thread-safe is en gegarandeerd als noexcept [SWS_AIDSM_10705]. Daarmee maakt de klasse een deterministische en veilige exceptieafhandeling in mislukte IdsM-processen mogelijk.

meer ›

Context

De klasse ara::idsm::IdsmException fungeert als speciale exceptieklasse voor het signaleren en afhandelen van fouten van de programmeerinterfaces van de Intrusion Detection System Manager (IdsM) [SWS_AIDSM_10704]. Deze is gedefinieerd in header ara/idsm/idsm_error_domain.h en leidt publiek af van de basisklasse ara::core::Exception [SWS_AIDSM_10704]. Binnen het AUTOSAR Adaptive Platform interacteert de klasse primair met aanroepende functieclusters en de interfaces van de IdsM-module. Deze biedt ontwikkelaars een gestandaardiseerd C++-exceptiemechanisme om fouttoestanden gestructureerd op te vangen, in plaats van foutmeldingen uitsluitend via retourwaarden te propageren.

Levenscyclus

De instantiëring van ara::idsm::IdsmException vindt plaats via een expliciete constructor die de doorgifte van een ara::core::ErrorCode vereist [SWS_AIDSM_10705]. Deze constructor is gedeclareerd met de specificator noexcept, waardoor gegarandeerd is dat tijdens de constructie van het exceptie-object geen verdere excepties worden opgeworpen [SWS_AIDSM_10705]. Wat betreft gelijktijdigheid is de constructie uitdrukkelijk gespecificeerd als thread-safe [SWS_AIDSM_10705], zodat exceptie-objecten ook in multithreaded uitvoeringscontexten veilig kunnen worden geïnstantieerd zonder extra synchronisatie.

Als exceptie-object is IdsmException onderworpen aan de typische C++-waardesemantiek. De creatie vindt direct plaats bij het detecteren van een foutconditie of bij het uitpakken van een foutief operatieresultaat. De levensduur is gekoppeld aan de evaluatie in het bijbehorende catch-blok; na afloop daarvan wordt het exceptie-object automatisch vernietigd door het runtimesysteem.

Gebruikspad

Het typische gebruik van de klasse vindt plaats in het kader van synchrone IdsM-service-aanroepen. Een applicatie roept een functie van de module idsm aan. Als de IdsM-runtime-omgeving een ongeldige operatie of een interne fout vaststelt, genereert deze een overeenkomstige ara::core::ErrorCode en instantieert daarmee een ara::idsm::IdsmException [SWS_AIDSM_10705]. Deze exceptie wordt opgeworpen en onderbreekt de reguliere control flow [SWS_AIDSM_10704].

De aanroepende applicatie vangt het object specifiek op als ara::idsm::IdsmException of algemeen als ara::core::Exception. In de exception handler kan de ingekapselde foutcode worden geëxtraheerd en geëvalueerd voor diagnoselogging, fallback-strategieën of deterministische herstarts.

Sequentiediagram: typisch verloop van de foutafhandeling met IdsmException bij een API-aanroep. Bronnen: [SWS_AIDSM_10704], [SWS_AIDSM_10705]

Foutscenario's

De klasse ara::idsm::IdsmException dient voor de representatie van IdsM-API-fouten en wordt gebruikt wanneer functie-aanroepen mislukken en deze toestand via het exceptiepad wordt gemeld [SWS_AIDSM_10704]. Een essentiële voorwaarde voor de creatie is de aanwezigheid van een geldig ara::core::ErrorCode-object, dat de foutoorzaak nauwkeurig beschrijft [SWS_AIDSM_10705].

Een secundaire fouttoestand tijdens de objectcreatie is uitgesloten door de noexcept-garantie van de constructor [SWS_AIDSM_10705]. Daardoor wordt voorkomen dat in reeds kritieke foutafhandelingspaden een onverwachte programmabeëindiging via std::terminate wordt geprovoceerd. Nawaarde van de constructor-aanroep is een geïnitialiseerd exceptie-object dat de foutcode ongewijzigd beschikbaar houdt voor verdere diagnose.