classe {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton

La classe sert de classe de base côté serveur pour l'implémentation d'une Service-Interface dans ara::com, dont dérive l'application fournisseuse de services. Lors de la création, le constructeur définit si les appels de méthode entrants sont traités de manière événementielle ou par scrutation (polling) [SWS_CM_00130]. Dans le cas de méthodes déclarées sûres vis-à-vis des exceptions, les exécutions défaillantes sont signalées sous forme de code d'erreur via le ara::core::Future renvoyé [SWS_CM_00191].

plus ›

Contexte

Dans l'Adaptive Platform, au sein du module com, la classe {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton sert de classe de base abstraite générée pour la mise à disposition côté serveur d'une Service-Interface. Un composant fournisseur de services propre à l'application dérive de cette classe Skeleton afin d'implémenter la logique métier fonctionnelle du service. La classe sert d'intermédiaire entre l'application concrète fournisseuse de services et le middleware de communication ou la liaison de protocole sous-jacente telle que SOME/IP (SWS CommunicationManagement §8.1 « Method invocation »). Parmi les partenaires d'interaction figurent l'application fournisseuse de services qui crée et possède l'instance, la classe Skeleton elle-même ainsi que l'infrastructure de communication qui reçoit, désérialise et transmet les requêtes de service entrantes au Skeleton ([SWS_CM_10306], [SWS_CM_10307]).

Diagramme de contexte : interaction entre l'application fournisseuse de services, le ServiceSkeleton et le middleware de communication. Sources : [SWS_CM_10306], [SWS_CM_10307], SWS CommunicationManagement §8.1 « Method invocation ».

Cycle de vie

La création de l'instance du Skeleton s'effectue via le constructeur auquel le mode de traitement souhaité ara::com::MethodCallProcessingMode est transmis [SWS_CM_00130]. Ce mode définit la stratégie de concurrence pour les appels de méthode entrants : si kEvent ou kEventSingleThread est configuré, les appels de méthode arrivants sont directement appelés de façon événementielle par le middleware de communication [SWS_CM_10306]. Si kPoll est transmis à la place, le traitement s'effectue par scrutation (polling) par l'application [SWS_CM_10307]. Interprétation : l'instance du Skeleton demeure probablement la propriété de l'application fournisseuse de services pendant toute la mise à disposition active du service et n'est détruite que lors de l'arrêt du service. Question Q-ce25321f79393024 (ouverte)

Parcours d'utilisation

Le déroulement typique comprend l'implémentation des méthodes virtuelles pures par la classe fournisseuse dérivée et l'exécution ultérieure lors de requêtes entrantes. Pour les appels de méthode standard (Request-Response), le Skeleton définit une interface qui renvoie un ara::core::Future avec l'objet de sortie correspondant [SWS_CM_00191], [SWS_CM_99556]. Pour les méthodes Fire-and-Forget sans réponse en retour, le Skeleton met à disposition des opérations virtuelles pures avec le type de retour void [SWS_CM_90434]. Lors de requêtes entrantes, le middleware de communication désérialise les données utiles et transmet l'appel à l'implémentation concrète de la classe Skeleton selon le mode de traitement configuré ([SWS_CM_10306], [SWS_CM_00191]).

Diagramme de séquence : déroulement d'un appel de méthode via le Skeleton. Sources : [SWS_CM_00191], [SWS_CM_10306], SWS CommunicationManagement §8.1 « Method invocation ».

Scénarios d'erreur

Aussi bien les méthodes Request-Response que les méthodes Fire-and-Forget sont annotées au niveau de l'interface avec noexcept et déclarées comme sûres vis-à-vis des exceptions ([SWS_CM_00191], [SWS_CM_90434]). Les erreurs lors du traitement d'appels de méthode standard ne sont pas transmises via des exceptions C++ ; à la place, le ara::core::Future renvoyé transporte en cas d'erreur un code d'erreur correspondant de type ara::com::ComErrc ou un ApApplicationError [SWS_CM_00191]. Pour les méthodes Fire-and-Forget, conformément aux spécifications, ni valeurs de retour ni codes d'erreur standardisés ne sont prévus [SWS_CM_90434].