classe ara::exec::ExecErrorDomain

Le constructeur par défaut ExecErrorDomain() initialise une nouvelle instance du domaine d'erreur ara::exec::ExecErrorDomain conformément à [SWS_EM_02286]. L'appel s'effectue de manière synchrone, ne prend aucun paramètre et ne possède pas de valeur de retour. La déclaration est incluse via l'en-tête ara/exec/exec_error_domain.h.

En ce qui concerne la robustesse et la concurrence, le constructeur est déclaré comme noexcept, est considéré comme sûr vis-à-vis des exceptions (exception safe) et est spécifié comme sans restriction thread-safe (thread-safe) [SWS_EM_02286]. Aucun traitement d'erreur n'est nécessaire lors de la création de l'objet, car l'opération s'exécute sans erreur et ne déclenche ni codes d'erreur ni exceptions.

Dans le système global, l'objet créé sert à la représentation et à la description des erreurs spécifiques au module de l'Execution Management. L'instance permet d'interroger le nom du domaine [SWS_EM_02287], de déterminer des messages textuels pour les codes d'erreur [SWS_EM_02288] ou de lever des erreurs sous forme d'exception C++ [SWS_EM_02289]. Une instanciation explicite via ce constructeur ne devrait être que rarement nécessaire dans les modules applicatifs, étant donné qu'une référence globale vers l'instance est déjà mise à disposition via la fonction libre GetExecErrorDomain() [SWS_EM_02290]. Question Q-df8efc87e6547216 (ouverte)

La méthode Message est une fonction membre virtuelle de la classe ara::exec::ExecErrorDomain au sein du cluster de fonctions Execution Management [SWS_EM_02288]. Elle est incluse via le fichier d’en-tête ara/exec/exec_error_domain.h et surcharge l’interface correspondante permettant d’obtenir des messages d’erreur textuels [SWS_EM_02288].

L’utilisation se présente comme suit :

• Appel et sémantique : l’appel s’effectue de manière synchrone et est conçu comme une opération de lecture (const) [SWS_EM_02288].
• Paramètres : errorCode de type CodeType, qui représente l’identifiant numérique de l’erreur, est transmis en paramètre d’entrée [SWS_EM_02288].
• Valeur de retour : la fonction renvoie un pointeur de type const char * vers le message d’erreur associé au code d’erreur [SWS_EM_02288]. Interprétation : il y a lieu de supposer que ce pointeur fait référence à une chaîne de caractères statique, de sorte qu’aucune libération de mémoire n’est requise pour l’appelant. Question Q-3e254e008a07294e (ouverte)

Concernant le traitement des erreurs, la fonction est déclarée comme noexcept et spécifiée comme exception safe [SWS_EM_02288]. La fonction ne déclenche elle-même aucune exception C++. Aucun code d’erreur propre ni canal de retour d’information pour les appels erronés n’est prévu dans la spécification [SWS_EM_02288].

En ce qui concerne la concurrence, la méthode est classée comme thread-safe [SWS_EM_02288]. Comme elle ne modifie pas l’état du domaine d’erreur, elle peut être appelée en toute sécurité en parallèle depuis plusieurs threads sans mécanismes de synchronisation externes [SWS_EM_02288].

Utilisation

La fonction membre Name de la classe ara::exec::ExecErrorDomain fournit de manière synchrone un pointeur vers une constante de caractères (const char *) désignant le domaine d’erreur [SWS_EM_02287]. La valeur de retour est conforme à la définition pour ara::exec::ExecErrorDomain issue de [SWS_CORE_90023]. La méthode est incluse via l’en-tête ara/exec/exec_error_domain.h, n’attend aucun paramètre d’entrée et opère en tant que fonction membre constante sur des instances du domaine d’erreur [SWS_EM_02287].

Gestion des erreurs et concurrence

L’interface est déclarée comme noexcept et par conséquent classée comme totalement sûre vis-à-vis des exceptions (exception safe) [SWS_EM_02287]. Aucun code d’erreur n’est retourné et aucune exception n’est levée. En ce qui concerne l’accès concurrent, la fonction est spécifiée comme thread-safe (thread-safe) [SWS_EM_02287]. Les appels peuvent donc être exécutés en parallèle à partir de différents threads sans mesures de synchronisation supplémentaires.

Interaction

En étant déclarée comme override, la fonction implémente l’interface générale d’interrogation du nom de domaine dans le cadre de [SWS_CORE_90023]. La chaîne de caractères retournée sert vraisemblablement à identifier le domaine d’erreur de manière clairement lisible dans les sorties de journalisation ou de diagnostic [SWS_EM_02287]. Question Q-ae1f9de8510d7ff9 (ouverte)

La méthode ThrowAsException du domaine d’erreur ara::exec::ExecErrorDomain sert à lever de manière synchrone une exception C++ sur la base d’un code d’erreur survenu [SWS_EM_02289]. Elle accepte en paramètre d’entrée une référence vers errorCode (type const ara::core::ErrorCode &), instancie à partir de celle-ci un objet d’exception de type ExecException et le lève immédiatement sous forme d’exception C++ [SWS_EM_02289]. La fonction ne renvoie aucune valeur de retour.

En ce qui concerne le comportement d’erreur et d’exécution, les aspects suivants doivent être pris en compte :

• Sécurité vis-à-vis des exceptions : comme le comportement prévu de la fonction consiste à lever une exception, elle est annotée avec noexcept(false) et formellement classée comme non sûre vis-à-vis des exceptions (not exception safe) [SWS_EM_02289]. Les appelants doivent donc être prêts à intercepter ou à traiter ExecException.
• Concurrence : la spécification indique que la fonction membre est thread-safe (thread-safe) [SWS_EM_02289]. Elle peut donc être appelée en toute sécurité à partir de threads concurrents.
• Restrictions de la chaîne d’outils : conformément à [SWS_CORE_10304], ThrowAsException ne participe pas à la résolution de surcharge si les exceptions C++ sont désactivées dans la chaîne d’outils du compilateur [SWS_EM_02289]. Cet appel n’est donc pas disponible dans les environnements sans prise en charge des exceptions.