Définit le domaine d'erreur pour l'identification, la traduction textuelle et le traitement des exceptions des erreurs issues de SOVD.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : c5b4c66a9279ProvenanceQuestions ouvertes (2)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
Définit le domaine d'erreur pour l'identification, la traduction textuelle et le traitement des exceptions des erreurs issues de SOVD.
La classe ara::diag::DiagSovdErrorDomain encapsule le domaine d'erreur standardisé pour les erreurs de diagnostic spécifiques à SOVD au sein d'AUTOSAR Adaptive Platform ([SWS_DM_01809]). Par le biais de ses fonctions membres sûres pour les threads, elle permet la traduction fiable de codes d'erreur numériques en messages textuels ainsi que le déclenchement contrôlé de types d'exceptions C++ appropriés ([SWS_DM_01814]). Si les exceptions C++ sont désactivées dans la chaîne d'outils du compilateur, la méthode de déclenchement d'exceptions ne participe pas à la résolution de surcharge, conformément aux règles.
Contexte
La classe ara::diag::DiagSovdErrorDomain représente le domaine d'erreur spécifique pour les états d'erreur résultant du sous-système SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_01809], AUTOSAR_AP_SWS_Diagnostics §8.51.3 « Class: DiagSovdErrorDomain »). En tant que spécialisation finale de la classe d'infrastructure de base ara::core::ErrorDomain, elle intègre de manière transparente les codes d'erreur et les traitements d'exception associés du contexte SOVD dans le modèle d'erreur unifié d'AUTOSAR Adaptive Platform ([SWS_DM_01809]).
L'instanciation de ara::diag::DiagSovdErrorDomain s'effectue via le constructeur par défaut sans paramètre constexpr DiagSovdErrorDomain() noexcept ([SWS_DM_01812], AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.1.1 « Default Constructor »). Grâce à sa spécification en tant que constexpr et noexcept, la création est garantie sûre face aux exceptions et peut s'effectuer dès la compilation ou pendant l'initialisation statique. Interprétation : la mise à disposition du constructeur constexpr devrait permettre à la plateforme de maintenir une instance singleton de longue durée référencée via GetDiagSovdErrorDomain ([SWS_DM_01816]). Question Q-777076a993f1202d (ouverte)
Concernant la concurrence, l'ensemble des fonctions membres de la classe sont explicitement déclarées comme sûres pour les threads (« thread-safe »). Cela s'applique au constructeur ([SWS_DM_01812]) tout comme aux opérations de lecture Name() ([SWS_DM_01813]) et Message() ([SWS_DM_01814]) ainsi qu'au déclenchement d'exceptions via ThrowAsException() ([SWS_DM_01815]). Plusieurs threads peuvent ainsi opérer en parallèle et sans mécanismes de synchronisation externes sur la même instance de domaine.
Parcours d'utilisation
Le déroulement normal pour l'utilisation de ara::diag::DiagSovdErrorDomain se divise selon les étapes suivantes :
Consultation du message d'erreur : pour traduire un code d'erreur numérique de type ara::core::ErrorDomain::CodeType (correspondant à Errc selon [SWS_DM_01810]) en texte lisible, Message(errorCode) est appelée ([SWS_DM_01814], AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.1 « Message »). La fonction renvoie un pointeur constant vers une chaîne de caractères (const char*) qui est garanti de ne jamais être nullptr ([SWS_DM_01814]). Interprétation : les chaînes de caractères résultantes devraient être des littéraux statiques, étant donné que la fonction est classifiée comme noexcept. Question Q-9af1f4094bda4bde (ouverte)
Traitement des exceptions : si un état d'erreur doit alternativement être propagé via des exceptions C++, l'application transmet l'instance de ara::core::ErrorCode à ThrowAsException(errorCode) ([SWS_DM_01815]), ce qui déclenche une exception de type correspondant du type Exception (DiagSovdException) ([SWS_DM_01811]).
Diagramme de séquence : séquence d'interaction typique pour la résolution de descriptions d'erreur et le déclenchement optionnel d'exceptions via le domaine d'erreur. Sources : [SWS_DM_01814], [SWS_DM_01815], [SWS_DM_01816].
Scénarios d'erreur
Dans le cadre du traitement des erreurs, l'interface de ara::diag::DiagSovdErrorDomain présente des caractéristiques de comportement spécifiques :
Retour textuel garanti : la méthode Message est déclarée comme noexcept et totalement sûre face aux exceptions (« exception safe ») ([SWS_DM_01814]). Elle n'échoue jamais et renvoie toujours une chaîne de caractères valide et non vide ([SWS_DM_01814]).
Déclenchement ciblé d'exceptions : la méthode ThrowAsException est destinée à lever des exceptions et porte donc noexcept(false) ainsi que la classification « not exception safe » ([SWS_DM_01815]). En fonction du ara::core::ErrorCode transmis, elle déclenche l'exception correspondante de type Exception (DiagSovdException) ([SWS_DM_01811], [SWS_DM_01815]).
Exceptions C++ désactivées : conformément à [SWS_CORE_10304], ThrowAsException ne participe pas à la résolution de surcharge lorsque les exceptions C++ sont désactivées dans la chaîne d'outils du compilateur ([SWS_DM_01815]). Dans de tels environnements, la fonction n'est pas disponible et les erreurs doivent obligatoirement être évaluées au moyen de codes d'erreur.
Ce guide se base exclusivement sur les prescriptions de spécification du module AUTOSAR diag (version R25-11).
Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
Dans les scénarios d'utilisation typiques, une instanciation manuelle directe via ce constructeur devrait être rarement requise, étant donné que l'interface fonctionnelle ara::diag::GetDiagSovdErrorDomain() fournit déjà une référence vers l'instance globale du domaine d'erreurs [SWS_DM_01816]. Question Q-8c4b22173b01dce7 (ouverte)
La classe DiagSovdErrorDomain définit le domaine d'erreurs pour SOVD et met à disposition des types et des fonctions essentiels :
Création d'instances de codes d'erreur via MakeErrorCode()[SWS_DM_01817].
Interrogation de nom via Name()[SWS_DM_01813] et traduction de texte via Message()[SWS_DM_01814] ainsi que déclenchement d'exceptions via ThrowAsException()[SWS_DM_01815].
Gestion des erreurs et concurrence
En tant que fonction noexcept sans paramètre, le constructeur ne lève aucune exception. Selon la spécification, l'appel est sûr vis-à-vis des exceptions (« exception safe ») et thread-safe en accès concurrent (« thread-safe ») [SWS_DM_01812]. Aucune précondition ni aucun code d'erreur spécifique n'est défini pour le constructeur.
Ce texte a été généré par une IA et sert de complément documentaire.
Translate an error code value into a text message.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 83c49eafd3e0ProvenanceQuestions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
La fonction membre Message de la classe ara::diag::DiagSovdErrorDomain sert à la traduction synchrone d'un code d'erreur numérique en un message textuel lisible [SWS_DM_01814] (attesté dans AUTOSAR_AP_SWS_Diagnostics p. 69). Elle est mise à disposition via le fichier d'en-tête ara/diag/diag_sovd_error_domain.h dans l'espace de noms ara::diag.
Les caractéristiques de spécification suivantes s'appliquent à l'appel et au comportement à l'exécution :
Utilisation et sémantique :errorCode de type ara::core::ErrorDomain::CodeType est transmis comme paramètre d'entrée. La fonction renvoie de manière synchrone un pointeur vers une chaîne de caractères constante (const char *) contenant la description textuelle de l'erreur. La spécification garantit de façon ferme que cette valeur de retour n'est jamais nullptr[SWS_DM_01814].
Gestion des erreurs et robustesse : l'interface est qualifiée avec noexcept et définie comme sans danger au niveau des exceptions (exception safe) [SWS_DM_01814]. Aucune exception C++ n'est déclenchée. Interprétation : lors de la transmission d'un code d'erreur non défini ou inconnu, l'implémentation devrait renvoyer un texte informatif standardisé afin de respecter la garantie contre les pointeurs nuls. Question Q-c115f3da24bde8bd (ouverte)
Concurrence : la méthode est déclarée comme opération const et explicitement spécifiée comme sûre pour les threads (thread-safe) [SWS_DM_01814]. Elle ne modifie aucun état interne, n'est soumise à aucune condition d'ordonnancement et peut être appelée en parallèle depuis plusieurs threads sans verrous externes ni mécanismes de synchronisation.
Interaction au sein de Diagnostic Management : la méthode fournit la traduction textuelle standardisée pour le domaine d'erreurs SOVD. Elle suit le patron d'architecture uniforme de l'Adaptive Platform et correspond, en matière de signature et de comportement, aux implémentations Message de domaines d'erreurs de diagnostic apparentés tels que DiagErrorDomain[SWS_DM_00522], DiagUdsNrcErrorDomain[SWS_DM_00534], DiagOfferErrorDomain[SWS_DM_00994] et DiagReportingErrorDomain[SWS_DM_01001].
Cette note d'utilisation a été générée automatiquement sur la base de la spécification.
Return the "shortname" ApApplicationErrorDomain.SN of this error domain.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : f69f6a515368ProvenanceQuestions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
Utilisation
La méthode Name de la classe ara::diag::DiagSovdErrorDomain renvoie le nom court (ApApplicationErrorDomain.SN) du domaine d'erreurs SOVD de manière synchrone sous la forme d'une chaîne C (const char*) ([SWS_DM_01813] ; AUTOSAR_AP_SWS_Diagnostics §7 « Diagnostics »). La fonction n'attend aucun paramètre d'entrée et est fournie via l'en-tête ara/diag/diag_sovd_error_domain.h ([SWS_DM_01813]). Interprétation : le pointeur retourné devrait pointer vers une chaîne de caractères immuable, conservée de manière statique, qui reste valide pendant toute la durée d'exécution. Question Q-b7b74a09ea645e46 (ouverte)
Gestion des erreurs et concurrence
La fonction est déclarée comme noexcept et est considérée comme sans danger au niveau des exceptions (exception safe) ([SWS_DM_01813]). Elle ne signale aucun code d'erreur et ne génère d'entrées ni DET, ni DEM. Pour la concurrence, la méthode est spécifiée comme sûre pour les threads (thread-safe) ([SWS_DM_01813]). Elle possède ainsi des propriétés réentrantes et peut être appelée depuis n'importe quel thread sans mécanismes de synchronisation externes.
Interaction
L'interface suit le modèle d'interrogation de noms unifié pour les domaines d'erreurs dans le diagnostic adaptatif. Des implémentations correspondantes se trouvent dans ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]) ainsi que ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]). Elle sert typiquement à la journalisation ainsi qu'à l'identification des domaines d'erreurs dans le contexte SOVD.
Cette note d'utilisation a été générée automatiquement et se base sur la spécification AUTOSAR Adaptive Platform R25-11.
Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : e5c7c7c60bd3ProvenanceQuestions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
Utilisation
La méthode ThrowAsException de la classe ara::diag::DiagSovdErrorDomain ([SWS_DM_01815], déclarée dans l'en-tête ara/diag/diag_sovd_error_domain.h ; voir AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.3 « ThrowAsException ») sert à convertir de manière synchrone un code d'erreur dans le type d'exception C++ assigné. Elle accepte le paramètre d'entrée errorCode de type const ara::core::ErrorCode & et ne possède aucune valeur de retour (void). Lors de l'appel, elle lève l'exception correspondant au code d'erreur selon la signature avec noexcept(false).
Gestion des erreurs et conditions limites
La spécification classe la méthode comme « not exception safe » ([SWS_DM_01815]). Interprétation : cette classification devrait s'expliquer par le fait que la levée intentionnelle d'une exception entraîne la sortie du flux de contrôle régulier. Question Q-23924e13760f4186 (ouverte) Une contrainte centrale concerne la chaîne d'outils du compilateur : selon [SWS_CORE_10304], ThrowAsException ne participe pas à la résolution de surcharge dès lors que les exceptions C++ sont désactivées dans le compilateur.
gemini-3.8-flash-low· 2026-10-13 · Original allemand