classe ara::fw::FwException

La classe ara::fw::FwException représente le type d'exception C++ spécialisé pour l'API de Firewall de l'AUTOSAR Adaptive Platform et dérive de ara::core::Exception. Elle sert à encapsuler et à transporter un ara::core::ErrorCode afin de transmettre des états d'erreur graves aux composants appelants [AP_SWS_Fw_83005]. L'instanciation s'effectue via l'en-tête ara/fw/fw_error_domain.h au moyen d'un constructeur explicite déclaré comme noexcept [AP_SWS_Fw_83005]. En tant que contrainte centrale, la classe garantit une construction thread-safe, de sorte que les erreurs puissent être signalées de manière fiable, même dans des contextes d'exécution concurrents.

plus ›

Contexte

La classe ara::fw::FwException constitue le type d'exception C++ dédié pour l'interface de Firewall (Firewall API) de l'AUTOSAR Adaptive Platform. Conformément à la définition de son interface, elle hérite publiquement de la classe de base ara::core::Exception. Au sein de l'architecture du module fw, elle sert à encapsuler des situations d'erreur survenant pendant l'exécution sous forme d'exception et à les propager à travers les limites d'appel vers des couches fonctionnelles supérieures. La classe et son constructeur sont déclarés via l'en-tête ara/fw/fw_error_domain.h [AP_SWS_Fw_83005]. Le type ara::core::ErrorCode, qui modélise le contexte d'erreur concret et le domaine d'erreur du Firewall, fait office d'interlocuteur central.

Cycle de vie

Le cycle de vie d'une instance de ara::fw::FwException débute par l'initialisation explicite par passage d'un objet ara::core::ErrorCode au constructeur [AP_SWS_Fw_83005]. Le constructeur étant déclaré comme explicit, les conversions de type implicites à partir de codes d'erreur sont empêchées [AP_SWS_Fw_83005]. La désignation par noexcept garantit que la création de l'objet d'exception lui-même n'échoue à aucun moment et ne déclenche pas d'exceptions secondaires [AP_SWS_Fw_83005]. De plus, le standard spécifie expressément la construction comme thread-safe (thread-safe) [AP_SWS_Fw_83005], ce qui autorise la création d'instances d'exception même dans des contextes d'exécution concurrents de l'application Adaptive sans synchronisation supplémentaire. La destruction de l'objet intervient automatiquement à la fin du bloc de traitement respectif après l'interception de l'exception, conformément aux règles standard du C++.

Parcours d'utilisation

Un chemin d'utilisation typique décrit la détection d'une erreur interne au sein de l'API de Firewall, l'encapsulation de la cause et le traitement consécutif au niveau applicatif. Adaptive AUTOSAR reposant principalement sur une gestion des erreurs basée sur des valeurs via des objets de résultat, ara::fw::FwException ne devrait vraisemblablement être levée que lorsqu'une situation d'exception grave est présente ou lorsque des API sont sollicitées sur la base d'exceptions. Question Q-4a8d1c1d5359c469 (ouverte)

Diagramme de séquence : Déroulement typique du traitement des erreurs et de la gestion des exceptions avec FwException. Sources : [AP_SWS_Fw_83005] AP_SWS_Fw_83005

Le déroulement typique s'effectue selon les étapes suivantes :

• Détection de l'erreur : Un service de l'API de Firewall identifie une opération non valide et génère un objet ara::core::ErrorCode correspondant.
• Création de l'exception : Via le constructeur [AP_SWS_Fw_83005], une nouvelle instance de ara::fw::FwException est instanciée de manière thread-safe avec ce code d'erreur.
• Déclenchement de l'exception : L'exception est signalée dans le contexte d'exécution au moyen de throw.
• Interception et évaluation : L'application appelante intercepte ara::fw::FwException et lit le code d'erreur contenu pour analyse de l'erreur ou récupération.

Scénarios d'erreur

Les scénarios d'erreur lors de l'utilisation de ara::fw::FwException concernent principalement la validité logique des données d'erreur transmises et l'absence d'un traitement approprié des exceptions. La construction de la classe d'exception étant spécifiée comme noexcept, il n'existe aucune source d'erreur interne pendant l'instanciation elle-même [AP_SWS_Fw_83005]. En tant que précondition, l'entité appelante doit s'assurer de passer un ara::core::ErrorCode sémantiquement pertinent, décrivant adéquatement la cause de l'erreur de Firewall survenue [AP_SWS_Fw_83005]. Dans la mesure où une ara::fw::FwException levée n'est interceptée par aucun gestionnaire approprié plus haut dans la pile d'appels, cela conduit inévitablement, selon la sémantique standard du C++, à l'appel de std::terminate et donc à l'interruption du processus.