classe ara::idsm::IdsmException

La classe ara::idsm::IdsmException sert de classe d'exception C++ standardisée pour représenter les erreurs des interfaces de programmation de l'IdsM [SWS_AIDSM_10704]. Elle dérive de ara::core::Exception et encapsule un code d'erreur spécifique pour l'analyse des causes. L'instanciation s'effectue via un constructeur explicite avec un ara::core::ErrorCode, qui est thread-safe et garanti en tant que noexcept [SWS_AIDSM_10705]. La classe permet ainsi une gestion déterministe et sûre des exceptions lors de déroulements IdsM en échec.

plus ›

Contexte

La classe ara::idsm::IdsmException sert de classe d'exception dédiée pour signaler et traiter les erreurs des interfaces de programmation de l'Intrusion Detection System Manager (IdsM) [SWS_AIDSM_10704]. Elle est définie dans l'en-tête ara/idsm/idsm_error_domain.h et hérite publiquement de la classe de base ara::core::Exception [SWS_AIDSM_10704]. Au sein de l'AUTOSAR Adaptive Platform, la classe interagit principalement avec les clusters fonctionnels utilisateurs ainsi qu'avec les interfaces du module IdsM. Elle offre aux développeurs un mécanisme d'exception C++ standardisé afin d'intercepter les états d'erreur de manière structurée, plutôt que de propager les messages d'erreur exclusivement par le biais de valeurs de retour.

Cycle de vie

L'instanciation de ara::idsm::IdsmException s'effectue via un constructeur explicite qui requiert le passage d'un ara::core::ErrorCode [SWS_AIDSM_10705]. Ce constructeur est déclaré avec le spécificateur noexcept, ce qui garantit qu'aucune autre exception n'est levée pendant la construction de l'objet d'exception [SWS_AIDSM_10705]. En matière de concurrence, la construction est expressément spécifiée comme étant sûre pour les threads (thread-safe) [SWS_AIDSM_10705], de sorte que les objets d'exception peuvent être instanciés en toute sécurité, sans synchronisation supplémentaire, même dans des contextes d'exécution multithread.

En tant qu'objet d'exception, IdsmException est soumis à la sémantique de valeur typique du C++. La création a lieu immédiatement lors de la détection d'une condition d'erreur ou du déballage d'un résultat d'opération en échec. La durée de vie est liée à l'évaluation dans le bloc catch associé ; après la fin de celui-ci, l'objet d'exception est automatiquement détruit par le système d'exécution.

Parcours d'utilisation

L'utilisation typique de la classe intervient dans le cadre d'appels de service synchrones de l'IdsM. Une application appelle une fonction du module idsm. Si l'environnement d'exécution de l'IdsM constate une opération invalide ou une erreur interne, il génère un ara::core::ErrorCode correspondant et instancie ainsi une ara::idsm::IdsmException [SWS_AIDSM_10705]. Cette exception est levée et interrompt le flux de contrôle normal [SWS_AIDSM_10704].

L'application appelante intercepte l'objet spécifiquement en tant que ara::idsm::IdsmException ou de manière générique en tant que ara::core::Exception. Dans le gestionnaire d'exceptions, le code d'erreur encapsulé peut être extrait et évalué pour la journalisation de diagnostic, les stratégies de repli ou les redémarrages déterministes.

Diagramme de séquence : déroulement typique de la gestion des erreurs avec IdsmException lors d'un appel d'API. Sources : [SWS_AIDSM_10704], [SWS_AIDSM_10705]

Scénarios d'erreur

La classe ara::idsm::IdsmException sert à représenter les erreurs de l'API de l'IdsM et intervient lorsque des appels de fonction échouent et que cet état est signalé via le chemin d'exception [SWS_AIDSM_10704]. La précondition essentielle à la création est la présence d'un objet ara::core::ErrorCode valide, qui décrit précisément la cause de l'erreur [SWS_AIDSM_10705].

Un état d'erreur secondaire lors de la création de l'objet est exclu grâce à la garantie noexcept du constructeur [SWS_AIDSM_10705]. Cela évite de provoquer un arrêt inattendu du programme via std::terminate dans des chemins de traitement d'erreurs déjà critiques. La postcondition de l'appel du constructeur est un objet d'exception initialisé qui conserve le code d'erreur sans modification pour le diagnostic ultérieur.