klasse ara::nm::NmErrorDomain

Het foutdomein ara::nm::NmErrorDomain kapselt de foutafhandeling van Network Management in het AUTOSAR Adaptive Platform in en bindt de foutcodes NmErrc evenals de exceptieklasse NmException in [SWS_ANM_01101]. Tot de hoofdtaken behoren het beschikbaar stellen van leesbare foutmeldingen via Message() en het gecontroleerd werpen van toegewezen excepties via ThrowAsException() [SWS_ANM_01108]. Als centrale randvoorwaarde zijn de instantiëring en alle memberfuncties thread-safe (thread-safe) geïmplementeerd, waardoor een gelijktijdige foutopvraag in het gehele systeem is gewaarborgd.

meer ›

Context

De klasse ara::nm::NmErrorDomain fungeert binnen het AUTOSAR Adaptive Platform als domeinspecifiek foutdomein voor het subsysteem van Network Management [SWS_ANM_01101]. Als finale specialisatie van de basisklasse ara::core::ErrorDomain biedt zij het gestandaardiseerde kader voor de identificatie, tekstuele beschrijving en doorgifte van fouten die kunnen optreden tijdens de werking van Network Management-functies [SWS_ANM_01101].

Binnen het NM-foutafhandelingsconcept koppelt de klasse concrete foutoorzaken aan de algemene foutafhandelingsmechanismen van de runtime-omgeving. Hierbij definieert de klasse via type-aliassen een directe toewijzing aan de relevante typen: via de alias Errc bindt zij de onderliggende enumeratie NmErrc in, die de specifieke foutcodes voor Network Management declareert [SWS_ANM_01103]. Tegelijkertijd verwijst zij via de alias Exception naar de gespecialiseerde exceptieklasse NmException, waardoor fouten desgewenst naar het C++-exceptiemechanisme kunnen worden overgedragen [SWS_ANM_01104]. Door deze bundeling dient NmErrorDomain als centrale schakel tussen de fouttoestanden van de module en het foutspecifieke basissysteem van ara::core.

Levenscyclus

Het aanmaken van een instantie van ara::nm::NmErrorDomain vindt plaats via de parameterloze standaardconstructor [SWS_ANM_01105]. Omdat de klasse als final is gespecificeerd, wordt verdere onderverdeling of specialisatie door afgeleide foutdomeinen expliciet verhinderd [SWS_ANM_01101]. De constructor is gedeclareerd met noexcept, waarmee gegarandeerd is dat de instantiëring van het foutdomein plaatsvindt zonder het werpen van excepties [SWS_ANM_01105].

Wat betreft de eigendomsverhoudingen bevindt een instantie van dit foutdomein zich typisch als langlevend globaal object in het geheugen, om via referenties in foutcode-objecten permanent beschikbaar te zijn. Vraag Q-27fedf008cefcdc7 (open) Een wezenlijk kenmerk in de levenscyclus is het gedrag bij gelijktijdigheid: zowel de constructie van de instantie [SWS_ANM_01105] als alle interfacefuncties zoals het opvragen van namen [SWS_ANM_01106], het genereren van meldingen [SWS_ANM_01107] en het werpen van excepties [SWS_ANM_01108] zijn volledig thread-safe (thread-safe) ontworpen. Omdat instanties van NmErrorDomain geen veranderlijke toestand bevatten, kunnen ze zonder aanvullende synchronisatiemaatregelen gelijktijdig vanuit meerdere threads worden gebruikt.

Gebruikspad

Het reguliere gebruikspad vangt aan zodra in Network Management een fouttoestand moet worden geanalyseerd, gelogd of in een exceptie moet worden omgezet. Het foutdomein stelt hiervoor de fundamentele identificatie- en evaluatiefuncties ter beschikking.

Voor de algemene identificatie van het domein kan de methode Name() worden aangeroepen, die de naam van het domein als constante tekenreekspointer retourneert [SWS_ANM_01106]. Wanneer een applicatie of een basissysteem de tekstuele betekenis van een opgetreden foutcode wil bepalen, wordt de methode Message() onder doorgifte van de foutcode aangeroepen [SWS_ANM_01107]. Deze methode retourneert de bijbehorende foutmelding als const char* en garandeert door haar noexcept-declaratie dat het diagnoseproces zelf exception-safe blijft [SWS_ANM_01107].

Vereist de control flow het werpen van een systeemspecifieke exceptie, dan wordt de methode ThrowAsException() gebruikt [SWS_ANM_01108]. Deze functie neemt een foutobject van het type ara::core::ErrorCode in ontvangst en werpt de bijpassende exception van het type NmException [SWS_ANM_01104], [SWS_ANM_01108]. De aanroep zal in de praktijk primair indirect via overeenkomstige hulpmethoden van foutobjecten plaatsvinden. Vraag Q-70e50ac95d89f400 (open)

Sequentiediagram: omzetting van een Network Management-foutcode in een typespecifieke NmException via het foutdomein. Bronnen: [SWS_ANM_01104], [SWS_ANM_01108].

Foutscenario's

In het kader van de foutafhandeling dekt het domein alle foutgevallen van de module af die door het enumeratietype NmErrc via de alias Errc worden gedefinieerd [SWS_ANM_01103]. Het domein zelf is erop ontworpen de evaluatie van fouten deterministisch te borgen.

Bij het bepalen van tekstmeldingen via Message() waarborgt de declaratie als noexcept dat zelfs bij ongeldige foutcodes geen onvoorziene excepties worden geworpen [SWS_ANM_01107]. Het enige voorziene scenario waarin de klasse actief een exceptie genereert, is de expliciete aanroep van ThrowAsException() [SWS_ANM_01108]. Via de declaratie noexcept(false) signaleert de methode dat zij het programma dwingend naar een exceptie-afhandelingspad leidt door een instantie van NmException te werpen [SWS_ANM_01104], [SWS_ANM_01108]. Aanroepende componenten moeten daarom waarborgen dat dergelijke aanroepen desgewenst door passende exceptieblokken worden opgevangen.