classe ara::com::ServiceVersionType

La classe ara::com::ServiceVersionType sert à la représentation et à la gestion standardisées de versions de service dans l'AUTOSAR Adaptive Platform ([SWS_CM_11515]). Les applications utilisent les instances pour vérifier la compatibilité au moyen de comparaisons d'égalité et d'ordre, pour le stockage dans des conteneurs ainsi que pour la journalisation au moyen de ToString() ([SWS_CM_11519]). Le type exact peut être surchargé par le fournisseur de Communication Management, mais doit satisfaire aux exigences élémentaires de comparaison et d'affectation en C++. Lors de l'utilisation, il convient de noter que toutes les fonctions membres de la classe sont spécifiées comme n'étant pas sûres vis-à-vis des exceptions.

plus ›

Contexte

La classe ara::com::ServiceVersionType définit dans l'en-tête ara/com/service/service_version.h (AUTOSAR_AP_SWS_CommunicationManagement §8.11 « Header: ara/com/service/service_version.h ») la version d'un service de communication ([SWS_CM_11515]). Sa responsabilité principale consiste à rendre les versions de service manipulables pour le logiciel d'application, afin que celui-ci puisse stocker, gérer, comparer et journaliser ces indications de version ([SWS_CM_11515]).

Une particularité architecturale réside dans la flexibilité de la plateforme : conformément à [SWS_CM_11515], le type de données concret peut être surchargé ou étendu par le fournisseur de logiciel du Communication Management. Afin de garantir néanmoins une manipulation cohérente dans les applications portables, la spécification exige que le type satisfasse au moins aux concepts standard C++ [equalitycomparable] ([SWS_CM_11516]), [lessthancomparable] ([SWS_CM_11517]) et [copyassignable] ([SWS_CM_11518]) selon l'ISO/IEC 14882:2014.

Parmi les partenaires d'interaction figurent, outre le fournisseur de logiciel du Communication Management, les interfaces de service qui fournissent des versions sous forme de constante statique serviceVersion (AUTOSAR_AP_SWS_CommunicationManagement p. 320), ainsi que le logiciel applicatif qui effectue des vérifications de concordance de versions.

Diagramme de contexte : intégration d'ara::com::ServiceVersionType entre le fournisseur de logiciel, l'interface de service et l'application. Sources : [SWS_CM_11515], AUTOSAR_AP_SWS_CommunicationManagement p. 320, AUTOSAR_AP_SWS_CommunicationManagement §8.11.1 « Class: ServiceVersionType ».

Cycle de vie

Les instances de ara::com::ServiceVersionType sont conçues comme des types valeur réguliers (Value Types). La création et la prise en compte de valeurs s'effectuent par copie et affectation : l'exigence [copyassignable] est satisfaite via l'opérateur d'affectation operator= ([SWS_CM_11518]), permettant ainsi aux instances de prendre de nouvelles valeurs.

En ce qui concerne les relations de propriété, ara::com::ServiceVersionType relève de la portée de l'appelant respectif ou est conservé comme constante d'une définition de service (AUTOSAR_AP_SWS_CommunicationManagement p. 320). Le type ne comporte pas de machine à états interne complexe, mais encapsule une valeur de version discrète. Sa destruction s'effectue automatiquement à la sortie de la portée.

Concernant la concurrence, les opérations de lecture operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) et ToString ([SWS_CM_11519]) sont déclarées comme const. Interprétation : des accès simultanés en lecture à la même instance depuis plusieurs threads devraient être sûrs sans synchronisation, tandis que les opérations parallèles d'écriture et d'affectation doivent être protégées de manière externe. Question Q-9582ce9a82b9b833 (ouverte)

Parcours d'utilisation

Le déroulement typique pour l'utilisation de ara::com::ServiceVersionType dans une application se divise selon les étapes suivantes :

1. Interrogation de version : l'application accède aux informations de version d'un service, par exemple via la constante statique serviceVersion d'une interface (AUTOSAR_AP_SWS_CommunicationManagement p. 320).
2. Vérification de compatibilité : l'application compare la version avec une version attendue via operator== ([SWS_CM_11516]). Pour les vérifications d'ordre ou pour le stockage dans des conteneurs standard triés, operator< est utilisé ([SWS_CM_11517]).
3. Gestion et stockage : pour la transmission ou le stockage local d'états de version, l'application utilise l'opérateur d'affectation operator= ([SWS_CM_11518]).
4. Journalisation : pour les messages de diagnostic ou les sorties de log, l'application génère une représentation textuelle sous forme d'un ara::core::StringView via la méthode ToString() ([SWS_CM_11519], AUTOSAR_AP_SWS_CommunicationManagement §8.11.1.1.2.1 « ToString »).

Scénarios d'erreur

Lors de l'utilisation de l'interface, des conditions aux limites spécifiques doivent être respectées :

• Sécurité vis-à-vis des exceptions : toutes les fonctions spécifiées – operator= ([SWS_CM_11518]), operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) et ToString ([SWS_CM_11519]) – sont explicitement déclarées dans la spécification comme not exception safe. En cas d'erreur (par exemple lors d'allocations de mémoire dans des implémentations spécifiques au fournisseur), les applications ne doivent pas compter sur des garanties de restauration automatique.
• Validité du StringView : la méthode ToString() fournit un ara::core::StringView ([SWS_CM_11519]). Interprétation : un StringView ne gérant pas de mémoire propre, la durée de vie de la chaîne de caractères référencée devrait être liée à l'instance sous-jacente ou à la mémoire statique ; une utilisation au-delà de la validité de la source de données entraîne un comportement indéfini. Question Q-fdb6e821db46af00 (ouverte)