classe ara::diag::DiagErrorDomain

Le constructeur par défaut DiagErrorDomain() initialise une instance du domaine d'erreurs de diagnostic ara::diag::DiagErrorDomain ([SWS_DM_00520], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.1.1 « Default Constructor »). Il est déclaré comme constexpr et noexcept, ne prend aucun paramètre et ne fournit aucune valeur de retour ([SWS_DM_00520]). L'appel s'effectue de manière synchrone et peut être exécuté aussi bien au moment de la compilation qu'à l'exécution.

Concernant la sûreté d'exécution et la concurrence, les propriétés suivantes s'appliquent :

• Sûreté face aux erreurs et aux exceptions : la fonction est spécifiée comme exception safe et ne peut pas lever d'exceptions en raison de noexcept ([SWS_DM_00520]). Aucun code d'erreur spécifique ni message à destination de DET ou DEM n'est défini pour la construction.
• Sûreté des threads : l'instanciation est classée comme thread-safe ([SWS_DM_00520]) et n'est soumise à aucune restriction relative au contexte d'appel.

En interaction avec le module Diagnostics, la classe DiagErrorDomain ([SWS_DM_00517], AUTOSAR_AP_SWS_Diagnostics §8.11.3 « Class: DiagErrorDomain ») représente le domaine des erreurs de diagnostic. Elle met à disposition des alias de types centraux tels que Errc ([SWS_DM_00518]) et Exception ([SWS_DM_00519]). Les instances du domaine proposent en outre des méthodes pour interroger le nom ([SWS_DM_00521]), pour traduire des codes d'erreur en messages textuels via Message() ([SWS_DM_00522]) ainsi que pour lever des exceptions spécifiques au domaine via ThrowAsException() ([SWS_DM_00523]).

En pratique, une instanciation manuelle directe via ce constructeur devrait rarement être requise (interprétation), car une référence d'instance globale est déjà disponible grâce à la fonction ara::diag::GetDiagDomain() ([SWS_DM_00524]), celle-ci étant notamment utilisée par ara::diag::MakeErrorCode() ([SWS_DM_00525]) pour générer des codes d'erreur. Question Q-95d533b0920260e0 (ouverte)

La méthode Message de la classe ara::diag::DiagErrorDomain sert à la traduction synchrone d'un code d'erreur numérique en un message textuel lisible ([SWS_DM_00522]). Elle surcharge la fonction de base du concept de domaine d'erreur et est fournie via l'en-tête ara/diag/diag_error_domain.h ([SWS_DM_00522]).

Contexte d'appel et sémantique

Comme paramètre d'entrée, la fonction attend errorCode de type ara::core::ErrorDomain::CodeType ([SWS_DM_00522]). La valeur de retour est un pointeur de type const char * vers le message d'erreur correspondant ([SWS_DM_00522]). La spécification garantit de manière contraignante que cette valeur de retour n'est jamais nullptr ([SWS_DM_00522]). Interprétation : la chaîne de caractères fournie devrait pointer vers des littéraux de chaîne statiques, car l'interface ne prévoit aucune libération dynamique de mémoire et ne doit pas échouer. Question Q-a54b3a5f746357a8 (ouverte)

Gestion des erreurs et concurrence

Des garanties strictes en matière de robustesse et de concurrence s'appliquent à l'exécution :

• Sécurité vis-à-vis des exceptions : l'opération est déclarée comme noexcept et spécifiée comme totalement sûre vis-à-vis des exceptions (exception safe) ([SWS_DM_00522]). Elle ne déclenche aucune exception C++ en cas d'erreur.
• Sécurité des threads : la fonction est explicitement classée comme thread-safe ([SWS_DM_00522]). Elle peut donc être appelée en toute sécurité par plusieurs threads en parallèle, sans mécanismes de synchronisation externes.

Interaction au sein du module de diagnostic

La fonction fait partie de la notification d'erreurs unifiée dans AUTOSAR Adaptive Diagnostic Management. Des fonctions de traduction identiques existent pour d'autres domaines spécifiques du module :

• ara::diag::DiagUdsNrcErrorDomain::Message pour la résolution textuelle des NRC UDS ([SWS_DM_00534]),
• ara::diag::DiagOfferErrorDomain::Message pour la description des erreurs relatives aux offres de diagnostic ([SWS_DM_00994]),
• ara::diag::DiagReportingErrorDomain::Message pour la résolution des codes d'erreur de reporting ([SWS_DM_01001]),
• ara::diag::DiagSovdErrorDomain::Message pour les codes d'erreur spécifiques à SOVD ([SWS_DM_01814]).

La méthode ara::diag::DiagErrorDomain::Name sert à interroger de manière standardisée l'identifiant du domaine d'erreur de diagnostic ([SWS_DM_00521]). Elle est fournie via l'en-tête ara/diag/diag_error_domain.h et renvoie de manière synchrone le nom court ApApplicationErrorDomain.SN sous la forme d'une chaîne C terminée par zéro de type const char * ([SWS_DM_00521]). L'appel s'effectue sans paramètre d'entrée. Interprétation : le pointeur renvoyé devrait pointer vers un littéral de chaîne de caractères persisté statiquement, car la spécification ne prévoit aucun mécanisme de libération. Question Q-1ca098627210deb0 (ouverte)

En ce qui concerne le traitement des erreurs, la fonction est déclarée comme noexcept et spécifiée comme sûre vis-à-vis des exceptions (exception safe) ([SWS_DM_00521]). Aucun code d'erreur ni aucune exception ne sont signalés ; un appel aboutit toujours à un résultat valide.

Concernant la concurrence et les contraintes, la méthode est définie comme thread-safe ([SWS_DM_00521]). Étant sans état et qualifiée de const, elle fonctionne de manière réentrante et peut être exécutée de manière concurrente depuis n'importe quel thread sans synchronisation externe.

Dans l'interaction architecturale, la fonction s'intègre dans le Diagnostic Management (AUTOSAR_AP_SWS_Diagnostics p. 68). Des méthodes Name similaires pour l'identification de domaine existent pour les classes associées ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) et ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

La fonction membre ThrowAsException de la classe ara::diag::DiagErrorDomain sert à lever de manière synchrone une exception C++ sur la base d'un code d'erreur transmis ([SWS_DM_00523], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 « ThrowAsException »). La méthode attend comme paramètre d'entrée une référence constante vers une instance de ara::core::ErrorCode et ne possède aucune valeur de retour ([SWS_DM_00523]). Étant donné que le but principal consiste à lever une exception, l'opération est déclarée avec noexcept(false) ainsi que comme non sûre vis-à-vis des exceptions (not exception safe) ([SWS_DM_00523]).

Concernant la concurrence, la méthode est spécifiée comme thread-safe (thread-safe) et peut donc être appelée depuis plusieurs contextes d'exécution sans synchronisation supplémentaire ([SWS_DM_00523]). Une contrainte essentielle concerne les environnements sans prise en charge des exceptions : conformément à [SWS_CORE_10304], la fonction ne participe pas à la résolution de surcharge lorsque les exceptions C++ sont désactivées dans la chaîne d'outils du compilateur utilisée ([SWS_DM_00523]).

Ce schéma fonctionnel est appliqué de manière cohérente à travers différents domaines d'erreur du module de diagnostic. Des implémentations analogues de ThrowAsException se trouvent notamment dans ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 « ThrowAsException »), ara::diag::DiagOfferErrorDomain ([SWS_DM_00995]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01002]) ainsi que ara::diag::DiagSovdErrorDomain ([SWS_DM_01815]). Interprétation : de par la spécification avec override, la méthode devrait représenter une opération d'interface commune pour le traitement polymorphe des exceptions. Question Q-9c1e35e079af639d (ouverte)