classe ara::rds::RdsException

La classe ara::rds::RdsException représente le type d’exception spécialisé pour le module Raw Data Stream et sert à propager les erreurs sur la base de ara::core::ErrorCode [SWS_RDS_11292]. L’instanciation s’effectue généralement dans le cadre du traitement des erreurs par ThrowAsException, ce qui déclenche une interruption structurée du déroulement défaillant [SWS_RDS_11297]. Grâce au constructeur déclaré comme noexcept, il est garanti qu’aucune erreur consécutive ne survient dans le système d’exécution lors de la création de l’exception. Le code applicatif appelant doit intercepter l’exception afin d’éviter l’arrêt du programme.

plus ›

Contexte

Dans le contexte d’AUTOSAR Adaptive, la classe ara::rds::RdsException fait office de type d’exception dédié pour le Raw Data Stream (rds), comme spécifié dans SWS RawDataStream §1 « Raw Data Stream ». Elle dérive directement de la classe de base générale ara::core::Exception et intègre de manière transparente le modèle d’erreur du module dans le traitement des exceptions de la plateforme. Au sein de l’espace de noms RDS, le type est mis à disposition via l’alias de type Exception [SWS_RDS_11327], ce qui offre aux utilisateurs et aux composants du module une nomenclature uniforme et simplifiée. Les principaux partenaires d’interaction sont les domaines d’erreur, tels que le domaine déclaré dans ara/rds/rds_error_domain.h, ainsi que le code applicatif qui traite les erreurs au moyen d’exceptions [SWS_RDS_11292].

Cycle de vie

Les instances de ara::rds::RdsException sont créées à la demande dès qu’un événement d’erreur survenu impose l’interruption du flux de contrôle régulier. L’instanciation s’effectue par le biais d’un constructeur explicite qui accepte un objet ara::core::ErrorCode [SWS_RDS_11292]. Ce constructeur est déclaré comme noexcept, garantissant ainsi que la création de l’objet elle-même n’échoue en aucune circonstance et ne déclenche aucune exception supplémentaire. L’objet exception est soumis à la sémantique de valeur standard du C++ : il est transmis dans la mémoire d’exception de l’environnement d’exécution lors de son émission. Comme d’usage pour les types d’exception dans ara::core, le moment de destruction devrait être lié à la sortie du bloc catch compétent, dès que la référence à l’objet exception disparaît. Question Q-5673ede6a9688b85 (ouverte) Dans les environnements d’exécution concurrents, la classe se comporte de manière sûre pour les threads (thread-safe), car chaque situation d’exception est instanciée et propagée de façon isolée au niveau local du thread.

Parcours d'utilisation

Le chemin d’utilisation typique comprend la détection d’un état d’erreur dans le fonctionnement du flux, la conversion du code d’erreur en une exception et son interception en aval dans le code applicatif. Si une erreur survient au cours d’une opération, elle est principalement représentée sous la forme d’un ara::core::ErrorCode. Au lieu d’une interrogation manuelle, le déclenchement de l’exception peut être amorcé via la méthode ThrowAsException, qui encapsule la conversion ainsi que le processus de déclenchement [SWS_RDS_11297]. Interprétation : l’appel de ThrowAsException délègue probablement en interne directement au constructeur de RdsException et lève la nouvelle instance créée au moyen de throw [SWS_RDS_11292]. Question Q-d8734426a5c71e07 (ouverte) Le code appelant intercepte l’exception via le type concret ara::rds::RdsException, l’alias ara::rds::Exception [SWS_RDS_11327] ou de manière polymorphique via ara::core::Exception.

Diagramme de séquence : interaction lors du déclenchement et de l’interception d’une exception RDS via un ErrorCode. Sources : [SWS_RDS_11292], [SWS_RDS_11297].

Scénarios d'erreur

Les scénarios d’erreur autour de ara::rds::RdsException concernent avant tout la cohérence de la propagation des erreurs et la prévention des interruptions non traitées du programme. L’opération de déclenchement ThrowAsException est explicitement définie comme noexcept(false) [SWS_RDS_11297], car la levée de l’exception constitue le comportement attendu en cas d’erreur. Un scénario d’erreur critique se produit lorsque le code appelant ignore l’interruption potentielle du flux de contrôle et ne fournit aucun gestionnaire d’exceptions adapté ; un traitement incomplet entraîne l’interruption immédiate du processus via std::terminate. La garantie noexcept du constructeur [SWS_RDS_11292] assure néanmoins qu’aucune erreur d’initialisation imbriquée ne peut survenir lors de la mise à disposition de l’exception elle-même.