classe apext::tsync::TsyncFvmErrorDomain

La fonction membre [SWS_TS_14210] appartient à la classe apext::tsync::TsyncFvmErrorDomain et est incluse via le fichier d'en-tête apext/tsync/fvm_error_domain.h. Elle sert à la détermination synchrone de la description textuelle d'un code d'erreur survenu. Comme paramètre d'entrée, la fonction reçoit le code d'erreur numérique errorCode de type CodeType et renvoie le message d'erreur qui lui est associé sous la forme d'un pointeur vers une chaîne de caractères constante (const char *).

Concernant la concurrence et la tolérance aux pannes, la spécification garantit des engagements complets : la méthode est classée comme thread-safe et peut ainsi être appelée depuis des threads concurrents sans mesures de synchronisation supplémentaires [SWS_TS_14210]. De plus, la fonction est classée comme exception safe et dotée de l'identifiant noexcept, ce qui exclut le déclenchement d'exceptions pendant l'exécution.

Dans le module ts, il existe une corrélation étroite avec l'élément de spécification [SWS_TS_00907]. Celui-ci définit la fonction analogue Message pour le domaine d'erreur ara::tsync::TsyncErrorDomain dans l'en-tête ara/tsync/tsync_error_domain.h. Les deux interfaces présentent la même signature ainsi que des garanties identiques concernant la sécurité des threads et la sécurité face aux exceptions, et assurent une interrogation uniforme des textes d'erreur à travers différents domaines.

La fonction membre constante Name() de la classe apext::tsync::TsyncFvmErrorDomain fournit un pointeur vers une chaîne de caractères immuable (const char*) représentant le nom du domaine d'erreur pour le Time-Synchronization-FVM [SWS_TS_14209]. La fonction sert à interroger l'identifiant du domaine d'erreur au moment de l'exécution. L'appel s'exécute de manière synchrone et sans paramètre, et requiert l'inclusion du fichier d'en-tête apext/tsync/fvm_error_domain.h [SWS_TS_14209].

Concernant le comportement face aux erreurs, l'interface est déclarée comme noexcept et considérée comme sûre face aux exceptions (exception safe) [SWS_TS_14209]. Comme elle référence uniquement une constante de chaîne de caractères définie de manière fixe, aucun code d'erreur spécifique n'est renvoyé et aucun cas d'erreur ne survient. En ce qui concerne la concurrence, la méthode est expressément classée comme sûre pour les threads (thread-safe) [SWS_TS_14209]. Des appels parallèles depuis plusieurs threads devraient par conséquent être autorisés à tout moment sans synchronisation externe supplémentaire ni mécanismes de protection. Question Q-6664ffba9d211592 (ouverte)

Dans l'interaction architecturale, la fonction surcharge (override) l'interface d'identification du domaine d'erreur et complète la fonction analogue issue de [SWS_TS_00906]. Tandis que [SWS_TS_00906] fournit via ara/tsync/tsync_error_domain.h le nom du domaine d'erreur ara::tsync::TsyncErrorDomain pour la synchronisation temporelle fondamentale, [SWS_TS_14209] sert à caractériser le domaine d'erreur spécialisé apext::tsync::TsyncFvmErrorDomain. Les deux méthodes suivent ainsi le modèle d'erreur uniforme d'AUTOSAR Adaptive.

La fonction membre ThrowAsException du domaine d'erreur apext::tsync::TsyncFvmErrorDomain sert au déclenchement synchrone d'une exception C++ sur la base d'un code d'erreur ([SWS_TS_14211]). La déclaration est disponible via l'en-tête apext/tsync/fvm_error_domain.h. La méthode prend en charge le paramètre d'entrée errorCode (const ara::core::ErrorCode &), instancie à partir de celui-ci une apext::tsync::TsyncFvmException spécifique et la lève directement ([SWS_TS_14211]). En conséquence, la fonction spécifiée avec noexcept(false) ne possède pas de valeur de retour.

Pour le contexte d'appel, la fonction est spécifiée comme sûre pour les threads (thread-safe), mais désignée comme non sûre face aux exceptions (not exception safe) ([SWS_TS_14211]). Interprétation : Cette classification comme non sûre face aux exceptions devrait être due au fait que la levée ciblée d'une exception interrompt le flux de contrôle régulier. Question Q-4d1dbde678635320 (ouverte) [SWS_CORE_10304] définit une restriction centrale du compilateur : si les exceptions C++ sont désactivées dans la chaîne d'outils, la fonction ne participe pas à la résolution de surcharge.

Dans l'ensemble du système, la fonction complète le traitement des erreurs de manière analogue à [SWS_TS_00908] issu de ara::tsync::TsyncErrorDomain. Alors qu'une TsyncException y est levée, ThrowAsException permet, dans le domaine d'erreur du FVM, la transformation uniforme d'un ara::core::ErrorCode en une exception C++ ([SWS_TS_14211]).

Utilisation

Le constructeur par défaut sans paramètre TsyncFvmErrorDomain() crée de manière synchrone une nouvelle instance du domaine d’erreurs apext::tsync::TsyncFvmErrorDomain [SWS_TS_14208]. Il n’attend aucun paramètre d’entrée et est déclaré comme constexpr ainsi que noexcept. Pour l’intégration, le fichier d’en-tête apext/tsync/fvm_error_domain.h doit être inclus [SWS_TS_14208].

Gestion des erreurs et concurrence

Comme le constructeur est spécifié comme noexcept, aucune exception ne survient lors de l’instanciation ; l’exécution est considérée comme sûre pour les threads et sans exception [SWS_TS_14208]. L’objet créé gère et traduit les codes d’erreur de l’énumération TsyncFvmErrc [SWS_TS_14202] (alias de type Errc [SWS_TS_14206]), qui comprend les erreurs spécifiques kFVNotAvailable et kFVInitializeFailed [SWS_TS_14202].

Zusammenspiel et cycle de vie

L’instance de domaine fournit des interfaces pour la résolution de noms et de messages via Name() [SWS_TS_14209] et Message() [SWS_TS_14210] ainsi que pour le déclenchement d’exceptions spécifiques au type via ThrowAsException() [SWS_TS_14211] en utilisant Exception [SWS_TS_14207]. La destruction s’effectue via le destructeur virtuel ~TsyncFvmErrorDomain() [SWS_TS_14201]. Dans le code d’application, une construction manuelle directe devrait être rarement nécessaire ; l’instance singleton globale sera probablement obtenue à la place via GetTsyncFvmErrorDomain() [SWS_TS_14212]. Question Q-411a136f0129313a (ouverte)