klasse ara::nm::NmException

De exceptieklasse dient als gestandaardiseerd fouttype voor synchrone runtime- en API-fouten binnen het Network Management-functiecluster conform [SWS_ANM_01100]. Instanties kapselen de onderliggende foutoorzaak in en worden gecreëerd door doorgifte van een specifieke foutcode [SWS_ANM_01102]. Door specialisatie van de algemene basisexceptie maakt het type een gerichte exceptieafhandeling mogelijk bij mislukkende operaties van het netwerkbeheer. Als essentiële randvoorwaarde garandeert de constructor volledige thread-safety en naleving van de no-throw-garantie tijdens objectcreatie.

meer ›

Context

De klasse ara::nm::NmException fungeert binnen het functiecluster Network Management (ara::nm) als centraal exceptietype voor het signaleren van fouten op API-niveau [SWS_ANM_01100]. Deze is gedeclareerd in het headerbestand ara/nm/nm_error_domain.h en leidt publiek af van de algemene basisklasse ara::core::Exception [SWS_ANM_01100]. In de architectuur van het AUTOSAR Adaptive Platform slaat deze daarmee een brug tussen de modulespecifieke fouttoestanden van het netwerkbeheer en het gestandaardiseerde C++-exceptiemechanisme van de basisinfrastructuur.

Als interactiepartners treden de API-interfaces van Network Management op, evenals applicatiespecifieke componenten die gebruikmaken van diensten van dit cluster. Doet zich bij de uitvoering van een dergelijke interface een ernstige of synchroon af te handelen fouttoestand voor, dan kapselt het exceptie-object deze fout in voor doorgifte aan bovenliggende aanroepers [SWS_ANM_01100]. Door de overervingshiërarchie past NmException naadloos in algemene exceptieafhandelingsroutines en kan zowel modulespecifiek als polymorf via referenties naar ara::core::Exception worden opgevangen.

Levenscyclus

De levenscyclus van een instantie van ara::nm::NmException begint met de expliciete instantiëring via de constructor, waaraan een foutcode van het type ara::core::ErrorCode wordt doorgegeven [SWS_ANM_01102]. Door aanduiding van de constructor met het sleutelwoord explicit sluit de specificatie impliciete typeconversies vanuit foutcodes uit, waarmee een bewuste en typecorrecte objectcreatie wordt afgedwongen [SWS_ANM_01102].

Wat betreft gelijktijdigheid is de constructie van de exceptie gespecificeerd als thread-safe (thread-safe) [SWS_ANM_01102]. Een instantiëring kan zodoende veilig parallel op verschillende threads plaatsvinden, zonder dat aanroepende componenten externe synchronisatiemechanismen hoeven in te richten. Aanvullend is de constructor gedeclareerd met noexcept [SWS_ANM_01102], wat formeel garandeert dat bij de objectcreatie zelf geen verdere excepties kunnen worden opgeworpen.

Na creatie wordt de instantie via het C++-stackmechanisme getransporteerd naar de verantwoordelijke exception handler. De vernietiging vindt automatisch plaats bij het verlaten van het bijbehorende catch-blok volgens de standaardregels van de programmeertaal C++ voor exceptie-objecten.

Gebruikspad

Het reguliere gebruikstraject omvat het optreden van een fout bij de interactie met de Network Management-API, de creatie van het exceptie-object en de aansluitende evaluatie daarvan door de applicatie. Vermoedelijk wordt de exceptie vooral dan opgeworpen wanneer synchrone aanroepen mislukken of fouten uit retourwaarden expliciet als exceptie worden uitgepakt. Vraag Q-636ec24993a10a5b (open)

Sequentiediagram: typisch verloop van de foutafhandeling via een exceptie bij aanroepen van de Network Management-API. Bronnen: [SWS_ANM_01100], [SWS_ANM_01102]

Het typische verloop is onderverdeeld in de volgende stappen:

• Aanroep van de API-operatie: de applicatie roept een functie van Network Management aan.
• Foutdetectie en constructie: als de API-implementatie een foutconditie vaststelt, creëert deze een instantie van NmException onder doorgifte van de specifieke foutcode [SWS_ANM_01102].
• Opwerpen van de exceptie: de exceptie wordt opgeworpen (throw), waardoor de normale control flow wordt onderbroken [SWS_ANM_01100].
• Opvangen en foutafhandeling: de applicatie vangt de exceptie per referentie op als const ara::nm::NmException& en start passende maatregelen voor herstel of protocollering.

Foutscenario's

Als uitzonderingsklasse vormt ara::nm::NmException het hulpmiddel voor foutweergave en is zelf niet onderhevig aan complexe foutscenario's tijdens het bedrijf [SWS_ANM_01100]. De essentiële voorwaarde voor het aanmaken bestaat uit het beschikbaar stellen van een geïnitialiseerd ara::core::ErrorCode-object [SWS_ANM_01102]. Deze foutcode geeft vermoedelijk het foutdomein en de numerieke identificator van het specifieke NM-probleem weer. Vraag (open)

Aangezien de constructor als noexcept is gedeclareerd, is een mislukking bij het aanmaken van het uitzonderingsobject uitgesloten [SWS_ANM_01102]. Het primaire foutscenario op systeemniveau ligt in het achterwege laten van een passende uitzonderingsafhandeling: blijft een geworpen NmException ongevangen, dan leidt dit tot de aanroep van std::terminate en daarmee tot het ongecontroleerd afbreken van het proces. Applicaties moeten daarom waarborgen dat aanroepende codesecties met passende afhandelingsblokken zijn beveiligd.