classe ara::shwa::ShwaErrorDomain

La classe ara::shwa::ShwaErrorDomain fournit le domaine d'erreur spécifique au module pour le module shwa et associe les codes d'erreur à des descriptions ainsi qu'aux types d'exceptions correspondants [AP_SWS_SHWA_01305]. En plus de l'interrogation textuelle des noms de domaine et des messages d'erreur, elle offre via ThrowAsException() la possibilité de lever délibérément des erreurs sous forme d'exceptions [AP_SWS_SHWA_01310]. Les méthodes d'inspection sont déclarées sûres pour les threads et sûres vis-à-vis des exceptions.

plus ›

Contexte

La classe ara::shwa::ShwaErrorDomain représente le domaine d'erreur spécifique au module shwa sur l'Adaptive Platform et dérive de la classe de base ara::core::ErrorDomain. Elle fait office de lien central pour l'identification univoque, le nommage et la description textuelle des causes d'erreurs spécifiques au module. Typiquement, le domaine d'erreur interagit étroitement avec des instances de ara::core::ErrorCode ainsi qu'avec la gestion des exceptions associée via ShwaException. Par le biais d'alias de types, la classe fournit une correspondance directe avec les types d'erreurs spécifiques au module : Errc renvoie à ShwaErrorCode [AP_SWS_SHWA_01305] et Exception à ShwaException [AP_SWS_SHWA_01306].

Diagramme de contexte : intégration de ShwaErrorDomain en interaction avec les codes d'erreur, les exceptions et la logique applicative. Sources : [AP_SWS_SHWA_01305], [AP_SWS_SHWA_01306], [AP_SWS_SHWA_01310]

Cycle de vie

L'instanciation de ShwaErrorDomain s'effectue via le constructeur par défaut ShwaErrorDomain(), qui est déclaré comme noexcept et garantit tant la sécurité des threads (Thread Safety) que la sécurité vis-à-vis des exceptions (Exception Safety) [AP_SWS_SHWA_01307]. En tant que représentant d'un domaine d'erreur dans le modèle de traitement des erreurs d'AUTOSAR Adaptive, une telle instance est habituellement conservée de manière durable (interprétation : probablement sous la forme d'un objet singleton statique ou global), afin de comparer de façon récurrente les contextes d'erreur. Question Q-82cb2e14793eeaef (ouverte) Hormis le déclenchement d'exceptions, toutes les méthodes de lecture de l'instance sont sûres pour les threads et ne lèvent aucune exception.

Parcours d'utilisation

Dans le flux de traitement standard, un composant génère un ara::core::ErrorCode en référence au domaine d'erreur lors de l'apparition d'une erreur spécifique au module. Pour la sortie de texte ou la journalisation, l'utilisateur appelle la méthode Name() afin de déterminer l'identifiant du domaine d'erreur [AP_SWS_SHWA_01308], ou obtient au moyen de Message(errorCode) la description d'erreur associée au code numérique [AP_SWS_SHWA_01309]. Si un code d'erreur doit être transféré dans le chemin des exceptions C++, la logique appelante déclenche ThrowAsException() [AP_SWS_SHWA_01310].

Diagramme de séquence : déroulement typique lors de l'interrogation d'erreur et de la conversion en exception. Sources : [AP_SWS_SHWA_01308], [AP_SWS_SHWA_01309], [AP_SWS_SHWA_01310]

Scénarios d'erreur

Les domaines d'erreur eux-mêmes servent à la classification des erreurs et sont conçus pour être largement tolérants aux pannes dans leurs fonctions d'inspection. Aussi bien Name() [AP_SWS_SHWA_01308] que Message() [AP_SWS_SHWA_01309] sont spécifiés noexcept et sûrs vis-à-vis des exceptions, de sorte qu'un pointeur défini vers une chaîne de caractères est renvoyé même en cas de codes d'erreur inconnus (interprétation : probablement un texte indicatif ou de substitution statique). Question Q-03a63539b08ddb73 (ouverte) L'unique scénario d'erreur déclenchant explicitement une exception est représenté par la méthode ThrowAsException(errorCode) [AP_SWS_SHWA_01310] : elle est déclarée avec noexcept(false) comme « not exception safe », car son objectif principal réside dans la levée ciblée d'une exception du type Exception (ShwaException) [AP_SWS_SHWA_01306].