classe ara::diag::DiagOfferErrorDomain

Le constructeur par défaut sans paramètre [SWS_DM_00992] sert à créer une instance de la classe ara::diag::DiagOfferErrorDomain (SWS Diagnostics §8.11.5 « Class: DiagOfferErrorDomain »). Il est déclaré via le fichier d'en-tête ara/diag/diag_error_domain.h et possède la signature constexpr DiagOfferErrorDomain() noexcept; (SWS Diagnostics §8.11.5.2.1.1 « Default Constructor »). L'appel s'effectue de manière synchrone, ne traite aucun paramètre d'entrée et ne fournit aucune valeur de retour, comme c'est le cas pour un constructeur [SWS_DM_00992].

En ce qui concerne la concurrence et la sécurité face aux erreurs, la fonction est spécifiée comme thread-safe ainsi que exception safe [SWS_DM_00992]. La spécification noexcept garantit qu'aucune exception n'est levée pendant l'exécution [SWS_DM_00992]. Des codes d'erreur spécifiques ou des notifications via DET ou DEM ne sont pas prévus pour ce constructeur.

Dans le contexte du module, le domaine représente les états d'erreur liés aux services de diagnostic, dont les codes d'erreur sont définis dans l'énumération DiagOfferErrc [SWS_DM_00559] et peuvent être référencés via l'alias de type Errc [SWS_DM_00990]. La classe fournit des méthodes standard telles que Name() [SWS_DM_00993], Message() [SWS_DM_00994] et ThrowAsException() [SWS_DM_00995]. Dans les cas d'application, un appel direct du constructeur devrait être rarement requis (interprétation), car une référence globale vers l'instance est déjà disponible avec la fonction ara::diag::GetDiagOfferDomain() [SWS_DM_01003], utilisée entre autres par ara::diag::MakeErrorCode() [SWS_DM_01005]. Question Q-a98886da9b649096 (ouverte)

La fonction membre synchrone Message de la classe ara::diag::DiagOfferErrorDomain sert à traduire un code d'erreur numérique en un message textuel descriptif [SWS_DM_00994]. Les développeurs intègrent l'interface via le fichier d'en-tête ara/diag/diag_error_domain.h [SWS_DM_00994].

Pour l'utilisation et le contexte d'appel, les prescriptions suivantes s'appliquent :

• Paramètre et valeur de retour : la valeur d'erreur à interroger est transmise à la fonction en tant que ara::core::ErrorDomain::CodeType errorCode. Elle renvoie un pointeur vers une chaîne de caractères constante (const char*), qui, selon la spécification, n'est jamais nullptr [SWS_DM_00994].
• Sécurité vis-à-vis des erreurs et des exceptions : la fonction est déclarée comme noexcept et spécifiée comme exception safe, de sorte qu'elle ne lève aucune exception C++ [SWS_DM_00994]. Les codes d'erreur inconnus ou invalides sont probablement mis en correspondance avec des messages standard prédéfinis afin de respecter la garantie de pointeur non nul. Question Q-73eb1822df6a995d (ouverte)
• Concurrence : l'opération est déclarée comme méthode const et explicitement classée comme thread-safe, ce qui autorise des appels concurrents depuis plusieurs threads sans synchronisation externe [SWS_DM_00994].

La méthode surcharge une interface de base et suit le patron uniforme de message d'erreur du module de diagnostic, qui est également utilisé de manière analogue dans d'autres domaines d'erreur tels que ara::diag::DiagErrorDomain [SWS_DM_00522], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00534], ara::diag::DiagReportingErrorDomain [SWS_DM_01001] et ara::diag::DiagSovdErrorDomain [SWS_DM_01814].

La méthode Name() de la classe ara::diag::DiagOfferErrorDomain sert à déterminer de manière synchrone le nom court unique du domaine d'erreur ([SWS_DM_00993]). Elle est disponible via le fichier d'en-tête ara/diag/diag_error_domain.h et surcharge la méthode de base servant à l'identification du domaine dans le framework adaptatif ([SWS_DM_00993]).

Utilisation et sémantique :

• Contexte d'appel et paramètres : l'appel s'effectue de manière synchrone, sans paramètre et sans préconditions directement sur l'instance de ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]).
• Valeur de retour : la fonction renvoie un const char*, qui représente l'identifiant ApApplicationErrorDomain.SN du domaine d'erreur ([SWS_DM_00993]). Interprétation : le pointeur renvoyé pointe vraisemblablement vers une chaîne de caractères immuable et statique qui reste valide pendant toute la durée d'exécution du programme. Question Q-86836b3715182080 (ouverte)
• Gestion des erreurs : la méthode est déclarée comme noexcept et spécifiée comme exception safe ([SWS_DM_00993]). Elle ne signale aucun code d'erreur et ne lève aucune exception.
• Concurrence : l'exécution est classée comme thread-safe ([SWS_DM_00993]), de sorte que des appels parallèles depuis plusieurs threads sont autorisés sans synchronisation externe.

Interaction : le comportement correspond au patron architectural général des domaines d'erreur dans Diagnostic Management. Des méthodes Name() spécifiées de manière identique existent pour des domaines apparentés tels que ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) ainsi que ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

La fonction membre ThrowAsException du domaine d'erreur ara::diag::DiagOfferErrorDomain sert, conformément à [SWS_DM_00995], à convertir un code d'erreur transmis du type ara::core::ErrorCode en une exception C++ correspondante et à la déclencher (AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 « ThrowAsException »).

Concernant la sémantique et la conception de l'interface, les propriétés suivantes s'appliquent :

• Appel et paramètres : la méthode accepte une référence constante vers une instance de ara::core::ErrorCode, ne possède pas de valeur de retour (void) et est déclarée avec noexcept(false), puisqu'elle lève une exception par définition [SWS_DM_00995].
• Restriction de compilation : conformément à [SWS_CORE_10304], la fonction ne participe pas à la résolution de surcharge (Overload Resolution) lorsque les exceptions C++ sont désactivées dans la chaîne d'outils du compilateur [SWS_DM_00995].
• Sécurité et concurrence : la fonction est spécifiée comme thread-safe, ce qui autorise des appels parallèles au-delà des frontières des threads ; elle est toutefois explicitement désignée comme not exception safe [SWS_DM_00995].
• Interaction : le concept correspond au modèle d'erreur standardisé pour les domaines d'erreur de diagnostic, tel qu'il est également implémenté de manière analogue dans ara::diag::DiagErrorDomain [SWS_DM_00523], ara::diag::DiagReportingErrorDomain [SWS_DM_01002], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00535] ainsi que ara::diag::DiagSovdErrorDomain [SWS_DM_01815]. La définition est intégrée via le fichier d'en-tête #include "ara/diag/diag_error_domain.h" [SWS_DM_00995].

En raison de la classification comme not exception safe, aucune protection interne supplémentaire contre les erreurs au sein de la méthode ne devrait intervenir lors de l'opération de déclenchement dans le contexte système (interprétation : les développeurs doivent intercepter les exceptions dans le contexte applicatif appelant). Question Q-72152cb488c24026 (ouverte)