klasse ara::fw::FwException

De klasse ara::fw::FwException vertegenwoordigt het gespecialiseerde C++-exceptietype voor de Firewall-API van het AUTOSAR Adaptive Platform en erft over van ara::core::Exception. Deze dient voor het inkapselen en transporteren van een ara::core::ErrorCode, om ernstige fouttoestanden over te brengen naar aanroepende componenten [AP_SWS_Fw_83005]. De instantiëring vindt plaats via de header ara/fw/fw_error_domain.h door middel van een expliciete, als noexcept gedeclareerde constructor [AP_SWS_Fw_83005]. Als centrale randvoorwaarde waarborgt de klasse een thread-veilige constructie, zodat fouten ook in gelijktijdige uitvoeringscontexten betrouwbaar gesignaleerd kunnen worden.

meer ›

Context

De klasse ara::fw::FwException vormt het specifieke C++-exceptietype voor de Firewall-interface (Firewall API) van het AUTOSAR Adaptive Platform. Conform de interfacedefinitie erft deze publiek over van de basisklasse ara::core::Exception. Binnen de architectuur van de module fw dient deze ertoe om tijdens de uitvoering optredende foutsituaties in de vorm van een exceptie in te kapselen en over aanroepgrenzen heen door te geven aan bovenliggende functielagen. De klasse en de bijbehorende constructor worden gedeclareerd via de header ara/fw/fw_error_domain.h [AP_SWS_Fw_83005]. Als centrale interactiepartner fungeert het type ara::core::ErrorCode, dat de concrete foutcontext en het foutdomein van de Firewall afbeeldt.

Levenscyclus

De levenscyclus van een instantie van ara::fw::FwException begint met de expliciete initialisatie door overdracht van een ara::core::ErrorCode-object aan de constructor [AP_SWS_Fw_83005]. Omdat de constructor is gedeclareerd als explicit, worden impliciete typeconversies vanuit foutcodes voorkomen [AP_SWS_Fw_83005]. Door de markering met noexcept is gegarandeerd dat het aanmaken van het exceptie-object zelf op geen enkel moment mislukt of secundaire excepties veroorzaakt [AP_SWS_Fw_83005]. Bovendien specificeert de standaard de constructie uitdrukkelijk als thread-veilig (thread-safe) [AP_SWS_Fw_83005], waardoor exceptie-instanties ook in gelijktijdige uitvoeringscontexten van de Adaptive-applicatie zonder aanvullende synchronisatie mogen worden aangemaakt. De vernietiging van het object vindt automatisch plaats aan het einde van het desbetreffende behandelblok na het opvangen van de exceptie volgens de standaard C++-regels.

Gebruikspad

Een typisch gebruikspad beschrijft het detecteren van een interne fout binnen de Firewall-API, het inkapselen van de oorzaak en de daaropvolgende afhandeling op toepassingsniveau. Aangezien Adaptive AUTOSAR primair inzet op waarde-gebaseerde foutafhandeling via resultaatobjecten, zal ara::fw::FwException vermoedelijk vooral worden geworpen wanneer er sprake is van een ernstig uitzonderingsgeval of wanneer API's op basis van excepties worden aangesproken. Vraag Q-4a8d1c1d5359c469 (open)

Sequentiediagram: Typisch verloop van de foutafhandeling en exceptieafhandeling met FwException. Bronnen: [AP_SWS_Fw_83005] AP_SWS_Fw_83005

Het typische verloop voltrekt zich in de volgende stappen:

• Detectie van de fout: Een service van de Firewall-API identificeert een ongeldige operatie en genereert een bijbehorend ara::core::ErrorCode-object.
• Aanmaken van de exceptie: Via de constructor [AP_SWS_Fw_83005] wordt een nieuwe instantie van ara::fw::FwException thread-veilig geïnstantieerd met deze foutcode.
• Activeren van de exceptie: De exceptie wordt door middel van throw gesignaleerd in de uitvoeringscontext.
• Opvangen en evalueren: De aanroepende applicatie vangt ara::fw::FwException op en leest de ingesloten foutcode uit voor foutanalyse of herstel.

Foutscenario's

Foutscenario's bij het gebruik van ara::fw::FwException betreffen voornamelijk de logische geldigheid van de overgedragen foutgegevens en het uitblijven van een correcte exceptieafhandeling. Aangezien de constructie van de exceptieklasse is gespecificeerd als noexcept, bestaan er geen interne foutbronnen tijdens de instantiëring zelf [AP_SWS_Fw_83005]. Als voorwaarde moet de aanroepende partij waarborgen dat er een semantisch correcte ara::core::ErrorCode wordt overgedragen, die de opgetreden Firewall-foutoorzaak adequaat beschrijft [AP_SWS_Fw_83005]. Voor zover een geworpen ara::fw::FwException in de verdere callstack door geen enkele passende handler wordt opgevangen, leidt dit volgens standaard C++-semantiek onvermijdelijk tot de aanroep van std::terminate en daarmee tot beëindiging van het proces.