classe ara::diag::DiagUdsNrcErrorDomain

Le constructeur par défaut sans paramètre initialise de manière synchrone et sans paramètre de transmission une instance du domaine d'erreurs ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00532]. Grâce à la qualification en tant que constexpr, l'instanciation peut déjà avoir lieu au moment de la compilation AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.1.1 « Default Constructor ». En pratique, une instanciation manuelle directe de la classe de domaine [SWS_DM_00529] par le code d'application devrait toutefois être rarement nécessaire, car la référence globale est obtenue par défaut via la fonction GetDiagUdsNrcDomain() [SWS_DM_00536]. Question Q-22c33afd620b536e (ouverte)

Concernant la concurrence et la sûreté face aux exceptions, le constructeur est spécifié comme thread-safe et exception safe [SWS_DM_00532]. Il est déclaré comme noexcept et ne lève lui-même aucune exception. Le domaine gère des codes d'erreur du type énumération DiagUdsNrcErrc via l'alias Errc [SWS_DM_00530], qui sont générés au moyen de MakeErrorCode() [SWS_DM_00537]. De plus, la classe met à disposition des méthodes telles que Name() [SWS_DM_00533], Message() [SWS_DM_00534] ainsi que ThrowAsException() [SWS_DM_00535] dans le cadre de DiagUdsNrcException [SWS_DM_00531].

En interaction avec le Diagnostic Management, les erreurs de ce domaine contrôlent le traitement des réponses négatives. Si une interface ara::diag renvoie une erreur de DiagUdsNrcErrorDomain, le serveur de diagnostic en déduit une réponse négative UDS (NRC) avec la valeur du code d'erreur dans la plage valide de 0x01 à 0xFE [SWS_DM_02059], [SWS_DM_02060]. Si une telle erreur survient lors de la récupération d'un élément d'environnement, le serveur considère la condition concernée comme non remplie et émet un message de journalisation et de traçage (Log-and-Trace) [SWS_DM_00970].

Utilisation

La fonction membre synchrone Message de la classe ara::diag::DiagUdsNrcErrorDomain convertit un code d'erreur numérique en une chaîne de caractères lisible [SWS_DM_00534]. La valeur d'erreur errorCode de type ara::core::ErrorDomain::CodeType est transmise comme paramètre. L'appel renvoie un pointeur constant (const char *) vers le message correspondant, étant garanti que la valeur de retour n'est jamais nullptr [SWS_DM_00534].

Gestion des erreurs et concurrence

La méthode est déclarée comme noexcept et garantit une sécurité totale vis-à-vis des exceptions (exception safe) [SWS_DM_00534]. Aucune exception n'est déclenchée. Même en cas de valeurs inconnues ou non valides pour errorCode, l'implémentation devrait probablement fournir un message de repli statique, car un pointeur nul est explicitement exclu [SWS_DM_00534]. De plus, la fonction est spécifiée comme thread-safe (thread-safe) et peut être appelée en parallèle depuis plusieurs threads sans synchronisation externe [SWS_DM_00534]. Question Q-e9724baf4aedc3ff (ouverte)

Interaction dans le Diagnostic Management

Au sein du Diagnostic Management, Message implémente la surcharge standardisée de la résolution de messages d'erreur spécifiquement pour les Negative Response Codes (NRC) UDS [SWS_DM_00534]. Elle correspond à des fonctions similaires d'autres domaines d'erreur de diagnostic comme DiagErrorDomain [SWS_DM_00522], DiagOfferErrorDomain [SWS_DM_00994], DiagReportingErrorDomain [SWS_DM_01001] et DiagSovdErrorDomain [SWS_DM_01814].

Utilisation

La fonction membre Name de la classe ara::diag::DiagUdsNrcErrorDomain renvoie le nom court (ApApplicationErrorDomain.SN) de ce domaine d'erreur de diagnostic spécifique [SWS_DM_00533]. L'appel s'effectue de manière synchrone et est déclaré via l'en-tête ara/diag/diag_uds_nrc_error_domain.h. La méthode ne prend aucun paramètre d'entrée et renvoie un pointeur de type const char * vers une chaîne de caractères terminée par zéro [SWS_DM_00533].

Gestion des erreurs

La fonction est déclarée comme noexcept et possède la propriété exception safe [SWS_DM_00533]. Elle ne lève aucune exception et ne renvoie aucun code d'erreur. Un échec de l'interrogation n'est pas prévu dans la conception de l'interface, raison pour laquelle il n'existe aucun message d'erreur distinct.

Concurrence et restrictions

Conformément à la spécification, Name est classée comme thread-safe [SWS_DM_00533]. Elle peut être appelée de manière réentrante et sans mécanismes de synchronisation externes en parallèle par plusieurs threads. La chaîne de caractères référencée devrait représenter des données allouées statiquement, de sorte que le pointeur devrait rester valide sans modification pendant toute la durée de vie de l'application. Question Q-d4a4d28af7a9c2df (ouverte) Il n'existe pas de conditions d'ordonnancement particulières pour l'appel.

Interaction

L'opération implémente l'interrogation standardisée de noms pour les domaines d'erreur AUTOSAR Adaptive dans le contexte de diagnostic. Elle correspond structurellement aux interfaces de même nom de domaines d'erreur associés tels que ara::diag::DiagErrorDomain::Name [SWS_DM_00521], ara::diag::DiagOfferErrorDomain::Name [SWS_DM_00993], ara::diag::DiagReportingErrorDomain::Name [SWS_DM_01000] ainsi que ara::diag::DiagSovdErrorDomain::Name [SWS_DM_01813]. Elle sert avant tout à identifier de manière lisible les erreurs issues de l'environnement UDS-NRC pour les clients de diagnostic ou les composants de journalisation.

La fonction membre ara::diag::DiagUdsNrcErrorDomain::ThrowAsException sert à convertir de manière synchrone une erreur issue du domaine d'erreur UDS-NRC en une exception C++ [SWS_DM_00535]. L'instance errorCode de type const ara::core::ErrorCode& est transmise en tant que paramètre. La fonction ne possède pas de valeur de retour, mais lève directement le type d'exception associé au code d'erreur AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 « ThrowAsException ».

Concernant le comportement d'erreur et à l'exécution, la méthode est déclarée avec noexcept(false) et classée comme non sûre vis-à-vis des exceptions (not exception safe), car le déclenchement de l'exception constitue sa sémantique principale [SWS_DM_00535]. Pour le contexte d'appel concurrent, la fonction est spécifiée comme thread-safe (thread-safe) [SWS_DM_00535].

Les conditions et références de conception suivantes s'appliquent lors de l'intégration et de la configuration du système :

• Restriction du compilateur : si les exceptions C++ sont désactivées dans la chaîne d'outils du compilateur, cette fonction ne participe pas à la résolution de surcharge (overload resolution) conformément à [SWS_CORE_10304] [SWS_DM_00535].
• Interaction avec les domaines d'erreur : le schéma identique pour le déclenchement d'exceptions est mis en œuvre de manière uniforme dans d'autres domaines de diagnostic, tels que DiagErrorDomain [SWS_DM_00523], DiagOfferErrorDomain [SWS_DM_00995], DiagReportingErrorDomain [SWS_DM_01002] et DiagSovdErrorDomain [SWS_DM_01815].