classe ara::nm::NmException

La classe d'exception sert de type d'erreur standardisé pour les erreurs synchrones d'exécution et d'API au sein du cluster fonctionnel Network Management conformément à [SWS_ANM_01100]. Les instances encapsulent la cause sous-jacente de l'erreur et sont créées par le passage d'un code d'erreur spécifique [SWS_ANM_01102]. Grâce à la spécialisation de l'exception de base générale, le type permet une gestion ciblée des exceptions lors des échecs d'opérations de gestion de réseau. En tant que contrainte essentielle, le constructeur garantit une sécurité totale du multithreading et le respect de la garantie nothrow pendant la création de l'objet.

plus ›

Contexte

La classe ara::nm::NmException agit au sein du cluster fonctionnel Network Management (ara::nm) comme type d'exception central pour le signalement des erreurs au niveau de l'API [SWS_ANM_01100]. Elle est déclarée dans le fichier d'en-tête ara/nm/nm_error_domain.h et hérite publiquement de la classe de base générale ara::core::Exception [SWS_ANM_01100]. Dans l'architecture de l'AUTOSAR Adaptive Platform, elle établit ainsi une passerelle entre les états d'erreur spécifiques au module de la gestion de réseau et le mécanisme C++ standardisé de gestion des exceptions de l'infrastructure de base.

Les partenaires d'interaction sont les interfaces d'API du Network Management ainsi que les composants applicatifs qui sollicitent les services de ce cluster. Si un état d'erreur grave ou à traiter de manière synchrone survient lors de l'exécution d'une telle interface, l'objet d'exception encapsule cette erreur afin de la transmettre aux appelants de niveau supérieur [SWS_ANM_01100]. Grâce à la hiérarchie d'héritage, NmException s'intègre parfaitement dans les routines générales de traitement des exceptions et peut être interceptée aussi bien de manière spécifique au module que de manière polymorphe via des références à ara::core::Exception.

Cycle de vie

Le cycle de vie d'une instance de ara::nm::NmException débute avec son instanciation explicite via le constructeur, auquel un code d'erreur du type ara::core::ErrorCode est transmis [SWS_ANM_01102]. En marquant le constructeur avec le mot-clé explicit, la spécification empêche les conversions de type implicites à partir de codes d'erreur, ce qui impose une création d'objet délibérée et correcte du point de vue des types [SWS_ANM_01102].

En matière de concurrence, la construction de l'exception est spécifiée comme étant sûre pour les threads (thread-safe) [SWS_ANM_01102]. Une instanciation peut ainsi s'effectuer en toute sécurité et en parallèle sur différents threads, sans que les composants appelants aient à mettre en place des mécanismes de synchronisation externes. De plus, le constructeur est déclaré avec noexcept [SWS_ANM_01102], ce qui garantit formellement qu'aucune autre exception ne peut être levée lors de la création même de l'objet.

Après sa création, l'instance est acheminée vers le gestionnaire d'exceptions compétent via le mécanisme de pile de C++. La destruction s'effectue automatiquement lors de la sortie du bloc catch associé, conformément aux règles standard du langage de programmation C++ relatives aux objets d'exception.

Parcours d'utilisation

Le chemin d'utilisation régulier comprend la survenue d'une erreur lors de l'interaction avec l'API de Network Management, la création de l'objet d'exception ainsi que son évaluation ultérieure par l'application. Vraisemblablement, l'exception est surtout levée lorsque des appels synchrones échouent ou que des erreurs issues de valeurs de retour sont explicitement déballées sous forme d'exception. Question Q-636ec24993a10a5b (ouverte)

Diagramme de séquence : déroulement typique de la gestion des erreurs via une exception lors d'appels de l'API de Network Management. Sources : [SWS_ANM_01100], [SWS_ANM_01102]

Le déroulement typique se divise selon les étapes suivantes :

• Appel de l'opération d'API : l'application appelle une fonction du Network Management.
• Détection de l'erreur et construction : si l'implémentation de l'API constate une condition d'erreur, elle crée une instance de NmException en transmettant le code d'erreur spécifique [SWS_ANM_01102].
• Déclenchement de l'exception : l'exception est levée (throw), ce qui interrompt le flux de contrôle normal [SWS_ANM_01100].
• Interception et traitement de l'erreur : l'application intercepte l'exception par référence en tant que const ara::nm::NmException& et engage les mesures appropriées de récupération ou de journalisation.

Scénarios d'erreur

En tant que classe d'exception, ara::nm::NmException constitue l'outil de représentation des erreurs et n'est pas elle-même soumise à des scénarios d'erreur complexes en cours de fonctionnement [SWS_ANM_01100]. La précondition essentielle à la création consiste en la fourniture d'un objet ara::core::ErrorCode initialisé [SWS_ANM_01102]. Ce code d'erreur devrait représenter le domaine d'erreur et l'identificateur numérique du problème spécifique de NM. Question (ouverte)

Le constructeur étant déclaré comme noexcept, un échec lors de la création de l'objet d'exception est exclu [SWS_ANM_01102]. Le scénario d'erreur principal au niveau du système réside dans l'omission d'une gestion appropriée des exceptions : si une NmException levée reste non interceptée, cela entraîne l'appel de std::terminate et par conséquent l'interruption incontrôlée du processus. Les applications doivent donc s'assurer que les sections de code appelantes sont protégées par des blocs de traitement appropriés.